출시 노트

v0 (2026-11-09)

새 세그먼트

다음 세그먼트가 추가됩니다.

v0 (2026-08-01)

새 필드

ad 및 asset 리소스에 synthetic_content_info를 추가하고 지원하는 SyntheticContentInfo 메시지, SyntheticContentAttestationStatus, SyntheticContentSource enum을 추가합니다.

v0 (2026-03-10)

새 세그먼트

다음 세그먼트가 추가됩니다.

v0 (2025-12-05)

새 측정항목

이제 campaign 리소스를 쿼리할 때 다음 측정항목을 사용할 수 있습니다.

다음과 같은 장바구니 데이터를 사용한 전환 추적(CwCD) 측정항목이 추가됩니다.

새 세그먼트

이제 쿼리에서 우편번호 세분화를 지정할 수 있습니다. 자세한 내용은 segments.geo_target_postal_code를 참고하세요.

v0 (2025-11-10)

새 URL 필드

Google은

UserLocationView의 새로운 측정항목

이제 user_location_view 리소스를 쿼리할 때 다음 측정항목을 사용할 수 있습니다.

리소스 이름 수정

다음 유효 라벨 리소스의 리소스 이름 패턴이 라벨을 소유한 고객 ID를 포함하도록 owner_customer_id를 사용하도록 수정되었습니다.

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel(AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

예시: CampaignEffectiveLabel의 패턴이 customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}에서 customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}로 변경되었습니다.

v0 (2025-06-12)

이 업데이트에는 고객 리소스의 새 필드가 포함되어 있습니다. 이러한 모든 변경사항을 활용하려면 클라이언트 라이브러리를 업데이트해야 합니다.

새 필드

Google은

Search Ads 360 계정 계층 구조를 탐색하는 데 도움이 됩니다.

v0 (2025-01-21)

이 업데이트에는 MCC 확장을 구성하는 새로운 매개변수가 포함되어 있습니다.

MCC 확장

bidding_strategy를 쿼리할 때 이제 PARAMETERS 섹션에서 불리언 값(enable_mcc_expansion)을 설정할 수 있습니다.

이 매개변수를 사용 설정하면 customer_id에 루트가 있는 계정 계층 구조의 모든 계정 데이터가 응답에 반환됩니다.

v0 (2024-11-08)

이 업데이트에는 새 필드와 새 리소스가 포함되어 있습니다. 이러한 모든 변경사항을 활용하려면 클라이언트 라이브러리를 업데이트해야 합니다.

새 필드

ad_group_ad.effective_labels 및 ad_group_criterion.effective_labels를 추가합니다.

유효 라벨은 상속되거나 직접 할당된 라벨입니다.

새로운 리소스

사용자 위치 보기

지역 세그먼트와 함께 사용하면 지역, 대도시, 도시와 관련된 측정항목을 가져올 수 있습니다.

user_location_view 리소스 세부정보를 참고하세요.

새로운 effective_labels 필드와 관련하여 유효 라벨과 ad_group_ad(ad_group_ad_effective_label) 또는 ad_group_criterion(ad_group_criterion_effective_label) 간의 연결 메타데이터를 유지하는 새로운 리소스가 2개 있습니다.

v0 (2024-10-07)

이 업데이트에는 새로운 측정항목, 리소스, 필드, 일부 새로운 매핑 정의가 포함되어 있습니다. 이러한 모든 변경사항을 활용하려면 클라이언트 라이브러리를 업데이트해야 합니다.

측정항목 추가됨

cross_device_conversions_by_conversion_date 및 cross_device_conversions_value_by_conversion_date는 ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view, shopping_performance_view 리소스와 호환됩니다.

필드 매핑 재정의

일부 기존 보고서에서 dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv의 필드 매핑이 변경되었습니다.

필드 살았던 곳: 새 정의
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

필드 매핑이 변경된 기존 보고서 목록

새 필드

campaign.effective_labels 및 ad_group.effective_labels를 추가합니다.

유효 라벨은 상속되거나 직접 할당된 라벨입니다.

새로운 리소스

새로운 effective_labels 필드와 관련하여 새 리소스는 유효 라벨과 캠페인(campaign_effective_label) 또는 ad_group(ad_group_effective_label) 간의 연결 메타데이터를 유지합니다.

