REST Resource: accounts.reports

리소스: ReportRow

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

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

JSON 표현
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
필드
productPerformanceView

object (ProductPerformanceView)

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

nonProductPerformanceView

object (NonProductPerformanceView)

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

productView

object (ProductView)

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

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

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

priceInsightsProductView

object (PriceInsightsProductView)

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

bestSellersProductClusterView

object (BestSellersProductClusterView)

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

bestSellersBrandView

object (BestSellersBrandView)

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

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

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

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

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

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

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

ProductPerformanceView

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

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

측정항목 필드를 하나 이상 선택하지 않으면 쿼리에서 세그먼트 필드를 선택할 수 없습니다.

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

JSON 표현
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
필드
date

object (Date)

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

WHERE 절에는 date에 관한 조건이 필요합니다.

week

object (Date)

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

conversionValue

object (Price)

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

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

marketingMethod

enum (MarketingMethodEnum)

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

customerCountryCode

string

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

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

offerId

string

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

title

string

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

brand

string

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

categoryL1

string

Google 상품 분류의 제품 카테고리 (1단계)입니다. 분류 기준

categoryL2

string

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

categoryL3

string

Google 상품 분류의 제품 카테고리 (3단계)입니다. 분류 기준

categoryL4

string

Google 상품 분류의 제품 카테고리 (4단계)입니다. 분류 기준

categoryL5

string

Google 상품 분류의 제품 카테고리 (5단계)입니다. 분류 기준

productTypeL1

string

판매자의 자체 제품 분류에서 제품 유형 (1단계)입니다. 분류 기준

productTypeL2

string

판매자의 자체 제품 분류에서 제품 유형 (2단계)입니다. 분류 기준

productTypeL3

string

판매자의 자체 제품 분류에서 제품 유형 (3단계)입니다. 분류 기준

productTypeL4

string

판매자의 자체 제품 분류에서 제품 유형 (4단계)입니다. 분류 기준

productTypeL5

string

판매자의 자체 제품 분류에 따른 제품 유형 (5단계)입니다. 분류 기준

customLabel0

string

제품의 맞춤 그룹화를 위한 맞춤 라벨 0입니다. 분류 기준

customLabel1

string

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

customLabel2

string

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

customLabel3

string

제품의 맞춤 그룹화를 위한 맞춤 라벨 3입니다. 분류 기준

customLabel4

string

제품의 맞춤 그룹화를 위한 맞춤 라벨 4입니다. 분류 기준

clicks

string (int64 format)

클릭수입니다. 측정항목

impressions

string (int64 format)

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

clickThroughRate

number

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

conversions

number

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

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

conversionRate

number

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

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

MarketingMethodEnum

마케팅 방법 값입니다.

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

NonProductPerformanceView

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

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

측정항목 필드를 하나 이상 선택하지 않으면 쿼리에서 세그먼트 필드를 선택할 수 없습니다.

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

JSON 표현
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
필드
date

object (Date)

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

WHERE 절에는 date에 관한 조건이 필요합니다.

week

object (Date)

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

clicks

string (int64 format)

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

impressions

string (int64 format)

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

clickThroughRate

number

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

ProductView

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

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

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

JSON 표현
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
필드
price

object (Price)

제품 가격 제품 가격에 관한 정보를 사용할 수 없는 경우 없음

gtin[]

string

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

creationTime

string (Timestamp format)

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

expirationDate

object (Date)

삽입 시 지정한 제품의 만료일입니다.

itemIssues[]

object (ItemIssue)

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

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

이 필드의 선택된 속성 (예: itemIssues.severity.aggregated_severity)만 결과를 필터링하는 데 사용할 수 있습니다.

clickPotential

enum (ClickPotential)

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

id

string

channel~languageCode~feedLabel~offerId 형식의 제품 REST ID입니다. 제품을 운영하는 Merchant API 메서드는 이를 name 매개변수로 사용합니다.

SELECT 절에서 필요합니다.

channel

enum (ChannelEnum)

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

languageCode

string

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

feedLabel

string

제품의 피드 라벨입니다.

offerId

string

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

title

string

제품 이름입니다.

brand

string

제품의 브랜드입니다.

categoryL1

string

Google 상품 분류의 제품 카테고리 (1단계)입니다.

categoryL2

string

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

categoryL3

string

Google 상품 분류의 제품 카테고리 (3단계)입니다.

categoryL4

string

