Package google.shopping.merchant.reports.v1beta

색인

ReportService

Google에서의 제품, 실적, 경쟁 환경에 대한 보고서 및 통계를 가져오는 서비스입니다.

검색

rpc Search(SearchRequest) returns (SearchResponse)

검색어로 정의된 보고서를 검색합니다. 응답에 page_size에서 지정된 것보다 적은 수의 행이 포함될 수 있습니다. next_page_token를 사용하여 요청할 행이 더 있는지 확인합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.

BestSellersBrandView

best_sellers_brand_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

인기 브랜드가 포함된 베스트셀러 보고서

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
report_date

Date

보고 날짜 이 필드의 값은 다음 중 하나여야 합니다.

  • 주별 보고서의 경우 첫 번째 요일 (월요일)
  • 월별 보고서의 경우 매월 1일입니다.

SELECT 절에서 필수입니다. report_date의 WHERE 조건이 쿼리에 지정되지 않은 경우 사용 가능한 최신 주간 또는 월간 보고서가 반환됩니다.
report_granularity

ReportGranularityEnum

보고서의 세부사항입니다. 순위는 일주일 또는 한 달에 걸쳐 이루어질 수 있습니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_granularity의 조건이 필요합니다.
report_country_code

string

순위가 계산되는 국가입니다. ISO 3166 형식으로 표시됩니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_country_code의 조건이 필요합니다.
report_category_id

int64

순위를 계산할 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다.

SELECT 절에서 필수입니다. report_category_id의 WHERE 조건이 쿼리에 지정되지 않은 경우 모든 최상위 카테고리의 순위가 반환됩니다.
brand

string

브랜드 이름입니다.
rank

int64

예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 Google Ads 및 자연 검색 경로에서의 브랜드 인기도입니다.
previous_rank

int64

지난주 또는 지난달의 인기 순위입니다.
relative_demand

RelativeDemandEnum

동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다.
previous_relative_demand

RelativeDemandEnum

지난주 또는 지난달에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다.
relative_demand_change

RelativeDemandChangeTypeEnum

예상 수요의 변동 상승했는지, 침몰했는지, 변하지 않았는지를 나타냅니다.

BestSellersProductClusterView

best_sellers_product_cluster_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

상위 제품 클러스터가 포함된 베스트셀러 보고서 제품 클러스터는 동일한 제품을 나타내는 다양한 제품과 옵션을 그룹화한 것입니다(예: Google Pixel 7).

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
report_date

Date

보고 날짜 이 필드의 값은 다음 중 하나여야 합니다.

  • 주별 보고서의 경우 첫 번째 요일 (월요일)
  • 월별 보고서의 경우 매월 1일입니다.

SELECT 절에서 필수입니다. report_date의 WHERE 조건이 쿼리에 지정되지 않은 경우 사용 가능한 최신 주간 또는 월간 보고서가 반환됩니다.
variant_gtins[]

string

제품 클러스터 옵션 예시의 GTIN입니다.
report_granularity

ReportGranularityEnum

보고서의 세부사항입니다. 순위는 일주일 또는 한 달에 걸쳐 이루어질 수 있습니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_granularity의 조건이 필요합니다.
report_country_code

string

순위가 계산되는 국가입니다. ISO 3166 형식으로 표시됩니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_country_code의 조건이 필요합니다.
report_category_id

int64

순위를 계산할 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다.

SELECT 절에서 필수입니다. report_category_id의 WHERE 조건이 쿼리에 지정되지 않은 경우 모든 최상위 카테고리의 순위가 반환됩니다.
title

string

제품 클러스터의 제목입니다.
brand

string

제품 클러스터의 브랜드입니다.
category_l1

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (첫 번째 수준)입니다.
category_l2

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (두 번째 수준)입니다.
category_l3

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (세 번째 수준)입니다.
category_l4

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (네 번째 수준)입니다.
category_l5

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (다섯 번째 수준)입니다.
inventory_status

InventoryStatus

제품 클러스터가 하나 이상의 국가의 제품 데이터 소스에서 IN_STOCK 상태인지, 모든 국가의 제품 데이터 소스에서 OUT_OF_STOCK 상태인지 또는 전혀 NOT_IN_INVENTORY 상태인지 여부를 나타냅니다.