v0 (2024-08-23)

이 업데이트에서 맞춤 열 메타데이터는 renderType 필드를 추가합니다.

CustomColumnRenderType 세부정보를 참고하세요.

새로운 owner_customer_id 필드가 campaign_label, ad_group_label, ad_group_ad_label, ad_group_criterion_label 리소스에 추가되었습니다.

이러한 새 필드를 활용하려면 클라이언트 라이브러리를 업데이트해야 합니다.

v0 (2024-08-01)

이번 업데이트에는 시간별 세분화와 몇 가지 새로운 필드가 포함됩니다.

시간별 분류

이제 쿼리에서 시간별 분류를 지정할 수 있습니다. 자세한 내용은 segments.hour를 참고하세요.

자세한 내용은 customer_manager_link.start_time을 참고하세요.

ad_group_ad.ad.type에 MULTIMEDIA_AD가 추가되었습니다.

이제 MULTIMEDIA_AD 유형으로 측정항목 및 세그먼트를 선택할 수 있습니다. 이 버전에서는 멀티미디어 관련 속성 쿼리가 지원되지 않습니다.

campaign.advertising_channel_type에 SOCIAL 캠페인 유형을 추가하고 campaign.advertising_channel_sub_type에 SOCIAL_FACEBOOK_TRACKING_ONLY 하위유형을 추가했습니다.

이제 SOCIAL 캠페인 유형 및 SOCIAL_FACEBOOK_TRACKING_ONLY 하위유형으로 측정항목 및 세그먼트를 선택할 수 있습니다. 이 버전에서는 SOCIAL 또는 SOCIAL_FACEBOOK_TRACKING_ONLY 특정 속성 쿼리가 지원되지 않습니다.

average_quality_score에 대한 지원이 추가되었습니다.

측정항목에서 자세한 내용 보기

v0 (2024-04-18)

이 업데이트에는 액세스 가능한 입찰 전략 리소스가 포함됩니다.

액세스 가능한 입찰 전략

고객이 소유하고 공유하는 BiddingStrategies의 뷰를 나타냅니다. BiddingStrategy와 달리 이 리소스에는 이 고객이 소유한 전략 외에도 고객의 관리자가 소유하고 이 고객과 공유하는 전략이 포함됩니다. 이 리소스는 측정항목을 제공하지 않으며 BiddingStrategy 속성의 제한된 하위 집합만 노출합니다.

accessible_bidding_strategy 리소스 세부정보를 참고하세요.

v0 (2024-02-12)

이 업데이트에는 맞춤 열 및 맞춤 플러드라이트 변수에 대한 액세스 권한이 포함됩니다.

맞춤 열

이제 쿼리에서 맞춤 전환 열과 맞춤 수식 열을 지정할 수 있습니다. 자세한 내용은 맞춤 열 문서를 참고하세요.

맞춤 플러드라이트 변수

이제 2024년 1월 30일 이후의 통계에 대해 쿼리에 맞춤 플러드라이트 변수를 지정할 수 있습니다. 자세한 내용은 맞춤 플러드라이트 변수 문서를 참고하세요.

v0 (2023-11-09)

이 업데이트에는 다음 리소스가 포함됩니다. 링크를 방문하여 이러한 리소스에 대해 쿼리할 수 있는 필드와 함께 사용할 수 있는 측정항목 및 분류 기준을 확인하세요.

애셋 그룹

asset_group 리소스 세부정보를 참고하세요.

애셋 그룹 애셋

asset_group_asset 리소스 세부정보를 참고하세요.

애셋 그룹 등록정보 그룹 필터

asset_group_listing_group_filter 리소스 세부정보를 참고하세요.

애셋 그룹 신호

asset_group_signal 리소스 세부정보를 참고하세요.

애셋 그룹 상위 조합 보기

asset_group_top_combination_view 리소스 세부정보를 참고하세요.

장바구니 데이터 판매 보기

cart_data_sales_view 리소스 세부정보를 참고하세요.

전환

전환 리소스 세부정보를 참고하세요.

쇼핑 실적 뷰

shopping_performance_view 리소스 세부정보를 참고하세요.