Google 상품 분류의 제품 카테고리 (4단계)입니다.

categoryL5

string

Google 상품 분류의 제품 카테고리 (5단계)입니다.

productTypeL1

string

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

productTypeL2

string

판매자의 자체 제품 분류에 따른 제품 유형 (2단계)입니다.

productTypeL3

string

판매자의 자체 제품 분류에 있는 제품 유형 (3단계)입니다.

productTypeL4

string

판매자의 자체 제품 분류에 있는 제품 유형 (4단계)입니다.

productTypeL5

string

판매자의 자체 제품 분류에 따른 제품 유형 (5단계)입니다.

condition

string

제품의 상태입니다.

availability

string

제품의 재고입니다.

shippingLabel

string

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

itemGroupId

string

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

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

집계된 상태입니다.

clickPotentialRank

string (int64 format)

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

AggregatedReportingContextStatus

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

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

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

ItemIssue

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

JSON 표현
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
필드
type

object (ItemIssueType)

상품 문제 유형입니다.

severity

object (ItemIssueSeverity)

상품 문제 심각도입니다.

resolution

enum (ItemIssueResolution)

상품 문제 해결

ItemIssueType

문제 유형

JSON 표현
{
  "code": string,
  "canonicalAttribute": string
}
필드
code

string

문제의 오류 코드로, 제품 문제code에 해당합니다.

canonicalAttribute

string

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

ItemIssueSeverity

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

JSON 표현
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
필드
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

보고 컨텍스트별 문제 심각도

aggregatedSeverity

enum (AggregatedIssueSeverity)

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

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

IssueSeverityPerReportingContext

보고 컨텍스트별 문제 심각도

JSON 표현
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
필드
disapprovedCountries[]

string

보고 컨텍스트의 비승인 국가 목록, ISO 3166 형식으로 표시

demotedCountries[]

string

보고 컨텍스트의 강등된 국가 목록, ISO 3166 형식으로 표시

reportingContext

enum (ReportingContextEnum)

문제가 적용되는 보고 컨텍스트입니다.

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": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
필드
price

object (Price)

제품의 현재 가격입니다.

benchmarkPrice

object (Price)

기준 국가의 제품 카탈로그에 대해 사용 가능한 최신 가격 벤치마크입니다.

reportCountryCode

string

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

SELECT 절에서 필요합니다.

id

string

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

SELECT 절에서 필요합니다.

offerId

string

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

title

string

제품 이름입니다.

brand

string

제품의 브랜드입니다.

categoryL1

string

Google 상품 분류의 제품 카테고리 (1단계)입니다.

categoryL2

string

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

categoryL3

string

Google 상품 분류의 제품 카테고리 (3단계)입니다.

categoryL4

string

Google 상품 분류의 제품 카테고리 (4단계)입니다.

categoryL5

string

Google 상품 분류의 제품 카테고리 (5단계)입니다.

productTypeL1

string

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

productTypeL2

string

판매자의 자체 제품 분류에 따른 제품 유형 (2단계)입니다.

productTypeL3

string

판매자의 자체 제품 분류에 있는 제품 유형 (3단계)입니다.

productTypeL4

string

판매자의 자체 제품 분류에 있는 제품 유형 (4단계)입니다.

productTypeL5

string

판매자의 자체 제품 분류에 따른 제품 유형 (5단계)입니다.

PriceInsightsProductView

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

가격 정보 보고서

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

JSON 표현
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
필드
price

object (Price)

제품의 현재 가격입니다.

suggestedPrice

object (Price)

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

effectiveness

enum (Effectiveness)

가격 추천을 적용할 때의 예상 효과입니다(분류됨).

id

string

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

SELECT 절에서 필요합니다.

offerId

string

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

title

string

제품 이름입니다.

brand

string

제품의 브랜드입니다.

categoryL1

string

Google 상품 분류의 제품 카테고리 (1단계)입니다.

categoryL2

string

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

categoryL3

string

Google 상품 분류의 제품 카테고리 (3단계)입니다.

categoryL4

string

Google 상품 분류의 제품 카테고리 (4단계)입니다.

categoryL5

string

Google 상품 분류의 제품 카테고리 (5단계)입니다.

productTypeL1

string

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

productTypeL2

string

판매자의 자체 제품 분류에 따른 제품 유형 (2단계)입니다.

productTypeL3

string

판매자의 자체 제품 분류에 있는 제품 유형 (3단계)입니다.