이 필드는 베스트셀러 보고서 국가 필터를 고려하지 않습니다.
brand_inventory_status

InventoryStatus

현재 한 개 이상의 국가의 제품 데이터 소스에서 IN_STOCK인 브랜드의 제품이 하나 이상 있는지에 관계없이 모든 제품은 모든 국가의 제품 데이터 소스에서 OUT_OF_STOCK, 즉 NOT_IN_INVENTORY입니다.

이 필드는 베스트셀러 보고서 국가 필터를 고려하지 않습니다.
rank

int64

예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 Google Ads 및 자연 표시 경로에서 제품 클러스터의 인기도입니다.
previous_rank

int64

지난주 또는 지난달의 인기 순위입니다.
relative_demand

RelativeDemandEnum

동일한 카테고리 및 국가에서 인기 순위가 가장 높은 제품 클러스터와 비교한 예상 수요입니다.
previous_relative_demand

RelativeDemandEnum

지난주 또는 지난달에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 제품 클러스터와 비교한 예상 수요입니다.
relative_demand_change

RelativeDemandChangeTypeEnum

예상 수요의 변동 상승했는지, 침몰했는지, 변하지 않았는지를 나타냅니다.

InventoryStatus

인벤토리의 제품 클러스터 또는 브랜드 상태입니다.

열거형
INVENTORY_STATUS_UNSPECIFIED 지정되지 않음
IN_STOCK 이 제품 클러스터 또는 브랜드에 대한 제품의 재고가 있습니다.
OUT_OF_STOCK 이 제품 클러스터 또는 브랜드의 제품이 인벤토리에 있지만 현재 재고가 없습니다.
NOT_IN_INVENTORY 인벤토리에 이 제품 클러스터 또는 브랜드의 제품이 없습니다.

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

카테고리 벤치마크를 사용한 노출 경쟁 보고서

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
date

Date

이 행의 날짜입니다.

SELECT 절에서 필수입니다. WHERE 절에는 date의 조건이 필요합니다.
report_country_code

string

노출이 게재된 국가입니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_country_code의 조건이 필요합니다.
report_category_id

int64

보고서를 계산할 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_category_id의 조건이 필요합니다.
traffic_source

TrafficSourceEnum

노출의 트래픽 소스입니다.

SELECT 절에서 필수입니다.
your_domain_visibility_trend

double

선택한 기간의 시작 기간 (또는 노출수가 0이 아닌 첫날)을 기준으로 도메인의 노출수를 기준으로 표시 여부가 변경됩니다.

'WHERE' 절에서 필터링할 수 없습니다.
category_benchmark_visibility_trend

double

선택한 기간의 시작 시간 (또는 노출수가 0이 아닌 첫날)에 대한 노출수를 기준으로 시장에 근접한 노출 가능성을 가장 많이 보이는 판매자 조합의 노출 가능성 변화를 나타냅니다.

'WHERE' 절에서 필터링할 수 없습니다.

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

노출 경쟁 보고서: 노출률이 비슷한 비즈니스가 나와 있습니다.

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
date

Date

이 행의 날짜입니다.

WHERE 절에는 date의 조건이 필요합니다.
domain

string

경쟁업체 또는 광고주 도메인의 도메인('is_your_domain'이 true인 경우)

SELECT 절에서 필수입니다. 'WHERE' 절에서 필터링할 수 없습니다.
is_your_domain

bool

이 행에 도메인 데이터가 포함된 경우 true입니다.

'WHERE' 절에서 필터링할 수 없습니다.
report_country_code

string

노출이 게재된 국가입니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_country_code의 조건이 필요합니다.
report_category_id

int64

보고서를 계산할 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_category_id의 조건이 필요합니다.
traffic_source

TrafficSourceEnum

노출의 트래픽 소스입니다.

SELECT 절에서 필수입니다.
rank

int64

노출수를 기준으로 선택한 키 (date, report_category_id, report_country_code, traffic_source)에 대해 유사한 비즈니스 내 도메인의 위치입니다. 1이 가장 높습니다.

'WHERE' 절에서 필터링할 수 없습니다.
ads_organic_ratio

