출시 노트

v0 (2025년 12월 5일)

새 측정항목

이제 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년 6월 12일)

이번 업데이트에는 customer 리소스의 새 필드가 포함됩니다. 이러한 변경사항을 모두 활용하려면 클라이언트 라이브러리를 업데이트해야 합니다.

새 필드

Google에서는

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

v0 (2025-01-21)

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

MCC 확장

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

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

v0 (2024년 11월 8일)

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

새 필드

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) 간의 연결 메타데이터를 유지하는 두 개의 새 리소스가 있습니다.

v0 (2024년 10월 7일)

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

측정항목 추가됨

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_effective_label) 간의 연결 메타데이터를 유지합니다.

v0 (2024년 8월 23일)

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

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

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

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

v0 (2024년 8월 1일)

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

시간별 분류

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

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

ad_group_ad.ad.type에 MULTIMEDIA_AD가 추가됨

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

campaign.advertising_channel_type에 소셜 캠페인 유형이 추가되고 campaign.advertising_channel_sub_type에 SOCIAL_FACEBOOK_TRACKING_ONLY 하위 유형이 추가됨

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

average_quality_score 지원 추가

자세한 내용은 측정항목을 참고하세요.

v0 (2024년 4월 18일)

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

액세스 가능한 입찰 전략

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

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

v0 (2024년 2월 12일)

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

맞춤 열

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

맞춤 플러드라이트 변수

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

v0 (2023년 11월 9일)

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

애셋 그룹

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 리소스 세부정보를 참고하세요.

방문

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

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 리소스 세부정보를 참고하세요.

통화 변환

PARAMETERS 섹션의 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 리소스 세부정보를 참고하세요.

라벨

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

v0 (2022-12-05)

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

광고그룹

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

입찰

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

캠페인

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

전환 액션

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

고객

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

키워드

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

제품 그룹

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

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service는 단일 쿼리에서 여러 리소스를 가져오기 위한 것입니다. 쿼리 가능한 리소스에는 다음이 포함됩니다.

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

  • 다음 리소스의 경우 SearchAds360Service를 사용하여 노출수, 클릭수와 같은 측정항목을 가져올 수도 있습니다.

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

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