productTypeL4

string

판매자의 자체 제품 분류에 있는 제품 유형 (4단계)입니다.

productTypeL5

string

판매자의 자체 제품 분류에 따른 제품 유형 (5단계)입니다.

predictedImpressionsChangeFraction

number

추천 가격을 도입한 후 예상되는 노출수 변화를 현재 활성 가격과 비교한 비율입니다. 예를 들어 0.05는 노출수가 5% 증가할 것으로 예측되는 값입니다.

predictedClicksChangeFraction

number

현재 활성 가격과 비교하여 권장 가격을 도입한 후 예상되는 클릭수 변화입니다(비율로 표시). 예를 들어 0.05는 클릭수가 5% 증가할 것으로 예측되는 값입니다.

predictedConversionsChangeFraction

number

현재 활성 가격과 비교하여 권장 가격을 도입한 후 예상되는 전환수 변화입니다(분수로 표시). 예를 들어 0.05는 전환수의 5% 증가가 예상됨을 나타냅니다.

효과

예측된 효과성 버킷

효과는 가격을 변경할 경우 어떤 제품의 실적이 가장 개선될지 알려줍니다. 이 평가에는 할인가, 현재 가격과 추천 가격 간의 차이를 조정하여 예상한 실적 향상이 반영됩니다. 효과가 HIGH인 가격 제안은 실적이 가장 크게 향상될 것으로 예상됩니다.

열거형
EFFECTIVENESS_UNSPECIFIED 효과는 알려지지 않았습니다.
LOW 효과가 낮습니다.
MEDIUM 효과성은 중간입니다.
HIGH 효과성이 높습니다.

BestSellersProductClusterView

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

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

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

JSON 표현
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
필드
reportDate

object (Date)

보고서 날짜 이 필드의 값은 다음 중 하나일 수 있습니다.

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

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

variantGtins[]

string

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

reportGranularity

enum (ReportGranularityEnum)

보고서의 세부사항입니다. 순위는 1주 또는 1개월 동안 집계할 수 있습니다.

SELECT 절에서 필요합니다. WHERE 절에는 reportGranularity에 관한 조건이 필요합니다.

reportCountryCode

string

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

SELECT 절에서 필요합니다. WHERE 절에는 reportCountryCode에 관한 조건이 필요합니다.

reportCategoryId

string (int64 format)

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

SELECT 절에서 필요합니다. 쿼리에 reportCategoryIdWHERE 조건이 지정되지 않으면 모든 최상위 카테고리의 순위가 반환됩니다.

title

string

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

brand

string

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

categoryL1

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (1단계)입니다.

categoryL2

string

Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (2단계)입니다.

categoryL3

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (3단계)입니다.

categoryL4

string

Google 상품 분류에 표시된 제품 클러스터의 제품 카테고리 (4단계)입니다.

categoryL5

string

Google 상품 분류에 표시되는 제품 클러스터의 제품 카테고리 (5단계)입니다.

inventoryStatus

enum (InventoryStatus)

제품 클러스터가 하나 이상의 국가에서 제품 데이터 소스에 IN_STOCK인지, 모든 국가에서 제품 데이터 소스에 OUT_OF_STOCK인지, 아니면 전혀 NOT_IN_INVENTORY인지 여부입니다.

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

brandInventoryStatus

enum (InventoryStatus)

현재 하나 이상의 국가에서 제품 데이터 소스에 IN_STOCK인 브랜드 제품이 하나 이상 있는지, 모든 국가의 제품 데이터 소스에 있는 모든 제품이 OUT_OF_STOCK인지 또는 NOT_IN_INVENTORY인지 여부입니다.

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

rank

string (int64 format)

예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 결과에 표시되는 제품 클러스터의 인기도입니다.

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