double

광고 / 자연 비율은 자연 트래픽과 비교하여 도메인이 쇼핑 광고에서 노출된 빈도를 나타냅니다. 숫자는 반올림 및 버케팅됩니다.

'WHERE' 절에서 필터링할 수 없습니다.
page_overlap_rate

double

페이지 중복률은 경쟁 소매업체의 제품이 내 제품과 함께 같은 페이지에 표시되는 빈도를 나타냅니다.

'WHERE' 절에서 필터링할 수 없습니다.
higher_position_rate

double

높은 게재순위 비율은 페이지에서 경쟁업체의 제품이 내 제품보다 더 높은 순위에 게재되는 빈도를 나타냅니다.

'WHERE' 절에서 필터링할 수 없습니다.
relative_visibility

double

상대적 노출률은 내 상품과 비교하여 경쟁업체의 상품이 표시되는 빈도를 나타냅니다. 즉, 선택한 제품 카테고리 및 국가에서 선택한 기간 동안 경쟁 소매업체의 표시된 노출수를 내 비즈니스가 표시된 노출수로 나눈 값입니다.

'WHERE' 절에서 필터링할 수 없습니다.

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

노출 경쟁 보고서: 노출률이 가장 높은 비즈니스가 나와 있습니다.

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
date

Date

이 행의 날짜입니다.

SELECT 절에서 선택할 수 없습니다. WHERE 절에는 date의 조건이 필요합니다.
domain

string

경쟁업체 또는 광고주 도메인의 도메인('is_your_domain'이 true인 경우)

SELECT 절에서 필수입니다. 'WHERE' 절에서 필터링할 수 없습니다.
is_your_domain

bool

이 행에 도메인 데이터가 포함된 경우 true입니다.

'WHERE' 절에서 필터링할 수 없습니다.
report_country_code

string

노출이 게재된 국가입니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_country_code의 조건이 필요합니다.
report_category_id

int64

보고서를 계산할 Google 제품 카테고리 ID로, Google 상품 분류에 표시됩니다.

SELECT 절에서 필수입니다. WHERE 절에는 report_category_id의 조건이 필요합니다.
traffic_source

TrafficSourceEnum

노출의 트래픽 소스입니다.

SELECT 절에서 필수입니다.
rank

int64

노출수를 기준으로 선택한 키 (date, report_category_id, report_country_code, traffic_source)에 대한 상위 판매자 순위의 도메인 위치입니다. 1이 가장 높습니다.

'WHERE' 절에서 필터링할 수 없습니다.
ads_organic_ratio

double

광고 / 자연 비율은 자연 트래픽과 비교하여 도메인이 쇼핑 광고에서 노출된 빈도를 나타냅니다. 숫자는 반올림 및 버케팅됩니다.

'WHERE' 절에서 필터링할 수 없습니다.
page_overlap_rate

double

페이지 중복률은 경쟁 소매업체의 제품이 내 제품과 함께 같은 페이지에 표시되는 빈도를 나타냅니다.

'WHERE' 절에서 필터링할 수 없습니다.
higher_position_rate

double

높은 게재순위 비율은 페이지에서 경쟁업체의 제품이 내 제품보다 더 높은 순위에 게재되는 빈도를 나타냅니다.

'WHERE' 절에서 필터링할 수 없습니다.

MarketingMethod

이 유형에는 필드가 없습니다.

Google에서 제품을 홍보하는 데 사용된 마케팅 방법입니다 (자연 검색 또는 광고).

MarketingMethodEnum

마케팅 방법 값입니다.

열거형
MARKETING_METHOD_ENUM_UNSPECIFIED 지정되지 않음
ORGANIC 자연 검색.
ADS 광고 기반 마케팅

NonProductPerformanceView

non_product_performance_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크에 대한 실적 데이터입니다. 여기에는 실적 측정항목 (예: clicks)과 실적 측정항목이 분류되는 측정기준 (예: date)이 포함됩니다.

측정항목 필드를 1개 이상 선택해야 쿼리에서 세그먼트 필드를 선택할 수 있습니다.

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
date

Date

측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준

WHERE 절에는 date의 조건이 필요합니다.
week

