보고서 유형: 광고

광고의 실적 측정항목 및 구성 속성입니다.

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

발췌 요청

일반 Reports.request() 요청 본문을 보내지만 "reportType": "ad"를 지정합니다.

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

보고서에서 반환 또는 필터링하려는 각 열에 대해 아래 표에 나열된 columnName를 지정합니다. 선택사항으로 headerText, startDate, endDate를 지정할 수도 있습니다. 일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참조하세요.

columnName	설명	동작	유형	필터링 가능
status	광고의 상태입니다(Active, Paused 또는 Removed). 캠페인, 광고그룹, 키워드 및 광고는 각각 자체 상태가 있습니다. 상태를 참고하세요.	속성	Status	예
engineStatus	외부 엔진 계정에 있는 광고의 추가 상태입니다. 가능한 외부 상태는 active, eligible, creative deleted, creative approved family safe 등이며 외부 계정 유형에 따라 다릅니다.	속성	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	예
ad	광고 이름입니다.	속성	String	예
adId	DS 광고 ID 값이 0이면 광고가 기여하지 않았음을 나타냅니다.	속성	ID	예
adEngineId	외부 엔진 계정에 있는 광고의 ID.	속성	ID	예
isUnattributedAd	이 행의 측정항목이 특정 광고와 관련이 없는지 여부를 나타냅니다. 예를 들어 지원되지 않는 형식이나 잘못된 클릭서버 URL이 있는 광고는 DS에서 광고에 대한 측정항목을 제공하지 못할 수 있습니다.	속성	Boolean	예
adHeadline	광고 제목	속성	String	예
adHeadline2	광고 제목 2: 일부 엔진에서 사용할 수 없습니다.	속성	String	예
adHeadline3	광고 제목 3. 일부 엔진에서는 사용할 수 없습니다.	속성	String	예
adDescription1	광고 내용 입력란 1.	속성	String	예
adDescription2	광고 내용 입력란 2입니다. 일부 엔진에서는 사용할 수 없습니다.	속성	String	예
adDisplayUrl	광고 표시 URL입니다.	속성	String	예
adLandingPage	광고 방문 페이지 방문 페이지 및 클릭서버 URL을 참고하세요.	속성	String	예
adType	광고 유형: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text 또는 Expanded dynamic search	속성	Ad type	예
adPromotionLine	광고 프로모션 행 제품 광고에 대한 짧은 프로모션 메시지입니다.	속성	String	예
adLabels	이 광고에 직접 할당된 라벨 이름입니다. 상속된 라벨은 포함되지 않습니다.	속성	String list	예
adPathField1	광고 경로 입력란 1. 경로 입력란 1과 2는 adDisplayUrl과 결합되어 광고에 표시되는 URL을 형성합니다.	속성	String	예
adPathField2	광고 경로 입력란 2. 경로 입력란 1과 2는 adDisplayUrl과 결합되어 광고에 표시되는 URL을 형성합니다.	속성	String	예
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	보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 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	예