보고서 유형: productTarget

제품 타겟의 실적 측정항목 및 구성 속성 제품 타겟은 Google Ads 제품 목록 광고(PLA) 캠페인에서 Google 판매자 센터 계정의 어떤 제품이 제품 목록 광고(쇼핑 광고)를 실행하여 Google의 관련 검색어에 표시되도록 할지 지정하는 데 사용되었습니다. 제품 타겟과 PLA 캠페인이 Google Ads 쇼핑 캠페인으로 대체되었습니다. 쇼핑 캠페인으로 업그레이드하기 전에 계속해서 제품 목록 광고(PLA) 캠페인이 기여한 이전 측정항목에 대한 보고서를 DS에서 요청할 수 있습니다.

이 보고서는 비동기식 요청 (즉, Reports.request() 메서드를 통해 전달될 수 있습니다.

요청 발췌문

정기적으로 Reports.request() 요청 본문이지만 "reportType": "productTarget"를 지정하세요. 

{
...
  "reportType": "productTarget",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

보고서에서 반환하거나 필터링하려는 각 열에 대해 아래 표에 나열된 columnName를 지정해야 합니다. 원하는 경우 headerText, startDate, 및 endDate를 선택합니다. 일부 열은 필터링할 수 없습니다. 자세한 내용은 '필터링 가능' 를 참조하세요.

columnName설명동작유형필터링 가능
status 제품 타겟의 상태입니다(예: Active, Paused 또는 Removed). 캠페인, 광고그룹, 제품 타겟 및 광고에는 각각 상태가 있습니다. 상태를 참고하세요. 속성 Status 예
engineStatus 외부 엔진 계정에 있는 제품 타겟의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 review, campaign paused 등입니다. 속성 String 예
creationTimestamp 제품 타겟이 생성된 타임스탬프로, ISO 8601 형식으로 지정됩니다. 속성 Timestamp 예
lastModifiedTimestamp 제품 타겟의 가장 최근 수정사항의 타임스탬프로, ISO 8601 형식으로 지정됩니다. 속성 Timestamp 예
agency 대행사 이름. 속성 String 예
agencyId DS 대행사 ID를 찾습니다. 속성 ID 예
advertiser 광고주 이름입니다. 속성 String 예
advertiserId DS 광고주 ID 속성 ID 예
account 엔진 계정 이름입니다. 속성 String 예
accountId DS 엔진 계정 ID 속성 ID 예
accountEngineId 외부 엔진 계정의 계정 ID입니다. 속성 String 예
accountType 엔진 계정 유형: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu 또는 Comparison Shopping. 속성 Engine type 예
campaign 캠페인 이름: 속성 String 예
campaignId DS 캠페인 ID입니다. 속성 ID 예
campaignStatus 이 항목이 포함된 캠페인의 상태입니다. 속성 Status 예
adGroup 광고그룹 이름: 속성 String 예
adGroupId DS 광고그룹 ID 속성 ID 예
adGroupStatus 이 항목이 포함된 광고그룹의 상태입니다. 속성 Status 예
productTargetId DS 제품 타겟 ID 속성 ID 예
productTargetFilter 이 제품 타겟으로 Google 판매자 센터 계정의 제품을 필터링합니다. 제품 ID, 브랜드 등의 속성을 사용하여 일치 기준을 지정할 수 있습니다. 속성 String 아니요
productTargetEngineId 외부 엔진 계정의 제품 타겟 ID입니다. 속성 ID 예
productTargetLandingPage 사용자가 쇼핑 광고를 클릭한 후 방문할 최종 URL을 나타내는 값입니다. 쇼핑 광고 방문 페이지를 참조하세요. 속성 String 예
productTargetClickserverUrl DS가 활동을 추적하는 데 사용하는 URL입니다. 쇼핑 광고를 클릭하는 사용자는 먼저 클릭서버 URL을 방문한 다음 최종 방문 페이지로 리디렉션됩니다. 쇼핑 광고 방문 페이지를 참조하세요. 속성 String 예
productTargetLabels 이 제품 타겟에 직접 할당된 라벨의 이름입니다. 상속된 라벨은 포함되지 않습니다. 속성 String list 예
productTargetMaxCpc 광고그룹의 최대 CPC를 재정의하고, 사용자가 이 특정 제품 타겟의 제품 광고를 클릭할 경우 지불할 의사가 있는 최대 금액을 설정합니다. 이 입력란이 비어 있으면 제품 타겟에서 광고그룹의 최대 CPC를 사용합니다. 속성 Money 예
effectiveProductTargetMaxCpc 이 제품 타겟에 적용되는 최대 CPC (최대 클릭당비용)입니다. 이 값은 광고그룹의 최대 CPC와 같은 값이거나 제품 타겟이 광고그룹의 설정을 재정의하는 경우 제품 타겟의 자체 최대 CPC입니다. 속성 Money 예
productTargetMaxBid 이 제품 타겟이 DS 입찰 전략으로 관리되는 경우 입찰 전략에서 이 한도를 초과하여 입찰가를 높이지 않습니다. 제품 타겟에 입찰 전략 적용하기를 참고하세요. 속성 Money 예
productTargetMinBid 이 제품 타겟이 DS 입찰 전략으로 관리되는 경우 입찰 전략은 입찰가를 이 한도 미만으로 낮추지 않습니다. 제품 타겟에 입찰 전략 적용하기를 참고하세요. 속성 Money 예
effectiveBidStrategyId 이 항목에 할당되었거나 이 항목에서 상속한 입찰 전략의 DS ID입니다. 속성 ID 예
effectiveBidStrategy 이 항목에 할당되거나 이 항목에서 상속한 입찰 전략의 이름입니다. 속성 String 예
bidStrategyInherited 이 항목의 입찰 전략이 상속되는지 여부를 나타냅니다. 속성 Boolean 예
effectiveLabels 이 제품 타겟에 상속되었거나 직접 할당된 모든 라벨의 이름입니다. 속성 String list 예
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 예
avgCpc 평균 클릭당비용 측정항목 Money 예
avgCpm 평균 1,000회 노출당비용 측정항목 Money 예
avgPos 평균 게재순위 측정항목 Number 예
clicks 클릭수 집계 측정항목 Integer 예
cost 엔진 계정에 지불한 총 비용입니다. 측정항목 Money 예
ctr 평균 클릭률 측정항목 Number 예
impr 총 노출수입니다. 측정항목 Integer 예
adWordsConversions 광고주가 Google Ads 전환 열에 보고하기 위해 설정한 데이터입니다. Google Ads 전환 액션이 생성되면 광고주는 전환 보고 열에서 해당 전환을 집계할지 여부를 선택할 수 있습니다. 측정항목 Number 예
adWordsConversionValue Google Ads 전환의 총 가치입니다. 측정항목 Number 예
adWordsViewThroughConversions Google Ads의 총 조회 후 전환수입니다. 측정항목 Integer 예
visits 총 DS 방문 수입니다. 측정항목 Integer 예
date 보고서를 일수별로 분류합니다. 각 행과 해당 집계 측정항목이 날짜별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. 세그먼트 Date 예
monthStart 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 첫 번째 날을 반환합니다. 세그먼트 Date 예
monthEnd 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 월별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 월의 마지막 날을 반환합니다. 세그먼트 Date 예
quarterStart 보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. 세그먼트 Date 예
quarterEnd 보고서를 분기별로 분류합니다. 각 행과 해당 집계 측정항목이 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 중 마지막 날을 반환합니다. 세그먼트 Date 예
weekStart 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. 세그먼트 Date 예
weekEnd 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 해당 집계 측정항목이 매주 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. 세그먼트 Date 예
yearStart 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫 번째 날을 반환합니다. 세그먼트 Date 예
yearEnd 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목이 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 중 마지막 날을 반환합니다. 세그먼트 Date 예
deviceSegment 보고서를 기기별로 분류합니다. 각 행과 집계 측정항목이 기기 세그먼트당 최대 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 기기 세그먼트를 반환합니다. 세그먼트 Device segment 예
floodlightGroup 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 열은 각 행의 플러드라이트 그룹 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예
floodlightGroupId 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 항목은 각 행의 DS 플러드라이트 그룹 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 ID 예
floodlightGroupTag 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 열은 각 행의 플러드라이트 그룹 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예
floodlightActivity 플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 플러드라이트 활동 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예
floodlightActivityId 플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 DS 플러드라이트 활동 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 ID 예
floodlightActivityTag 플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 플러드라이트 활동 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예