Date

판매자 시간대 기준 측정항목 날짜의 요일 (월요일)입니다. 분류 기준
clicks

int64

제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크의 클릭수입니다. 측정항목.
impressions

int64

제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크가 표시된 횟수입니다. 측정항목.
click_through_rate

double

클릭률 - 클릭수 (clicks)를 제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크의 노출수 (impressions)로 나눈 값입니다. 측정항목.

PriceCompetitivenessProductView

price_competitiveness_product_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

가격 경쟁력 보고서

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
price

Price

제품의 현재 가격입니다.
benchmark_price

Price

벤치마크 국가의 제품 카탈로그에 사용할 수 있는 최신 가격 벤치마크입니다.
report_country_code

string

가격 벤치마크가 적용되는 국가입니다. ISO 3166 형식으로 표시됩니다.

SELECT 절에서 필수입니다.
id

string

제품의 REST ID이며 channel~languageCode~feedLabel~offerId 형식입니다. 데이터를 product_view 테이블과 조인하는 데 사용할 수 있습니다.

SELECT 절에서 필수입니다.
offer_id

string

판매자가 제공한 제품 ID입니다.
title

string

제품의 이름입니다.
brand

string

제품의 브랜드입니다.
category_l1

string

Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다.
category_l2

string

Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
category_l3

string

Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다.
category_l4

string

Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다.
category_l5

string

Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다.
product_type_l1

string

판매자의 자체 제품 분류에 있는 제품 유형 (첫 번째 수준)입니다.
product_type_l2

string

판매자의 자체 제품 분류에 있는 제품 유형 (두 번째 수준)입니다.
product_type_l3

string

판매자의 자체 제품 분류에 있는 제품 유형 (세 번째 수준)입니다.
product_type_l4

string

판매자의 자체 제품 분류에 있는 제품 유형 (네 번째 수준)입니다.
product_type_l5

string

판매자의 자체 제품 분류에 있는 제품 유형 (다섯 번째 수준)입니다.

PriceInsightsProductView

price_insights_product_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

가격 정보 보고서

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
price

Price

제품의 현재 가격입니다.
suggested_price

Price

제품의 최근 추천 가격입니다.
effectiveness

Effectiveness

버케팅된 가격 제안 적용 시 예측된 효과입니다.
id

string

제품의 REST ID이며 channel~languageCode~feedLabel~offerId 형식입니다. 데이터를 product_view 테이블과 조인하는 데 사용할 수 있습니다.

SELECT 절에서 필수입니다.
offer_id

string

판매자가 제공한 제품 ID입니다.
title

string

제품의 이름입니다.
brand

string

제품의 브랜드입니다.
category_l1

string

Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다.
category_l2

string

Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
category_l3

string

Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다.
category_l4

string

Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다.
category_l5

string

Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다.
product_type_l1

string

판매자의 자체 제품 분류에 있는 제품 유형 (첫 번째 수준)입니다.
product_type_l2

string

판매자의 자체 제품 분류에 있는 제품 유형 (두 번째 수준)입니다.
product_type_l3

string

판매자의 자체 제품 분류에 있는 제품 유형 (세 번째 수준)입니다.
product_type_l4

string

판매자의 자체 제품 분류에 있는 제품 유형 (네 번째 수준)입니다.
product_type_l5

string

판매자의 자체 제품 분류에 있는 제품 유형 (다섯 번째 수준)입니다.
predicted_impressions_change_fraction

double

현재 활성 가격과 비교하여 권장 가격을 적용한 후 예상되는 노출수 변동입니다. 예를 들어 0.05는 예상 노출수 5% 증가를 나타냅니다.
predicted_clicks_change_fraction

double

현재 활성 가격과 비교하여 권장 가격을 도입한 후 예상되는 클릭수 변동입니다. 예를 들어 0.05는 예상 클릭수 증가분이 5% 라는 뜻입니다.
predicted_conversions_change_fraction

double

현재 활성 가격과 비교하여 권장 가격을 적용한 후 예상되는 전환수 변동입니다. 예를 들어 0.05는 예상되는 전환수 증가분이 5% 라는 의미입니다.

효과

예측된 효과 버킷입니다.

