- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- ReportRow
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ProductPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- MarketingMethodEnum
- NonProductPerformanceView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ProductView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AggregatedReportingContextStatus
- ItemIssue
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ItemIssueType
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ItemIssueSeverity
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- IssueSeverityPerReportingContext
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- PriceInsightsProductView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 효과
- BestSellersProductClusterView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CompetitiveVisibilityCompetitorView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CompetitiveVisibilityBenchmarkView
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
검색어로 정의된 보고서를 검색합니다. 응답에 pageSize
에서 지정된 것보다 적은 수의 행이 포함될 수 있습니다. nextPageToken
를 사용하여 요청할 행이 더 있는지 확인합니다.
HTTP 요청
POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 호출 중인 계정의 ID입니다. 독립형 계정 또는 MCA 하위 계정이어야 합니다. 형식: accounts/{account} |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "query": string, "pageSize": integer, "pageToken": string } |
필드 | |
---|---|
query |
필수 항목입니다. 가져올 보고서를 정의하는 쿼리입니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 쿼리 언어 가이드를 참조하세요. 사용 가능한 테이블 및 필드의 전체 목록은 사용 가능한 필드를 참조하세요. |
pageSize |
선택사항입니다. 한 페이지에서 가져올 |
pageToken |
선택사항입니다. 검색할 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 페이지가 반환됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 |
응답 본문
ReportService.Search
메서드에 대한 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{
"results": [
{
object ( |
필드 | |
---|---|
results[] |
검색어와 일치하는 행입니다. |
nextPageToken |
다음 페이지를 검색하기 위해 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/content
자세한 내용은 OAuth 2.0 개요를 참고하세요.
ReportRow
검색어에서 반환된 결과 행입니다.
쿼리된 테이블에 해당하는 메시지만 응답에 채워집니다. 채워진 메시지 내에는 쿼리에서 명시적으로 요청된 필드만 채워집니다.
JSON 표현 |
---|
{ "productPerformanceView": { object ( |
필드 | |
---|---|
productPerformanceView |
|
nonProductPerformanceView |
|
productView |
|
priceCompetitivenessProductView |
|
priceInsightsProductView |
|
bestSellersProductClusterView |
|
bestSellersBrandView |
|
competitiveVisibilityCompetitorView |
|
competitiveVisibilityTopMerchantView |
|
competitiveVisibilityBenchmarkView |
|
ProductPerformanceView
productPerformanceView
테이블의 쿼리에 사용할 수 있는 필드
실적 측정항목 (예: clicks
) 및 실적 측정항목이 분류되는 측정기준 (예: offerId
)을 포함한 계정의 제품 실적 데이터입니다. 제품 크기 값(예: offerId
)은 노출 시 제품의 상태를 반영합니다.
측정항목 필드를 하나 이상 선택해야 쿼리에서 세그먼트 필드를 선택할 수 있습니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "date": { object ( |
필드 | |
---|---|
date |
측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준
|
week |
판매자 시간대의 측정항목 날짜의 첫 번째 요일 (월요일)입니다. 분류 기준 |
conversionValue |
전환 날짜에 보고된 제품으로 인해 발생한 전환 가치입니다. 측정항목
|
marketingMethod |
측정항목이 적용되는 마케팅 방법입니다. 분류 기준 |
customerCountryCode |
이벤트 발생 시점에 고객이 거주하는 국가의 코드입니다. ISO 3166 형식으로 표현됩니다. 분류 기준 고객 국가를 확인할 수 없는 경우 특수문자 'ZZ'가 표시됩니다. 코드가 반환됩니다. |
offerId |
판매자가 제공한 제품의 ID입니다. 분류 기준 |
title |
제품 이름입니다. 분류 기준 |
brand |
제품의 브랜드입니다. 분류 기준 |
categoryL1 |
Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다. 분류 기준 |
categoryL2 |
Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다. 분류 기준 |
categoryL3 |
Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다. 분류 기준 |
categoryL4 |
Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다. 분류 기준 |
categoryL5 |
Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다. 분류 기준 |
productTypeL1 |
판매자 자체 상품 분류의 제품 유형 (첫 번째 수준)입니다. 분류 기준 |
productTypeL2 |
판매자 자체 상품 분류의 제품 유형 (두 번째 수준)입니다. 분류 기준 |
productTypeL3 |
판매자 자체 상품 분류의 제품 유형 (세 번째 수준)입니다. 분류 기준 |
productTypeL4 |
판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다. 분류 기준 |
productTypeL5 |
판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다. 분류 기준 |
customLabel0 |
제품의 맞춤 그룹화를 위한 맞춤 라벨 0입니다. 분류 기준 |
customLabel1 |
제품의 맞춤 그룹화를 위한 맞춤 라벨 1입니다. 분류 기준 |
customLabel2 |
제품의 맞춤 그룹화를 위한 맞춤 라벨 2입니다. 분류 기준 |
customLabel3 |
제품의 맞춤 그룹화를 위한 맞춤 라벨 3입니다. 분류 기준 |
customLabel4 |
제품의 맞춤 그룹화를 위한 맞춤 라벨 4입니다. 분류 기준 |
clicks |
클릭수입니다. 측정항목 |
impressions |
판매자의 제품이 표시된 횟수입니다. 측정항목 |
clickThroughRate |
클릭률: 판매자의 제품에서 발생한 클릭수 (클릭수)를 제품이 표시된 횟수 (노출수)로 나눈 값입니다. 측정항목 |
conversions |
전환 날짜에 보고된 제품으로 인해 발생한 전환수입니다. 기여 분석 모델에 따라 전환은 여러 클릭에 분산될 수 있으며, 이때 각 클릭에는 자체 크레딧이 할당됩니다. 이 측정항목은 이러한 모든 크레딧의 합계입니다. 측정항목
|
conversionRate |
노출 날짜에 보고된 전환수를 클릭수로 나눈 값입니다. 측정항목
|
MarketingMethodEnum
마케팅 메서드 값입니다.
열거형 | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED |
지정되지 않음 |
ORGANIC |
자연 마케팅 |
ADS |
광고 기반 마케팅. |
NonProductPerformanceView
nonProductPerformanceView
테이블의 쿼리에 사용할 수 있는 필드
제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크에 대한 실적 데이터입니다. 여기에는 실적 측정항목 (예: clicks
) 및 실적 측정항목이 분류되는 측정기준 (예: date
)이 포함됩니다.
측정항목 필드를 하나 이상 선택해야 쿼리에서 세그먼트 필드를 선택할 수 있습니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "date": { object ( |
필드 | |
---|---|
date |
측정항목이 적용되는 판매자 시간대의 날짜입니다. 분류 기준
|
week |
판매자 시간대의 측정항목 날짜의 첫 번째 요일 (월요일)입니다. 분류 기준 |
clicks |
제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크의 클릭수입니다. 측정항목 |
impressions |
제품 외 페이지로 연결되는 이미지 및 온라인 상점 링크가 표시된 횟수입니다. 측정항목 |
clickThroughRate |
클릭률: 클릭수 ( |
ProductView
productView
테이블의 쿼리에 사용할 수 있는 필드
현재 인벤토리의 제품입니다. 이 표의 제품은 제품 하위 API의 제품과 동일하지만 제품 하위 API의 일부 제품 속성을 이 표의 쿼리에 사용할 수 있는 것은 아닙니다. 제품 하위 API와 달리 이 표를 사용하면 반환된 제품 목록을 제품 속성별로 필터링할 수 있습니다. id
로 단일 제품을 검색하거나 모든 제품을 나열하려면 제품 하위 API를 사용해야 합니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "price": { object ( |
필드 | |
---|---|
price |
제품 가격 제품 가격에 대한 정보가 없는 경우 비어 있습니다. |
gtin[] |
제품의 국제거래단품식별코드 (GTIN) 목록입니다. |
creationTime |
판매자가 제품을 만든 시간이며 타임스탬프(초)입니다. |
expirationDate |
삽입 시 지정된 제품의 만료일입니다. |
itemIssues[] |
제품의 상품 문제 목록입니다. 이 필드는 결과를 정렬하는 데 사용할 수 없습니다. 이 필드에서 선택한 속성 (예: |
clickPotential |
판매자의 실적이 가장 우수한 제품과 비교한 예상 실적입니다. |
id |
제품의 REST ID로,
|
channel |
제품의 채널입니다. |
languageCode |
BCP 47 형식의 제품 언어 코드입니다. |
feedLabel |
제품의 피드 라벨입니다. |
offerId |
판매자가 제공한 제품의 ID입니다. |
title |
제품 이름입니다. |
brand |
제품의 브랜드입니다. |
categoryL1 |
Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다. |
categoryL2 |
Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다. |
categoryL3 |
Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다. |
categoryL4 |
Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다. |
categoryL5 |
Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다. |
productTypeL1 |
판매자 자체 상품 분류의 상품 유형 (첫 번째 수준)입니다. |
productTypeL2 |
판매자 자체 상품 분류의 상품 유형 (두 번째 수준)입니다. |
productTypeL3 |
판매자 자체 상품 분류의 상품 유형 (세 번째 수준)입니다. |
productTypeL4 |
판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다. |
productTypeL5 |
판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다. |
condition |
제품의 상태입니다. |
availability |
제품의 재고 |
shippingLabel |
데이터 소스에 지정된 정규화된 배송물 라벨입니다. |
itemGroupId |
옵션을 함께 그룹화하기 위해 판매자가 제공한 상품 그룹 ID입니다. |
thumbnailLink |
Google 인프라에서 호스팅되는 처리된 제품 이미지의 링크입니다. |
aggregatedReportingContextStatus |
집계 상태입니다. |
clickPotentialRank |
클릭 가능성을 기준으로 한 제품의 순위입니다. |
AggregatedReportingContextStatus
모든 보고 컨텍스트에서 집계된 제품의 상태입니다.
다음은 집계된 상태가 계산되는 방법의 예입니다.
무료 등록정보 | 쇼핑 광고 | 상태 |
---|---|---|
승인됨 | 승인됨 | 운영 가능 |
승인됨 | 대기 중 | 운영 가능 |
승인됨 | 비승인 | ELIGIBLE_LIMITED |
대기 중 | 대기 중 | 대기 중 |
비승인 | 비승인 | NOT_ELIGIBLE_OR_DISAPPROVED |
열거형 | |
---|---|
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED |
지정되지 않음 |
NOT_ELIGIBLE_OR_DISAPPROVED |
제품이 모든 보고 컨텍스트에서 적합하지 않거나 비승인되었습니다. |
PENDING |
제품의 상태가 모든 보고 컨텍스트에서 대기 중입니다. |
ELIGIBLE_LIMITED |
제품은 일부 (전부는 아님) 보고 컨텍스트에 사용할 수 있습니다. |
ELIGIBLE |
제품은 모든 보고 컨텍스트에서 사용할 수 있습니다. |
ItemIssue
제품과 관련된 상품 문제입니다.
JSON 표현 |
---|
{ "type": { object ( |
필드 | |
---|---|
type |
항목 문제 유형입니다. |
severity |
상품 문제의 심각도입니다. |
resolution |
상품 문제가 해결되었습니다. |
ItemIssueType
문제 유형.
JSON 표현 |
---|
{ "code": string, "canonicalAttribute": string } |
필드 | |
---|---|
code |
문제의 오류 코드로, 제품 문제의 |
canonicalAttribute |
속성별 문제의 표준 속성 이름입니다. |
ItemIssueSeverity
문제가 제품 제공에 미치는 영향
JSON 표현 |
---|
{ "severityPerReportingContext": [ { object ( |
필드 | |
---|---|
severityPerReportingContext[] |
보고 컨텍스트별 문제 심각도입니다. |
aggregatedSeverity |
영향을 받는 모든 보고 컨텍스트에서 집계된 문제 심각도. 이 필드는 결과를 필터링하는 데 사용할 수 있습니다. |
IssueSeverityPerReportingContext
보고 컨텍스트별 문제 심각도입니다.
JSON 표현 |
---|
{
"disapprovedCountries": [
string
],
"demotedCountries": [
string
],
"reportingContext": enum ( |
필드 | |
---|---|
disapprovedCountries[] |
ISO 3166 형식으로 표현된, 보고 컨텍스트의 비승인 국가 목록입니다. |
demotedCountries[] |
ISO 3166 형식으로 표시된, 보고 컨텍스트에서 순위가 내려진 국가 목록 |
reportingContext |
문제가 적용되는 보고 컨텍스트입니다. |
AggregatedIssueSeverity
모든 보고 컨텍스트에서 집계된 문제 심각도입니다.
열거형 | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED |
지정되지 않음 |
DISAPPROVED |
문제는 하나 이상의 보고 컨텍스트에서 제품을 비승인합니다. |
DEMOTED |
문제가 영향을 받는 모든 보고 컨텍스트에서 제품의 순위를 내립니다. |
PENDING |
문제 해결은 PENDING_PROCESSING 입니다. |
ItemIssueResolution
문제 해결 방법
열거형 | |
---|---|
ITEM_ISSUE_RESOLUTION_UNSPECIFIED |
지정되지 않음 |
MERCHANT_ACTION |
판매자가 문제를 해결해야 합니다. |
PENDING_PROCESSING |
이 문제는 자동으로 (예: 이미지 크롤링) 또는 Google 검토를 통해 해결됩니다. 이제 판매자가 취해야 할 조치는 없습니다. 이 문제를 해결하면 다른 문제가 발생할 수도 있습니다 (예: 크롤링 실패). |
ClickPotential
제품의 클릭 가능성을 통해 예상 실적을 판매자의 최고 실적 제품과 비교하여 예측할 수 있습니다. 제품의 클릭 가능성은 판매자가 수정할 제품의 우선순위를 정하고 제품의 잠재력 대비 실적을 파악하는 데 도움이 됩니다.
열거형 | |
---|---|
CLICK_POTENTIAL_UNSPECIFIED |
알 수 없는 예상 클릭수 영향입니다. |
LOW |
판매자의 실적이 가장 우수한 제품에 비해 클릭수가 적게 발생할 가능성이 있습니다. |
MEDIUM |
판매자의 실적이 가장 우수한 제품에 비해 보통 수준의 클릭수가 발생할 가능성이 있습니다. |
HIGH |
실적이 가장 우수한 판매자 제품과 유사한 클릭수가 발생할 가능성이 있습니다. |
PriceCompetitivenessProductView
priceCompetitivenessProductView
테이블의 쿼리에 사용할 수 있는 필드
가격 경쟁력 보고서
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "price": { object ( |
필드 | |
---|---|
price |
제품의 현재 가격입니다. |
benchmarkPrice |
벤치마크 국가의 제품 카탈로그에 제공되는 최신 가격 벤치마크입니다. |
reportCountryCode |
가격 벤치마크의 국가입니다. ISO 3166 형식으로 표현됩니다.
|
id |
제품의 REST ID로,
|
offerId |
판매자가 제공한 제품의 ID입니다. |
title |
제품 이름입니다. |
brand |
제품의 브랜드입니다. |
categoryL1 |
Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다. |
categoryL2 |
Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다. |
categoryL3 |
Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다. |
categoryL4 |
Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다. |
categoryL5 |
Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다. |
productTypeL1 |
판매자 자체 상품 분류의 상품 유형 (첫 번째 수준)입니다. |
productTypeL2 |
판매자 자체 상품 분류의 상품 유형 (두 번째 수준)입니다. |
productTypeL3 |
판매자 자체 상품 분류의 상품 유형 (세 번째 수준)입니다. |
productTypeL4 |
판매자 자체 상품 분류의 제품 유형 (네 번째 수준)입니다. |
productTypeL5 |
판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다. |
PriceInsightsProductView
priceInsightsProductView
테이블의 쿼리에 사용할 수 있는 필드
가격 정보 보고서
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "price": { object ( |
필드 | |
---|---|
price |
제품의 현재 가격입니다. |
suggestedPrice |
제품의 최신 제안 가격입니다. |
effectiveness |
버케팅된 가격 추천 적용 시 예상되는 효과입니다. |
id |
제품의 REST ID로,
|
offerId |
판매자가 제공한 제품의 ID입니다. |
title |
제품 이름입니다. |
brand |
제품의 브랜드입니다. |
categoryL1 |
Google 상품 분류의 제품 카테고리 (첫 번째 수준)입니다. |
categoryL2 |
Google 상품 분류의 제품 카테고리 (두 번째 수준)입니다. |
categoryL3 |
Google 상품 분류의 제품 카테고리 (세 번째 수준)입니다. |
categoryL4 |
Google 상품 분류의 제품 카테고리 (네 번째 수준)입니다. |
categoryL5 |
Google 상품 분류의 제품 카테고리 (다섯 번째 수준)입니다. |
productTypeL1 |
판매자 자체 상품 분류의 상품 유형 (첫 번째 수준)입니다. |
productTypeL2 |
판매자 자체 상품 분류의 상품 유형 (두 번째 수준)입니다. |
productTypeL3 |
판매자 자체 상품 분류의 상품 유형 (세 번째 수준)입니다. |
productTypeL4 |
판매자 자체 상품 분류의 상품 유형 (네 번째 수준)입니다. |
productTypeL5 |
판매자 자체 상품 분류의 제품 유형 (다섯 번째 수준)입니다. |
predictedImpressionsChangeFraction |
권장 가격을 현재 활성 가격과 비교한 후 예상되는 노출수 변화입니다. 예를 들어 0.05는 예상되는 노출수 증가가 5% 임을 나타냅니다. |
predictedClicksChangeFraction |
권장 가격을 현재 활성 가격과 비교한 후 예상되는 클릭수 변동을 분수로 나타낸 것입니다. 예를 들어 0.05는 예상되는 클릭수 증가가 5% 임을 나타냅니다. |
predictedConversionsChangeFraction |
권장 가격을 현재 활성 가격과 비교한 후 예상되는 전환수 변화를 분수로 나타낸 것입니다. 예를 들어 0.05는 예상되는 전환수 증가가 5% 임을 나타냅니다). |
효과
예측 효과 버킷.
효과는 가격을 변경할 경우 어떤 제품이 가장 큰 이점을 얻을 수 있는지를 나타냅니다. 이 평가에는 할인가, 현재 가격과 추천 가격 간의 차이를 조정하여 예측한 실적 향상이 반영됩니다. 효과가 HIGH
인 가격 제안은 실적이 가장 크게 향상될 것으로 예상됩니다.
열거형 | |
---|---|
EFFECTIVENESS_UNSPECIFIED |
효과는 알 수 없습니다. |
LOW |
효율성이 낮습니다. |
MEDIUM |
효율성이 중간입니다. |
HIGH |
효과가 높습니다. |
BestSellersProductClusterView
bestSellersProductClusterView
테이블의 쿼리에 사용할 수 있는 필드
인기 제품 클러스터가 포함된 베스트셀러 보고서입니다. 제품 클러스터는 Google Pixel 7과 같이 동일한 제품을 나타내는 다양한 상품 및 옵션을 그룹화한 것입니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "reportDate": { object ( |
필드 | |
---|---|
reportDate |
보고서 작성일. 이 필드의 값은 다음 중 하나여야 합니다.
|
variantGtins[] |
제품 클러스터 옵션 예시의 GTIN입니다. |
reportGranularity |
보고서의 세부사항입니다. 순위는 일주일 또는 한 달 동안 결정됩니다.
|
reportCountryCode |
순위가 계산되는 국가입니다. ISO 3166 형식으로 표현됩니다.
|
reportCategoryId |
순위를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다.
|
title |
제품 클러스터의 제목입니다. |
brand |
제품 클러스터의 브랜드입니다. |
categoryL1 |
Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (첫 번째 수준)입니다. |
categoryL2 |
Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (두 번째 수준)입니다. |
categoryL3 |
Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (세 번째 수준)입니다. |
categoryL4 |
Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (네 번째 수준)입니다. |
categoryL5 |
Google의 상품 분류로 표시되는 제품 클러스터의 제품 카테고리 (다섯 번째 수준)입니다. |
inventoryStatus |
제품 클러스터가 하나 이상의 국가 제품 데이터 소스에서 이 필드는 베스트셀러 보고서 국가 필터를 고려하지 않습니다. |
brandInventoryStatus |
현재 1개 이상의 국가에서 제품 데이터 소스에 이 필드는 베스트셀러 보고서 국가 필터를 고려하지 않습니다. |
rank |
예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 위치에 표시된 제품 클러스터의 인기도입니다. |
previousRank |
지난주 또는 지난달의 인기도 순위입니다. |
relativeDemand |
동일한 카테고리 및 국가에서 인기 순위가 가장 높은 제품 클러스터와 비교한 예상 수요입니다. |
previousRelativeDemand |
지난주 또는 지난달에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 제품 클러스터와 비교한 예상 수요입니다. |
relativeDemandChange |
예상 수요 변동입니다. 상승, 침몰, 수평 유지 여부 등 |
ReportGranularityEnum
보고서 세부사항 값입니다.
열거형 | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED |
지정되지 않음 |
WEEKLY |
보고서는 1주일에 걸쳐 계산됩니다. |
MONTHLY |
보고서는 한 달 동안 계산됩니다. |
InventoryStatus
인벤토리에 있는 제품 클러스터 또는 브랜드의 상태입니다.
열거형 | |
---|---|
INVENTORY_STATUS_UNSPECIFIED |
지정되지 않음 |
IN_STOCK |
이 제품 클러스터 또는 브랜드의 제품이 있습니다. |
OUT_OF_STOCK |
인벤토리에 이 제품 클러스터 또는 브랜드의 제품이 있지만 현재 재고가 없습니다. |
NOT_IN_INVENTORY |
인벤토리에 이 제품 클러스터 또는 브랜드의 제품이 없습니다. |
RelativeDemandEnum
상대적 수요 가치입니다.
열거형 | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED |
지정되지 않음 |
VERY_LOW |
순위가 가장 높은 제품 클러스터 또는 브랜드에 비해 수요의 0~5% 가 수요입니다. |
LOW |
순위가 가장 높은 제품 클러스터 또는 브랜드 수요의 6~10% 가 수요입니다. |
MEDIUM |
순위가 가장 높은 제품 클러스터 또는 브랜드 수요의 11~20% 가 수요입니다. |
HIGH |
순위가 가장 높은 제품 클러스터 또는 브랜드 수요의 21~50% 가 수요입니다. |
VERY_HIGH |
순위가 가장 높은 제품 클러스터 또는 브랜드 수요의 51~100% 가 수요입니다. |
RelativeDemandChangeTypeEnum
상대적 수요 변경 유형 값입니다.
열거형 | |
---|---|
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED |
지정되지 않음 |
SINKER |
상대적 수요가 이전 기간보다 낮습니다. |
FLAT |
상대적 수요가 이전 기간과 같습니다. |
RISER |
상대적 수요가 이전 기간보다 높습니다. |
BestSellersBrandView
bestSellersBrandView
테이블의 쿼리에 사용할 수 있는 필드
베스트셀러 보고서는 인기 브랜드를 보여줍니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "reportDate": { object ( |
필드 | |
---|---|
reportDate |
보고서 작성일. 이 필드의 값은 다음 중 하나여야 합니다.
|
reportGranularity |
보고서의 세부사항입니다. 순위는 일주일 또는 한 달 동안 결정됩니다.
|
reportCountryCode |
순위가 계산되는 국가입니다. ISO 3166 형식으로 표현됩니다.
|
reportCategoryId |
순위를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다.
|
brand |
브랜드 이름입니다. |
rank |
예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 위치에 표시되는 브랜드의 인기도입니다. |
previousRank |
지난주 또는 지난달의 인기도 순위입니다. |
relativeDemand |
동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다. |
previousRelativeDemand |
지난주 또는 지난달에 동일한 카테고리 및 국가에서 인기 순위가 가장 높은 브랜드와 비교한 예상 수요입니다. |
relativeDemandChange |
예상 수요 변동입니다. 상승, 침몰, 수평 유지 여부 등 |
CompetitiveVisibilityCompetitorView
competitiveVisibilityCompetitorView
테이블의 쿼리에 사용할 수 있는 필드
노출 경쟁 보고서이며 노출이 비슷한 비즈니스와 관련이 있습니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "date": { object ( |
필드 | |
---|---|
date |
이 행의 날짜입니다.
|
domain |
경쟁업체의 도메인 또는 도메인('isYourDomain'인 경우) true입니다.
|
isYourDomain |
이 행에 도메인 데이터가 포함되어 있으면 true입니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
reportCountryCode |
노출이 발생한 국가입니다.
|
reportCategoryId |
보고서를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다.
|
trafficSource |
노출의 트래픽 소스입니다.
|
rank |
노출수를 기준으로 선택된 키 ( 'WHERE'에서 필터링할 수 없습니다. 절. |
adsOrganicRatio |
광고 / 자연 비율은 도메인이 자연 트래픽과 비교하여 쇼핑 광고에서 노출된 빈도를 나타냅니다. 숫자는 반올림되고 버케팅됩니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
pageOverlapRate |
페이지 중복률은 경쟁 소매업체의 상품과 내 상품이 같은 페이지에 함께 표시되는 빈도를 나타냅니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
higherPositionRate |
높은 게재순위 비율은 경쟁업체의 상품이 페이지에서 내 상품보다 더 높은 순위에 게재되는 빈도를 나타냅니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
relativeVisibility |
상대적 노출률은 내 상품과 비교하여 경쟁업체의 상품이 표시되는 빈도를 나타냅니다. 즉, 선택한 제품 카테고리 및 국가에 대해 선택한 기간 동안 경쟁 소매업체가 표시된 노출수를 표시된 노출수로 나눈 값입니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
TrafficSourceEnum
트래픽 소스 값입니다.
열거형 | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED |
지정되지 않음 |
ORGANIC |
자연 트래픽. |
ADS |
광고에서 발생한 트래픽입니다. |
ALL |
자연 및 광고 트래픽 |
CompetitiveVisibilityTopMerchantView
competitiveVisibilityTopMerchantView
테이블의 쿼리에 사용할 수 있는 필드
노출 경쟁 보고서: 노출률이 가장 높은 비즈니스입니다.
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "date": { object ( |
필드 | |
---|---|
date |
이 행의 날짜입니다.
|
domain |
경쟁업체의 도메인 또는 도메인('isYourDomain'인 경우) true입니다.
|
isYourDomain |
이 행에 도메인 데이터가 포함되어 있으면 true입니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
reportCountryCode |
노출이 발생한 국가입니다.
|
reportCategoryId |
보고서를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다.
|
trafficSource |
노출의 트래픽 소스입니다.
|
rank |
노출수를 기준으로 선택한 키 ( 'WHERE'에서 필터링할 수 없습니다. 절. |
adsOrganicRatio |
광고 / 자연 비율은 도메인이 자연 트래픽과 비교하여 쇼핑 광고에서 노출된 빈도를 나타냅니다. 숫자는 반올림되고 버케팅됩니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
pageOverlapRate |
페이지 중복률은 경쟁 소매업체의 상품과 내 상품이 같은 페이지에 함께 표시되는 빈도를 나타냅니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
higherPositionRate |
높은 게재순위 비율은 경쟁업체의 상품이 페이지에서 내 상품보다 더 높은 순위에 게재되는 빈도를 나타냅니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
CompetitiveVisibilityBenchmarkView
competitiveVisibilityBenchmarkView
테이블의 쿼리에 사용할 수 있는 필드
카테고리 벤치마크가 포함된 노출 경쟁 보고서
값은 요청의 검색어에서 명시적으로 요청된 필드에 대해서만 설정됩니다.
JSON 표현 |
---|
{ "date": { object ( |
필드 | |
---|---|
date |
이 행의 날짜입니다.
|
reportCountryCode |
노출이 발생한 국가입니다.
|
reportCategoryId |
보고서를 계산할 Google 제품 카테고리 ID로, Google의 상품 분류에 표시됩니다.
|
trafficSource |
노출의 트래픽 소스입니다.
|
yourDomainVisibilityTrend |
선택한 기간의 시작일 (또는 노출수가 0이 아닌 첫날)을 기준으로 도메인의 노출수를 기준으로 한 노출의 변화입니다. 'WHERE'에서 필터링할 수 없습니다. 절. |
categoryBenchmarkVisibilityTrend |
시장에 근접한 노출률이 가장 높은 통합 판매자 집합에서 선택한 기간의 시작 (또는 노출수가 0이 아닌 첫날)을 기준으로 노출수를 기준으로 한 노출의 변화입니다. 'WHERE'에서 필터링할 수 없습니다. 절. |