예상 수요의 변동입니다. 상승, 하락 또는 보합 상태인지 여부

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 (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
필드
reportDate

object (Date)

보고서 날짜 이 필드의 값은 다음 중 하나일 수 있습니다.

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

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

reportGranularity

enum (ReportGranularityEnum)

보고서의 세부사항입니다. 순위는 1주 또는 1개월 동안 집계할 수 있습니다.

SELECT 절에서 필요합니다. WHERE 절에는 reportGranularity에 관한 조건이 필요합니다.

reportCountryCode

string

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

SELECT 절에서 필요합니다. WHERE 절에는 reportCountryCode에 관한 조건이 필요합니다.

reportCategoryId

string (int64 format)

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

SELECT 절에서 필요합니다. 쿼리에 reportCategoryIdWHERE 조건이 지정되지 않으면 모든 최상위 카테고리의 순위가 반환됩니다.

brand

string

브랜드 이름입니다.

rank

string (int64 format)

예상 판매 제품 수를 기준으로 선택한 카테고리 및 국가에서 광고 및 자연 검색 결과에 표시된 브랜드의 인기도입니다.

previousRank

string (int64 format)

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

relativeDemand

enum (RelativeDemandEnum)

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

previousRelativeDemand

enum (RelativeDemandEnum)

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

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

예상 수요의 변동입니다. 상승, 하락 또는 보합 상태인지 여부

CompetitiveVisibilityCompetitorView

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

노출률이 비슷한 비즈니스가 포함된 노출 경쟁 보고서

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

JSON 표현
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
필드
date

object (Date)

이 행의 날짜입니다.

WHERE 절에는 date에 관한 조건이 필요합니다.

domain

string

경쟁업체의 도메인 또는 'isYourDomain'이 true인 경우 내 도메인

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

isYourDomain

boolean

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

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

reportCountryCode

string

노출이 발생한 국가입니다.

SELECT 절에서 필요합니다. WHERE 절에는 reportCountryCode에 관한 조건이 필요합니다.

reportCategoryId

string (int64 format)

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

SELECT 절에서 필요합니다. WHERE 절에는 reportCategoryId에 관한 조건이 필요합니다.

trafficSource

enum (TrafficSourceEnum)

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

SELECT 절에서 필요합니다.

rank

string (int64 format)

노출수를 기준으로 선택한 키 (date, reportCategoryId, reportCountryCode, trafficSource)의 유사 비즈니스 순위에서 도메인의 순위입니다. 1이 가장 높습니다.

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

adsOrganicRatio

number

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

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

pageOverlapRate

number

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

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

higherPositionRate

number

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

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

relativeVisibility

number

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

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

TrafficSourceEnum

트래픽 소스 값

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

CompetitiveVisibilityTopMerchantView

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

노출도가 가장 높은 비즈니스가 포함된 노출 경쟁 보고서

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

JSON 표현
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
필드
date

object (Date)

이 행의 날짜입니다.

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

domain

string

경쟁업체의 도메인 또는 'isYourDomain'이 true인 경우 내 도메인

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

isYourDomain

boolean

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

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

reportCountryCode

string

노출이 발생한 국가입니다.

SELECT 절에서 필요합니다. WHERE 절에는 reportCountryCode에 관한 조건이 필요합니다.

reportCategoryId

string (int64 format)

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

SELECT 절에서 필요합니다. WHERE 절에는 reportCategoryId에 관한 조건이 필요합니다.

trafficSource

enum (TrafficSourceEnum)

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

SELECT 절에서 필요합니다.

rank

string (int64 format)

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

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

adsOrganicRatio

number

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

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

pageOverlapRate

number

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

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

higherPositionRate

number

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

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

CompetitiveVisibilityBenchmarkView

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

카테고리 벤치마크가 포함된 노출 경쟁 보고서

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

JSON 표현
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
필드
date

object (Date)

이 행의 날짜입니다.

SELECT 절에서 필요합니다. WHERE 절에는 date에 관한 조건이 필요합니다.

reportCountryCode

string

노출이 발생한 국가입니다.

SELECT 절에서 필요합니다. WHERE 절에는 reportCountryCode에 관한 조건이 필요합니다.

reportCategoryId

string (int64 format)

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

SELECT 절에서 필요합니다. WHERE 절에는 reportCategoryId에 관한 조건이 필요합니다.

trafficSource

enum (TrafficSourceEnum)

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

SELECT 절에서 필요합니다.

yourDomainVisibilityTrend

number

선택한 기간의 시작일 (또는 노출수가 0이 아닌 첫 번째 날)을 기준으로 도메인의 노출수를 기준으로 한 노출 가능성의 변화입니다.

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

categoryBenchmarkVisibilityTrend

number

시장에서 가장 높은 노출률을 기록한 판매자 집합을 기준으로 선택한 기간의 시작일 (또는 노출수가 0이 아닌 첫 번째 날)을 기준으로 노출수를 기준으로 한 노출률 변화입니다.

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

메서드

검색어로 정의된 보고서를 가져옵니다.