효과는 어떤 제품이 가격 변경으로 가장 큰 효과를 보는지를 나타냅니다. 이 평가는 할인가, 현재 가격과 추천 가격 간의 차이를 조정하여 예상되는 실적 개선을 고려합니다. 효과가 HIGH인 가격 제안은 실적 향상이 가장 크게 이루어질 것으로 예상됩니다.

열거형
EFFECTIVENESS_UNSPECIFIED 효과는 알 수 없습니다.
LOW 효과는 낮습니다.
MEDIUM 효과가 중간 정도입니다.
HIGH 효과성이 높습니다.

ProductPerformanceView

product_performance_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

실적 측정항목 (예: clicks)과 실적 측정항목이 분류되는 측정기준 (예: offer_id)을 포함한 계정의 제품 실적 데이터입니다. offer_id과 같은 제품 측정기준 값은 노출 시점의 제품 상태를 반영합니다.

측정항목 필드를 1개 이상 선택해야 쿼리에서 세그먼트 필드를 선택할 수 있습니다.

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
date

Date

측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준

WHERE 절에는 date의 조건이 필요합니다.
week

Date

판매자 시간대 기준 측정항목 날짜의 요일 (월요일)입니다. 분류 기준
conversion_value

Price

전환 날짜에 보고된 제품이 기여한 전환 가치입니다. 측정항목.

FREE 트래픽 소스에만 사용할 수 있습니다.
marketing_method

MarketingMethodEnum

측정항목이 적용되는 마케팅 방법입니다. 분류 기준
customer_country_code

string

이벤트 발생 시 고객이 위치한 국가의 코드입니다. ISO 3166 형식으로 표시됩니다. 분류 기준

고객 국가를 확인할 수 없는 경우 특수 'ZZ' 코드가 반환됩니다.
offer_id

string

판매자가 제공한 제품 ID입니다. 분류 기준
title

string

제품의 이름입니다. 분류 기준
brand

string

제품의 브랜드입니다. 분류 기준
category_l1

string

Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다. 분류 기준
category_l2

string

Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다. 분류 기준
category_l3

string

Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다. 분류 기준
category_l4

string

Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다. 분류 기준
category_l5

string

Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다. 분류 기준
product_type_l1

string

판매자의 자체 상품 분류에 있는 제품 유형 (첫 번째 수준)입니다. 분류 기준
product_type_l2

string

판매자의 자체 상품 분류에 있는 제품 유형 (두 번째 수준)입니다. 분류 기준
product_type_l3

string

판매자의 자체 상품 분류에 있는 제품 유형 (세 번째 수준)입니다. 분류 기준
product_type_l4

string

판매자의 자체 상품 분류에 있는 제품 유형 (4번째 수준)입니다. 분류 기준
product_type_l5

string

판매자의 자체 상품 분류에 있는 제품 유형 (다섯 번째 수준)입니다. 분류 기준
custom_label0

string

제품의 커스텀 그룹을 위한 맞춤 라벨 0입니다. 분류 기준
custom_label1

string

제품의 맞춤 그룹을 위한 맞춤 라벨 1입니다. 분류 기준
custom_label2

string

제품의 맞춤 그룹을 위한 맞춤 라벨 2입니다. 분류 기준
custom_label3

string

제품의 커스텀 그룹을 위한 맞춤 라벨 3 분류 기준
custom_label4

string

제품의 맞춤 그룹을 위한 맞춤 라벨 4 분류 기준
clicks

int64

클릭수입니다. 측정항목.
impressions

int64

판매자의 제품이 표시된 횟수입니다. 측정항목.
click_through_rate

double

클릭률 - 판매자의 제품에서 발생한 클릭수 (클릭수)를 제품이 표시된 횟수 (노출수)로 나눈 값입니다. 측정항목.
conversions

double

전환 날짜에 보고된 제품에 기여한 전환수입니다. 기여 분석 모델에 따라 전환은 여러 클릭에 분산될 수 있으며, 각 클릭에 고유한 기여도가 부여됩니다. 이 측정항목은 이러한 모든 크레딧의 합계입니다. 측정항목.

FREE 트래픽 소스에만 사용할 수 있습니다.
conversion_rate

double

전환수를 클릭수로 나눈 값으로, 노출 날짜에 보고됩니다. 측정항목.

FREE 트래픽 소스에만 사용할 수 있습니다.

ProductView

product_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

현재 인벤토리의 제품입니다. 이 표의 제품은 제품 하위 API와 동일하지만 제품 하위 API의 모든 제품 속성을 이 테이블의 쿼리에 사용할 수 있는 것은 아닙니다. 제품 하위 API와 달리 이 표에서는 제품 속성별로 반환된 제품 목록을 필터링할 수 있습니다. id로 단일 제품을 검색하거나 모든 제품을 나열하려면 제품 하위 API를 사용해야 합니다.

요청의 검색어에서 명시적으로 요청된 필드에 대해서만 값이 설정됩니다.

입력란
price

Price

제품 가격 제품 가격에 대한 정보를 사용할 수 없는 경우 없습니다.
gtin[]

string

제품의 GTIN (국제거래단품식별코드) 목록입니다.
creation_time

Timestamp

판매자가 제품을 만든 시간(초 단위 타임스탬프)입니다.
expiration_date

Date

삽입 시 지정된 제품의 만료일입니다.
item_issues[]

ItemIssue

제품의 상품 문제 목록입니다.

이 필드는 결과 정렬에 사용할 수 없습니다.

이 필드에서 선택한 속성 (예: item_issues.severity.aggregated_severity)만 결과 필터링에 사용할 수 있습니다.
click_potential

ClickPotential

판매자의 실적이 가장 우수한 제품과 비교한 예상 잠재 실적입니다.
id

string

제품의 REST ID이며 channel~languageCode~feedLabel~offerId 형식입니다. 제품에서 작동하는 판매자 API 메서드는 이를 name 매개변수로 사용합니다.

SELECT 절에서 필수입니다.
channel

ChannelEnum

제품의 채널입니다. ONLINE 또는 LOCAL일 수 있습니다.
language_code

string

BCP 47 형식의 제품 언어 코드입니다.
feed_label

string

제품의 피드 라벨입니다.
offer_id

string

판매자가 제공한 제품 ID입니다.
title

string

제품의 이름입니다.
brand

string

제품의 브랜드입니다.
category_l1

string

Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다.
category_l2

string

Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다.
category_l3

string

Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다.
category_l4

string

Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다.
category_l5

string

Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다.
product_type_l1

string

판매자의 자체 제품 분류에 있는 제품 유형 (첫 번째 수준)입니다.
product_type_l2

string

판매자의 자체 제품 분류에 있는 제품 유형 (두 번째 수준)입니다.
product_type_l3

string

판매자의 자체 제품 분류에 있는 제품 유형 (세 번째 수준)입니다.
product_type_l4

string

판매자의 자체 제품 분류에 있는 제품 유형 (네 번째 수준)입니다.
product_type_l5

string

판매자의 자체 제품 분류에 있는 제품 유형 (다섯 번째 수준)입니다.
condition

string

제품의 상태입니다.
availability

string

제품의 재고입니다.
shipping_label

string

데이터 소스에 지정된 정규화된 배송물 라벨입니다.
item_group_id

string

옵션을 그룹화하기 위해 판매자가 제공하는 상품 그룹 ID입니다.
aggregated_reporting_context_status

AggregatedReportingContextStatus

집계 상태입니다.
click_potential_rank

int64

클릭 가능성을 기준으로 한 제품의 순위입니다. click_potential_rank이 1인 제품은 검색어 조건을 충족하는 판매자 제품 중 클릭 가능성이 가장 높습니다.

AggregatedReportingContextStatus

모든 보고 컨텍스트에 대해 집계된 제품 상태입니다.

다음은 집계된 상태가 계산되는 방법의 예입니다.

무료 등록정보 쇼핑 광고 상태
승인됨 승인됨 운영 가능
승인됨 대기 중 운영 가능
승인됨 비승인 ELIGIBLE_LIMITED
대기 중 대기 중 대기 중
비승인 비승인 NOT_ELIGIBLE_OR_DISAPPROVED
열거형
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED 지정되지 않음
NOT_ELIGIBLE_OR_DISAPPROVED 제품이 모든 보고 컨텍스트에서 요건을 충족하지 않거나 비승인되었습니다.
PENDING 모든 보고 컨텍스트에서 제품 상태가 대기중입니다.
ELIGIBLE_LIMITED 제품이 일부 (전부는 아님) 보고 컨텍스트에서 사용할 수 있습니다.
ELIGIBLE 제품이 모든 보고 컨텍스트에서 사용할 수 있습니다.

ClickPotential

제품의 클릭 가능성은 판매자의 실적이 가장 우수한 제품과 비교하여 예상 실적을 예측합니다. 제품의 클릭 가능성은 판매자가 수정할 제품의 우선순위를 정하고 제품의 잠재력 대비 실적을 파악하는 데 도움이 됩니다.

열거형
CLICK_POTENTIAL_UNSPECIFIED 알 수 없는 예상 클릭수 영향입니다.
LOW 판매자의 실적이 가장 우수한 제품에 비해 클릭수가 적게 발생할 가능성이 있습니다.
MEDIUM 판매자의 실적이 가장 우수한 제품에 비해 보통 수준의 클릭수가 발생할 가능성이 있습니다.
HIGH 판매자의 실적이 가장 우수한 제품과 유사한 클릭수가 발생할 가능성이 있습니다.

ItemIssue

제품과 관련된 상품 문제입니다.

입력란
type

ItemIssueType

상품 문제 유형입니다.
severity

ItemIssueSeverity

상품 문제의 심각도입니다.
resolution

ItemIssueResolution

항목 문제 해결

ItemIssueResolution

문제 해결 방법

열거형
ITEM_ISSUE_RESOLUTION_UNSPECIFIED 지정되지 않음
MERCHANT_ACTION 판매자가 문제를 해결해야 합니다.
PENDING_PROCESSING 이 문제는 자동으로 해결되거나 (예: 이미지 크롤링) Google 검토를 통해 해결됩니다. 지금은 판매자가 조치를 취하지 않아도 됩니다. 문제를 해결하면 다른 문제가 발생할 수도 있습니다 (예: 크롤링에 실패하는 경우).

ItemIssueSeverity

문제가 제품 게재에 미치는 영향

입력란
severity_per_reporting_context[]

IssueSeverityPerReportingContext

보고 컨텍스트별 문제 심각도입니다.
aggregated_severity

AggregatedIssueSeverity

영향을 받는 모든 보고 컨텍스트에서 집계된 문제 심각도.

이 필드는 결과를 필터링하는 데 사용할 수 있습니다.

AggregatedIssueSeverity

모든 보고 컨텍스트에 대해 집계된 문제 심각도입니다.

열거형
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED 지정되지 않음
DISAPPROVED 문제로 인해 제품이 하나 이상의 신고 컨텍스트에서 비승인됩니다.
DEMOTED 문제가 영향을 받는 모든 보고 컨텍스트에서 제품의 순위를 내립니다.
PENDING 문제 해결은 PENDING_PROCESSING입니다.

IssueSeverityPerReportingContext

보고 컨텍스트별 문제 심각도입니다.

입력란
disapproved_countries[]

string

보고 환경에서 ISO 3166 형식으로 표시되는 비승인 국가 목록입니다.
demoted_countries[]

string

보고 환경에서 순위가 내려가는 국가 목록으로, ISO 3166 형식으로 표시됩니다.
reporting_context

ReportingContextEnum

문제가 적용되는 보고 컨텍스트

ItemIssueType

문제 유형

입력란
code

string

제품 문제의 code에 해당하는 문제의 오류 코드입니다.
canonical_attribute

string

속성별 문제의 표준 속성 이름입니다.

RelativeDemand

이 유형에는 필드가 없습니다.

베스트셀러 보고서의 제품 클러스터 또는 브랜드의 상대적 수요입니다.

RelativeDemandEnum

상대적 수요 가치입니다.

