인벤토리 피드에 정의되고 유료 검색 광고의 결과로 판매된 제품의 실적 측정항목, 구성 속성 및 인벤토리 속성입니다.
이 보고서는 비동기식 요청에 의해서만 반환될 수 있습니다 (즉, Reports.request() 메서드를 통해).
이벤트는 특정 날짜에 발생하므로 이 보고서에 대한 요청은 timeRange를 지정해야 합니다. 다음 중 하나를 지정할 수 있습니다.
- startDate 및 endDate
- changedMetricsSinceTimestamp(changedAttributesSinceTimestamp가 이벤트에 유효하지 않음)
발췌 요청
일반 Reports.request() 요청 본문을 보내지만 "reportType": "productLeadAndCrossSell"
를 지정합니다.
{ ... "reportType": "productLeadAndCrossSell", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
보고서에서 반환 또는 필터링하려는 각 열에 대해 아래 표에 나열된 columnName
를 지정합니다.
선택사항으로 headerText, startDate, endDate를 지정할 수도 있습니다.
일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참조하세요.
columnName | 설명 | 동작 | 유형 | 필터링 가능 |
---|---|---|---|---|
agency |
대행사 이름 | 속성 | String |
예 |
agencyId |
DS 대행사 ID | 속성 | ID |
예 |
advertiser |
광고주 이름입니다. | 속성 | String |
예 |
advertiserId |
DS 광고주 ID | 속성 | ID |
예 |
productId |
제품의 상품 ID입니다. | 속성 | String |
예 |
productCountry |
제품 인벤토리 피드에 등록된 국가입니다. | 속성 | String |
예 |
productLanguage |
제품의 인벤토리 피드에 등록된 언어입니다. | 속성 | String |
예 |
productMpn |
제품 상품의 MPN 속성 (제조업체 부품번호)입니다. | 속성 | String |
예 |
productColor |
제품 상품의 color[색상] 속성입니다. | 속성 | String |
예 |
productSize |
제품 상품의 size 속성입니다. | 속성 | String |
예 |
productMaterial |
제품 상품의 material 속성입니다. | 속성 | String |
예 |
productPattern |
제품 항목의 패턴 속성입니다. | 속성 | String |
예 |
productAvailability |
제품 상품의 availability[재고] 속성입니다. | 속성 | Product availability |
예 |
productGender |
제품 항목의 gender[성별] 속성입니다. | 속성 | String |
예 |
productAgeGroup |
제품 항목의 연령대 속성입니다. | 속성 | String |
예 |
productLandingPageUrl |
제품 항목의 방문 페이지 속성입니다. | 속성 | String |
예 |
productCategory |
제품 항목의 google product category(Google 제품 카테고리) 속성입니다. | 속성 | String |
예 |
productCategoryLevel1 |
제품 항목의 google 제품 카테고리 수준 1 속성입니다. | 속성 | String |
예 |
productCategoryLevel2 |
제품 항목의 google 제품 카테고리 수준 2 속성입니다. | 속성 | String |
예 |
productCategoryLevel3 |
제품 항목의 Google 제품 카테고리 수준 3 속성입니다. | 속성 | String |
예 |
productCategoryLevel4 |
제품 항목의 google 제품 카테고리 수준 4 속성입니다. | 속성 | String |
예 |
productCategoryLevel5 |
제품 항목의 google 제품 카테고리 수준 5 속성입니다. | 속성 | String |
예 |
productBrand |
제품 항목의 brand[브랜드] 속성입니다. | 속성 | String |
예 |
productGtin |
제품 항목의 GTIN 속성 (국제거래단품식별코드)입니다. | 속성 | String |
예 |
productPrice |
제품 항목의 price 속성입니다. | 속성 | Money |
예 |
productSalePrice |
제품 항목의 price 속성입니다. | 속성 | Money |
예 |
productTypeLevel1 |
제품 항목의 제품 유형 리드 1 속성입니다. | 속성 | String |
예 |
productTypeLevel2 |
제품 항목의 제품 유형 수준 2 속성 | 속성 | String |
예 |
productTypeLevel3 |
제품 항목의 제품 유형 3단계 속성입니다. | 속성 | String |
예 |
productTypeLevel4 |
제품 항목의 제품 유형 수준 4 속성입니다. | 속성 | String |
예 |
productTypeLevel5 |
제품 항목의 제품 유형 수준 5 속성 | 속성 | String |
예 |
productCondition |
제품 상품의 condition 속성입니다. | 속성 | String |
예 |
productCustomLabel0 |
제품 항목의 맞춤 라벨 0 속성입니다. | 속성 | String |
예 |
productCustomLabel1 |
제품 항목의 맞춤 라벨 1 속성입니다. | 속성 | String |
예 |
productCustomLabel2 |
제품 항목의 맞춤 라벨 2 속성입니다. | 속성 | String |
예 |
productCustomLabel3 |
제품 항목의 맞춤 라벨 3 속성입니다. | 속성 | String |
예 |
productCustomLabel4 |
제품 항목의 맞춤 라벨 4 속성입니다. | 속성 | String |
예 |
productCostOfGoodsSold |
인벤토리 피드에 지정된 제품 판매의 총 비용입니다. | 속성 | Money |
예 |
productStoreId |
오프라인 판매점 인벤토리 광고에서 제품을 광고한 매장입니다. 오프라인 제품 피드에 사용된 매장 ID와 일치해야 합니다. | 속성 | String |
예 |
productChannel |
제품 항목의 영업 채널 속성(Online 또는 Local )입니다. |
속성 | Product channel |
예 |
productChannelExclusivity |
제품 항목의 채널 독점 속성입니다. | 속성 | Product channel exclusivity |
예 |
productItemGroupId |
제품 항목의 상품 그룹 ID 속성입니다. | 속성 | String |
예 |
productTitle |
제품 항목의 제목 속성입니다. | 속성 | String |
예 |
dfaActions |
Campaign Manager 액션의 총횟수입니다. | 측정항목 | Integer |
예 |
dfaRevenue |
Campaign Manager 거래에서 발생한 수익을 합산합니다. | 측정항목 | Money |
예 |
dfaTransactions |
Campaign Manager 거래의 총횟수입니다. | 측정항목 | Integer |
예 |
dfaWeightedActions |
Campaign Manager 액션의 가중치 합계입니다. | 측정항목 | Number |
예 |
dfaActionsCrossEnv |
교차 환경 Campaign Manager 액션의 총횟수입니다. | 측정항목 | Number |
예 |
dfaRevenueCrossEnv |
교차 환경 Campaign Manager 거래에서 발생한 수익을 합산합니다. | 측정항목 | Money |
예 |
dfaTransactionsCrossEnv |
교차 환경 Campaign Manager 트랜잭션의 총횟수입니다. | 측정항목 | Number |
예 |
dfaWeightedActionsCrossEnv |
교차 환경 Campaign Manager 액션의 가중치 합계입니다. | 측정항목 | Number |
예 |
crossSellAverageUnitPrice |
다른 제품의 광고를 통해 판매된 제품의 판매 평균 가격입니다. | 측정항목 | Money |
예 |
crossSellCostOfGoodsSold |
다른 제품의 광고를 통해 제품이 판매될 때 발생한 총 판매 비용입니다. | 측정항목 | Money |
예 |
crossSellGrossFromUnitsSold |
다른 제품의 광고를 통해 해당 제품을 판매하여 얻은 총 수익입니다. | 측정항목 | Money |
예 |
crossSellGrossProfitMargin |
다른 제품의 광고를 통해 판매되는 특정 제품의 총 이익 마진입니다. | 측정항목 | Number |
예 |
crossSellRevenueFromUnitsSold |
교차 판매 (다른 제품을 광고한 결과로 발생한 수익)에서 발생한 총 수익입니다. | 측정항목 | Money |
예 |
crossSellUnitsSold |
크로스셀(cross-sell) 결과로 판매된 단위 수입니다. (다른 제품의 광고를 통해 판매된 제품의 수입니다.) | 측정항목 | Number |
예 |
leadAverageUnitPrice |
제품 광고를 통해 제품이 판매될 때 판매된 제품의 평균 가격입니다. | 측정항목 | Money |
예 |
leadCostOfGoodsSold |
제품 광고를 통해 판매된 제품의 총 판매 비용입니다. | 측정항목 | Money |
예 |
leadGrossProfitFromUnitsSold |
제품 광고를 통해 해당 제품을 판매하여 얻은 총 수익입니다. | 측정항목 | Money |
예 |
leadGrossProfitMargin |
제품을 직접 광고한 결과 특정 제품의 총 이익 마진입니다. | 측정항목 | Number |
예 |
leadRevenueFromUnitsSold |
제품의 광고를 통해 해당 제품에서 창출되는 총 수익입니다. | 측정항목 | Money |
예 |
leadUnitsSold |
제품 광고를 통해 판매된 제품의 개수입니다. | 측정항목 | Number |
예 |
productUnitsSold |
특정 제품에 대해 판매된 총 단위 수입니다. | 측정항목 | Number |
예 |
productRevenueFromUnitsSold |
제품에서 발생한 총 수익입니다 (각 제품에 보고된 가격 사용). | 측정항목 | Money |
예 |
productAverageUnitPrice |
제품 판매에 대해 보고된 평균 가격입니다 (각 제품에 보고된 가격 사용). | 측정항목 | Money |
예 |
date |
보고서를 일별로 분류합니다. 각 행과 해당 측정항목의 집계 측정항목이 하루에 하나씩 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. | 세그먼트 | Date |
예 |
monthStart |
보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 1일을 반환합니다. | 세그먼트 | Date |
예 |
monthEnd |
보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 말일을 반환합니다. | 세그먼트 | Date |
예 |
quarterStart |
보고서를 분기별로 분류합니다. 각 행과 집계된 측정항목은 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. | 세그먼트 | Date |
예 |
quarterEnd |
보고서를 분기별로 분류합니다. 각 행과 집계된 측정항목은 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 말일을 반환합니다. | 세그먼트 | Date |
예 |
weekStart |
보고서를 주 (일요일~토요일)로 분류하고, 각 행과 해당 측정항목의 집계 측정항목을 주당 하나씩 여러 행으로 나눕니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. | 세그먼트 | Date |
예 |
weekEnd |
보고서를 주 (일요일~토요일)로 분류하고, 각 행과 해당 측정항목의 집계 측정항목을 주당 하나씩 여러 행으로 나눕니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. | 세그먼트 | Date |
예 |
yearStart |
보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목은 연 1회씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫날을 반환합니다. | 세그먼트 | Date |
예 |
yearEnd |
보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목은 연 1회씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 마지막 날을 반환합니다. | 세그먼트 | Date |
예 |
deviceSegment |
보고서를 기기별로 분류합니다. 각 행과 해당 측정항목의 집계 측정항목이 여러 행으로 분할되어 각 기기 세그먼트에 대해 최대 1개씩 표시됩니다. 이 열은 각 행의 기기 세그먼트를 반환합니다. | 세그먼트 | Device segment |
예 |
floodlightGroup |
플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 그룹당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 그룹 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
floodlightGroupId |
플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 그룹당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 DS 플러드라이트 그룹 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | ID |
예 |
floodlightGroupTag |
플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 그룹당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 그룹 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
floodlightActivity |
플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 액티비티당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 액티비티 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
floodlightActivityId |
플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 액티비티당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 DS 플러드라이트 액티비티 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | ID |
예 |
floodlightActivityTag |
플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 액티비티당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 액티비티 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
accountId |
DS 엔진 계정 ID입니다. | 세그먼트 | ID |
예 |
campaignId |
보고서를 캠페인별로 분류합니다. 이 행은 행과 연결된 DS 캠페인 ID를 반환합니다. | 세그먼트 | ID |
예 |
adGroupId |
보고서를 광고그룹별로 분류합니다. 이 행은 행과 연결된 광고그룹 ID를 반환합니다. | 세그먼트 | ID |
예 |