방문

방문 리소스 세부정보를 확인합니다.

v0 (2023-08-15)

이 업데이트에는 다음 리소스와 측정항목의 통화 변환을 구성하는 새 매개변수가 포함되어 있습니다.

링크를 방문하여 이러한 리소스에 대해 쿼리할 수 있는 필드와 함께 사용할 수 있는 측정항목 및 분류 기준을 확인하세요.

광고 그룹 확장 소재

ad_group_asset 리소스 세부정보를 참고하세요.

광고 그룹 애셋 모음

ad_group_asset_set 애셋 모음 리소스 세부정보를 참고하세요.

확장 소재

애셋 리소스 세부정보를 확인하세요.

애셋 모음

asset_set 애셋 모음 세부정보를 참고하세요.

애셋 모음 애셋

asset_set_asset 애셋 모음 리소스 세부정보를 참고하세요.

캠페인 확장 소재

campaign_asset 리소스 세부정보를 참고하세요.

캠페인 애셋 모음

campaign_asset_set 애셋 모음 리소스 세부정보를 참고하세요.

고객 애셋

customer_asset 리소스 세부정보를 참고하세요.

고객 애셋 모음

customer_asset_set 애셋 모음 리소스 세부정보를 참고하세요.

통화 변환

매개변수 섹션에서 metrics_currency를 사용하여 측정항목 계산에 사용할 통화를 지정할 수 있습니다.

액세스 가능한 고객 나열

ListAccessibleCustomers 메서드를 사용하여 액세스 가능한 모든 계정을 나열합니다.

v0 (2023-05-15)

이 업데이트에는 다음 리소스가 포함됩니다. 링크를 방문하여 이 리소스에 대해 쿼리할 수 있는 필드와 함께 사용할 수 있는 측정항목 및 분류 기준을 확인하세요.

광고 그룹 광고

ad_group_ad 리소스 세부정보를 참고하세요.

v0 (2023-04-06)

이 업데이트에는 다음 리소스가 포함됩니다. 링크를 방문하여 각 리소스에 대해 쿼리할 수 있는 필드와 해당 리소스에 사용할 수 있는 측정항목 및 분류 기준을 확인하세요.

광고 그룹 잠재고객 뷰

ad_group_audience_view 리소스 세부정보를 참고하세요.

광고 그룹 기준 라벨

ad_group_criterion_label 리소스 세부정보를 참고하세요.

광고 그룹 라벨

ad_group_label 리소스 세부정보를 참고하세요.

연령대 뷰

age_range_view 리소스 세부정보를 참고하세요.

캠페인 기준

campaign_criterion 리소스 세부정보를 참고하세요.

캠페인 라벨

campaign_label 리소스 세부정보 보기

동적 검색 광고 검색어 보기

dynamic_search_ads_search_term_view 리소스 세부정보를 참고하세요.

웹페이지 조회

webpage_view 리소스 세부정보를 참고하세요.

라벨

라벨 리소스 세부정보를 참조하세요.

v0 (2022-12-05)

v0 버전에는 다음 리소스와 서비스가 포함됩니다. 링크를 방문하여 각 리소스에 대해 쿼리할 수 있는 필드와 해당 리소스에 사용할 수 있는 측정항목 및 분류 기준을 확인하세요.

광고그룹

ad_group 리소스 세부정보를 참고하세요.

입찰

bidding_strategy 리소스 세부정보를 참고하세요.

캠페인

캠페인 리소스 세부정보를 참고하세요.

전환 액션

conversion_action 리소스 세부정보를 참고하세요.

고객

고객 리소스 세부정보를 참조하세요.

키워드

keyword_view 리소스 세부정보를 참고하세요.

제품 그룹

product_group_view 리소스 세부정보를 참고하세요.

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service는 단일 쿼리로 여러 리소스를 가져오는 데 사용됩니다. 쿼리 가능한 리소스는 다음과 같습니다.

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • 노출수 및 클릭수와 같은 측정항목도 다음 리소스에 대해 SearchAds360Service를 사용하여 가져올 수 있습니다.

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service를 사용하면 날짜 필드와 같은 필드로 세분화할 수 있습니다. 자세히 알아보기