열거형
RELATIVE_DEMAND_ENUM_UNSPECIFIED 지정되지 않음
VERY_LOW 수요는 순위가 가장 높은 제품 클러스터 또는 브랜드에서 수요의 0~5% 를 차지함
LOW 수요는 순위가 가장 높은 제품 클러스터 또는 브랜드에서 수요의 6~10% 를 차지함
MEDIUM 수요는 순위가 가장 높은 제품 클러스터 또는 브랜드에서 수요의 11~20% 를 차지함
HIGH 수요는 순위가 가장 높은 제품 클러스터 또는 브랜드에서 수요의 21~50% 를 차지함
VERY_HIGH 수요가 가장 높은 순위의 제품 클러스터 또는 브랜드에서 수요의 51~100% 를 차지함

RelativeDemandChangeType

이 유형에는 필드가 없습니다.

베스트셀러 보고서의 제품 클러스터 또는 브랜드의 상대적 수요와 이전 기간 대비

RelativeDemandChangeTypeEnum

상대적 수요 변경 유형 값입니다.

열거형
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED 지정되지 않음
SINKER 상대적 수요가 이전 기간보다 낮습니다.
FLAT 상대적 수요는 이전 기간과 동일합니다.
RISER 상대적 수요가 이전 기간보다 높습니다.

ReportGranularity

이 유형에는 필드가 없습니다.

베스트셀러 보고서의 세부사항 베스트셀러 보고서는 일주일 및 한 달 동안 계산됩니다.

ReportGranularityEnum

보고서 세부사항 값

열거형
REPORT_GRANULARITY_ENUM_UNSPECIFIED 지정되지 않음
WEEKLY 보고서는 일주일에 걸쳐 계산됩니다.
MONTHLY 보고서는 한 달 동안 계산됩니다.

ReportRow

검색어에서 반환된 결과 행입니다.

쿼리된 테이블에 해당하는 메시지만 응답에 채워집니다. 채워진 메시지 내에서는 쿼리에서 명시적으로 요청된 필드만 채워집니다.

입력란
product_performance_view

ProductPerformanceView

product_performance_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
non_product_performance_view

NonProductPerformanceView

non_product_performance_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
product_view

ProductView

product_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
price_competitiveness_product_view

PriceCompetitivenessProductView

price_competitiveness_product_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
price_insights_product_view

PriceInsightsProductView

price_insights_product_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
best_sellers_product_cluster_view

BestSellersProductClusterView

best_sellers_product_cluster_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
best_sellers_brand_view

BestSellersBrandView

best_sellers_brand_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

competitive_visibility_competitor_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

competitive_visibility_top_merchant_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

competitive_visibility_benchmark_view 테이블에서 쿼리에 사용할 수 있는 필드입니다.

SearchRequest

ReportService.Search 메서드에 대한 요청 메시지입니다.

입력란
parent

string

필수 항목입니다. 호출을 하는 계정의 ID입니다. 독립형 계정 또는 MCA 하위 계정이어야 합니다. 형식: accounts/{account}
query

string

필수 항목입니다. 가져올 보고서를 정의하는 쿼리입니다.

쿼리를 구성하는 방법에 대한 자세한 내용은 쿼리 언어 가이드를 참조하세요. 사용 가능한 테이블 및 필드의 전체 목록은 사용 가능한 필드를 참조하세요.
page_size

int32

선택사항입니다. 단일 페이지에서 검색할 ReportRows 수입니다. 기본값은 1000입니다. 5,000 이상의 값은 5,000으로 강제 변환됩니다.
page_token

string

선택사항입니다. 검색할 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 페이지가 반환됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 next_page_token에서 얻은 값을 사용해야 합니다.

SearchResponse

ReportService.Search 메서드에 대한 응답 메시지입니다.

입력란
results[]

ReportRow

검색어와 일치하는 행입니다.
next_page_token

string

다음 페이지를 검색하기 위해 page_token로 전송할 수 있는 토큰입니다. 생략하면 후속 페이지가 표시되지 않습니다.

TrafficSource

이 유형에는 필드가 없습니다.

노출 경쟁 보고서의 노출 트래픽 소스입니다.

TrafficSourceEnum

트래픽 소스 값입니다.

열거형
TRAFFIC_SOURCE_ENUM_UNSPECIFIED 지정되지 않음
ORGANIC 자연 트래픽.
ADS 광고에서 발생한 트래픽입니다.
ALL 자연 및 광고 트래픽.