출시 노트

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

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

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에 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와 달리 이 리소스에는 고객이 소유한 전략 외에도 고객의 관리자가 소유하고 고객과 공유하는 전략이 포함됩니다. 이 리소스는 측정항목을 제공하지 않으며 입찰 전략 속성의 제한된 하위 집합만 노출합니다.

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

전환

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

쇼핑 실적 보기

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

고객

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

키워드

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

제품 그룹

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

SearchAds360FieldService

SearchAds360Service

  • SearchAds360Service는 단일 쿼리에서 여러 리소스를 검색하기 위한 용도입니다. 쿼리 가능한 리소스는 다음과 같습니다.

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

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

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

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