다른 광고 유형과 마찬가지로 GoogleAdsService.SearchStream를 사용하여 쇼핑 제품의 제품 상태 및 실적 데이터를 가져올 수 있습니다.
Google 판매자 센터 피드의 제품을 지원하는 캠페인에는 다음과 같은 전용 보고서가 있습니다.
- 쇼핑 실적 보기
- 제품 그룹 뷰
- 애셋 그룹 제품 그룹 뷰
- 쇼핑 제품
- 장바구니 데이터 판매 뷰 (v24 이상에서 사용 가능)
- 최종 URL 확장 애셋 뷰 (v26 이상의 쇼핑 캠페인에서 사용 가능)
또한 v26부터 쇼핑 캠페인에서 AI Max (campaign.ai_max_setting.enable_ai_max = true) 및 최종 URL 확장 (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN)이 사용 설정된 경우 final_url_expansion_asset_view는 게재된 텍스트 맞춤설정 확장 소재를 보고합니다.
쿼리 요구사항 및 예시는 최종 URL 확장 애셋 뷰 섹션을 참고하세요.
쇼핑 실적 뷰
쇼핑 실적 뷰는 product_item_id와 같은 속성별로 제품의 집계된 이전 보고 통계를 제공합니다.
쇼핑, 실적 최대화, 디맨드젠 캠페인, 동영상, 앱, 디스플레이 캠페인을 비롯하여 Google 판매자 센터의 제품 피드를 활용하는 모든 캠페인 유형을 지원합니다.
쇼핑 실적 뷰는 관련 측정항목이 기록된 시점의 제품 상태를 캡처합니다. 여기에는 측정항목이 기록된 이후 변경되었을 수 있는 product_title와 같은 세그먼트가 포함됩니다.
shopping_performance_view는 다음 세그먼트와 측정항목도 지원합니다.
segments.ad_sub_network_type(product_group_view및asset_group_product_group_view에서도 지원됨)- 전환 날짜로 분류된 측정항목:
metrics.conversions_by_conversion_date,metrics.all_conversions_by_conversion_date,metrics.conversions_value_by_conversion_date,metrics.all_conversions_value_by_conversion_date,metrics.value_per_conversions_by_conversion_date,metrics.value_per_all_conversions_by_conversion_date - 경쟁 노출 점유율 측정항목:
metrics.search_budget_lost_impression_share,metrics.search_rank_lost_impression_share,metrics.search_budget_lost_absolute_top_impression_share,metrics.search_rank_lost_absolute_top_impression_share - v24 이상에서 사용 가능:
segments.conversion_attribution_event_type세그먼트 및metrics.all_*장바구니 데이터 측정항목 (입찰에 사용되지 않는 전환을 포함한 모든 전환의 장바구니 데이터를 보고함)
다음은 지난 30일 동안 클릭이 발생한 product_item_id별 제품의 노출수, 클릭수, 비용, 전환수, 모든 전환수를 검색하는 쿼리 예입니다 (모든 전환수, 전환수, 클릭수, 비용, 노출수 순으로 내림차순 정렬).
SELECT
segments.product_item_id,
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.clicks > 0
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.cost_micros DESC,
metrics.impressions DESC
제품 보고서의 기여 분석 로직
상품 수준 보고서는 특정 기여 분석 프레임워크를 사용하여 단일 광고에 여러 제품이 표시될 때 개별 제품에 실적 기여도를 부여합니다.
재무 측정항목
metrics.cost_micros 및 metrics.conversions와 같은 재무 측정항목은 모든 제품의 합계가 캠페인 수준 보고서를 초과하지 않도록 계산됩니다.
- 직접 상호작용
- 사용자 의도가 명확하고 단일 제품과 연결된 경우 (예: 제품을 직접 클릭) 관련 비용 및 전환 기여도의 100% 가 해당 특정 제품에 기여한 것으로 간주됩니다.
- 간접 상호작용
- 사용자 의도가 광고 전체를 향하는 경우 (예: 사용자가 광고 제목, 클릭 유도 문구 버튼 또는 동영상을 클릭하는 경우) 관련 비용과 전환 기여도는 해당 광고에 게재된 모든 제품에 균등하게 분배됩니다.
상호작용 측정항목
metrics.impressions 및 metrics.clicks와 같은 상호작용 측정항목은 제품별 참여도를 측정합니다.
노출수의 경우 이벤트가 발생할 때 광고에 포함된 모든 제품에 대해 집계가 증가하며, 이는 제품이 사용자의 표시 영역에 표시되었는지 여부와 관계없습니다. 따라서 보고서의 모든 제품에 대한 노출수 합계가 해당 캠페인 수준 총계보다 훨씬 높을 수 있습니다.
반대로 metrics.clicks는 해당 특정 제품에서 발생한 클릭수만 측정합니다. Google Ads UI에서 metrics.clicks 필드는 명시적으로 제품 클릭수로 라벨이 지정됩니다.
제품 그룹 보기
제품 그룹 뷰는 쇼핑 등록정보 그룹 (UI에서는 제품 그룹이라고 함)에 대한 집계된 보고 통계를 제공합니다. 애셋 그룹 제품 그룹 보기 예시는 실적 최대화 캠페인 보고 가이드를 참고하세요.
다음은 지난 30일 동안 노출이 발생한 캠페인별로 쇼핑 제품 등록정보 그룹의 노출수, 클릭수, 전환수, 모든 전환수를 검색하는 쿼리 예입니다 (모든 전환수, 전환수, 클릭수, 노출수 순으로 내림차순 정렬).
SELECT
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.conversions,
metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.impressions > 0
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
쇼핑 제품 보고서
쇼핑 제품 보고서는 Google Ads 계정에 연결된 Google 판매자 센터 계정에 있는 제품의 속성과 보고 통계를 제공합니다. 이 보고서를 사용하여 고객, 캠페인, 광고 그룹 수준에서 통계를 검사할 수 있습니다. 쇼핑, 실적 최대화, 디맨드젠 캠페인, 동영상, 앱 캠페인 (v24 이상)을 지원합니다. shopping_product.product_image_uri를 쿼리하여 판매자가 제공한 제품 이미지의 URI를 가져올 수도 있습니다.
다음은 연결된 모든 Google 판매자 센터 계정의 모든 쇼핑 제품에 대해 지난 30일 동안의 노출수, 클릭수, 전환수, 모든 전환수를 검색하는 쿼리 예시입니다 (모든 전환수, 전환수, 클릭수, 노출수 순으로 내림차순 정렬).
SELECT
shopping_product.resource_name,
shopping_product.item_id,
shopping_product.feed_label,
shopping_product.merchant_center_id,
metrics.clicks,
metrics.impressions,
metrics.conversions,
metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
metrics.all_conversions DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
쿼리에 대한 자세한 내용은 보고 가이드를 참고하세요.
성능에 대한 고려사항
계정이 많은 제품에 연결된 경우 쇼핑 제품 보고서에서 상당한 양의 데이터를 반환할 수 있습니다. 다음 권장사항은 GAQL 쿼리의 성능을 개선하는 데 도움이 될 수 있습니다.
- 캠페인 및 광고 그룹 수준의 쿼리는 일반적으로 계정 수준의 쿼리보다 빠릅니다. 제품 수가 적고 액세스해야 하는 데이터가 적기 때문입니다.
SELECT절에 필드와 측정항목이 많을수록 응답 시간이 느려집니다. 쿼리에 필요한 필드와 측정항목만 선택합니다.- 문제가 하나 이상 있는 제품은 더 많은 데이터를 반환합니다.
WHERE절에서shopping_product.status로 필터링하여 관련 상태를 유발한 문제를 반환할 가능성이 있는 제품을 파악할 수 있습니다.
쇼핑 제품 보고서의 일반적인 사용 사례
쇼핑 제품 보고서는 제품 피드를 활용하는 캠페인의 제품 정보에 유연하게 액세스할 수 있도록 지원합니다. Google 판매자 센터 계정의 제품 상태에 관한 유용한 정보를 제공할 뿐만 아니라 실적 측정항목, 제품의 광고 게재를 방해하는 문제와 같은 광고 관련 정보도 제공합니다.
이 섹션에서는 Google Ads UI의 제품 뷰에서 가능한 것과 유사한 몇 가지 일반적인 사용 사례를 다룹니다.
shopping_product의 issues 필드는 Merchant API의 ProductStatus와 유사하며 Google Ads와 관련된 문제가 추가되었습니다.
Google 판매자 센터 또는 Google Ads에서 문제를 해결해야 하는지 확인하려면 먼저 응답의 shopping_product.issues.documentation 필드를 확인하세요. 여기에는 도움이 되는 고객센터 도움말이 포함되어 있습니다.
제품 상태 (계정 수준)
캠페인 또는 광고 그룹에 대한 필터 없이 보고서를 지정하면 계정 수준의 모든 제품이 반환됩니다.
다음 유형의 계정에 있는 모든 캠페인의 측정항목, 상태, 문제를 지원합니다.
- 쇼핑
- 실적 최대화 캠페인
이 쿼리를 사용하면 제품 상태(예: NOT_ELIGIBLE)와 해당 상태를 초래한 제품별 문제 목록을 확인할 수 있습니다.
SELECT
shopping_product.resource_name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
제품 상태 (캠페인 수준)
WHERE 절의 일부로 캠페인 리소스를 사용하여 보고서를 지정하면 선택한 캠페인에 포함된 모든 제품이 반환됩니다.
제품 피드를 활용할 수 있는 다음 캠페인 유형에서 지원됩니다.
- 쇼핑
- 실적 최대화 캠페인
- 디맨드젠 캠페인
- 동영상
- 앱 (v24 이상에서 사용 가능)
이 쿼리를 사용하면 특정 캠페인에 포함된 각 제품의 상태를 확인할 수 있습니다. 여기에는 상태를 유발하는 문제도 포함됩니다. 예를 들어 일시중지된 캠페인은 제품 상태에 영향을 미칩니다.
SELECT
shopping_product.resource_name,
shopping_product.campaign,
campaign.name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
WHERE
shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
제품 상태 (광고 그룹 수준)
WHERE 절의 일부로 광고 그룹 리소스와 캠페인 리소스를 모두 사용하여 보고서를 지정하면 선택한 캠페인에 포함된 모든 제품이 반환됩니다. 제품의 측정항목, 상태, 문제는 선택한 광고 그룹에 포함되는지 또는 제외되는지를 반영합니다.
다음 캠페인 유형에서 지원됩니다.
- 쇼핑
- 디맨드젠 캠페인
- 동영상
- 앱 (v24 이상에서 사용 가능,
impressions,clicks,ctr측정항목만 지원,status또는issues는 지원하지 않음)
이 쿼리를 사용하면 해당 광고 그룹과 관련된 제품의 상태를 확인할 수 있습니다. 이를 통해 광고 그룹 수준에서 제품 그룹 필터가 올바르게 적용되고 있는지 확인하고 각 제품의 상태를 확인할 수 있습니다.
SELECT
shopping_product.resource_name,
shopping_product.campaign,
campaign.name,
shopping_product.ad_group,
ad_group.name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
shopping_product.status,
shopping_product.issues
FROM shopping_product
WHERE
shopping_product.campaign = 'customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>'
AND shopping_product.ad_group =
'customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>'
날짜별로 필터링된 제품 측정항목 (계정 수준)
WHERE 절에 날짜 또는 기간을 사용하여 보고서를 지정하면 측정항목이 0이 아닌지 여부에 관계없이 지정된 기간의 계정 수준에서 모든 제품의 측정항목이 반환됩니다.
segments.date를 선택할 수 없습니다. 선택하면 UNSUPPORTED_DATE_SEGMENTATION 오류가 발생합니다.
이 쿼리를 사용하면 특정 날짜 또는 기타 호환되는 기간의 각 제품 실적을 모든 캠페인에서 집계하여 확인할 수 있습니다.
SELECT
shopping_product.resource_name,
shopping_product.merchant_center_id,
shopping_product.channel,
shopping_product.language_code,
shopping_product.feed_label,
shopping_product.item_id,
metrics.clicks,
metrics.impressions,
metrics.cost_micros
FROM shopping_product
WHERE
segments.date DURING LAST_30_DAYS
장바구니 데이터를 사용한 제품 실적
소매업계의 광고주는 수익, 총이익, 총이익률, 판매된 제품 수와 같은 관련 판매 및 수익 측정항목에 액세스할 수 있습니다. 이러한 측정항목은 쇼핑 캠페인 전반에 장바구니 데이터를 사용한 전환 추적을 구현하는 모든 광고주가 사용할 수 있으며 다음 보고서와 호환됩니다.
ad_groupad_group_adcampaigncart_data_sales_view(v24 이상에서 사용 가능)customer(모든 캠페인에 대해 집계됨)product_group_viewshopping_performance_viewshopping_product(v24 이상의metrics.all_*장바구니 데이터 측정항목)
다음 장바구니 데이터 측정항목은 쇼핑 캠페인의 shopping_performance_view와 같은 보고서에서 사용할 수 있습니다.
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
v24 이상에서는 다음 장바구니 데이터 측정항목을 사용하여 입찰에 사용되지 않는 전환을 포함한 모든 전환을 보고할 수도 있습니다.
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_units_sold
다음 예에서는 장바구니 데이터 측정항목을 사용하여 지난 30일 동안의 쇼핑 캠페인에 대한 상품 수준 실적을 분석하는 방법을 보여줍니다.
SELECT
segments.product_item_id,
segments.product_title,
metrics.average_cart_size,
metrics.average_order_value_micros,
metrics.conversions,
metrics.conversions_value,
metrics.gross_profit_micros,
metrics.gross_profit_margin,
metrics.revenue_micros,
metrics.units_sold,
campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS
AND metrics.conversions > 0
ORDER BY
metrics.gross_profit_margin DESC,
metrics.revenue_micros DESC,
metrics.conversions_value DESC
장바구니 데이터를 사용한 캠페인 실적
장바구니 데이터 측정항목은 캠페인 수준에서 사용할 수 있으며 노출수, 클릭수, 비용과 같은 다른 실적 측정항목과 결합할 수 있습니다.
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
metrics.impressions,
metrics.clicks,
metrics.conversions,
metrics.cost_micros,
metrics.average_order_value_micros,
metrics.gross_profit_micros,
metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS
ORDER BY
metrics.gross_profit_margin DESC,
metrics.average_order_value_micros DESC,
metrics.cost_micros DESC,
metrics.conversions DESC,
metrics.clicks DESC,
metrics.impressions DESC
최종 URL 확장 애셋 보기
v26부터는 AI Max(campaign.ai_max_setting.enable_ai_max = true) 및 최종 URL 확장(FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN)이 사용 설정된 경우 쇼핑 캠페인에 게재되는 텍스트 맞춤설정 확장 소재의 확장 소재 수준 실적을 측정하는 데 final_url_expansion_asset_view를 사용할 수 있습니다.
final_url_expansion_asset_view를 쿼리할 때는 다음 필터링 및 필드 선택 규칙을 따르세요.
final_url_expansion_asset_view에 대한 쿼리는campaign.advertising_channel_type,campaign(campaign.id,campaign.resource_name또는final_url_expansion_asset_view.campaign) 또는ad_group(ad_group.id,ad_group.resource_name또는final_url_expansion_asset_view.ad_group) 중 하나 이상을 필터링해야 합니다. 모두 생략하면FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER가 반환됩니다.- 계정 또는 캠페인 수준에서 쇼핑 캠페인의
final_url_expansion_asset_view를 쿼리할 때는campaign.advertising_channel_type = 'SHOPPING'로 필터링하거나=를 사용하여 단일 광고 그룹으로 필터링해야 합니다. 캠페인(campaign.id,campaign.resource_name또는final_url_expansion_asset_view.campaign)으로 필터링하려면campaign.advertising_channel_type = 'SHOPPING'도 필요합니다. 생략하면FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER가 반환되지만 단일ad_group로 필터링하면 필터 요구사항이 자체적으로 충족됩니다. campaign.advertising_channel_type,campaign또는ad_group의 필터는 단일 값에=연산자를 사용해야 합니다. 동일한 리소스 유형에IN또는 여러 조건을 사용하면FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE가 반환됩니다.- 쇼핑 캠페인의 경우
ad_group필드를 선택하고 필터링할 수 있지만asset_group필드는 선택할 수 없습니다. 쇼핑 캠페인에서asset_group필드를 선택하거나ad_group로 필터링하면FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP가 반환됩니다.ad_group필드도 선택된 경우에는CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP가 반환됩니다.ad_group필드를 선택하면서asset_group로 필터링하면CANNOT_SELECT_AD_GROUP가 반환되고ad_group및asset_group로 모두 필터링하면CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP가 반환됩니다.
다음 쿼리는 지난 30일 동안의 쇼핑 캠페인에 대한 애셋 수준 실적 측정항목을 가져옵니다.
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
final_url_expansion_asset_view.asset,
final_url_expansion_asset_view.field_type,
final_url_expansion_asset_view.final_url,
final_url_expansion_asset_view.status,
metrics.impressions,
metrics.clicks,
metrics.conversions
FROM final_url_expansion_asset_view
WHERE
campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS