다음을 포함한 광고주 보고 데이터:
- 광고주의 모든 엔진 계정 및 캠페인에 대한 실적 측정항목입니다.
- 광고주의 구성 속성입니다.
발췌 요청
일반 Reports.request() 또는 Reports.generate() 요청 본문을 보내지만 "reportType": "advertiser"를 지정합니다.
{
...
"reportType": "advertiser",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
보고서에서 반환 또는 필터링하려는 각 열에 대해 아래 표에 나열된 columnName를 지정합니다.
선택사항으로 headerText, startDate, endDate를 지정할 수도 있습니다.
일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참조하세요.
columnName | 설명 | 동작 | 유형 | 필터링 가능 |
|---|---|---|---|---|
status |
광고주 상태: Active, Paused 또는 Removed |
속성 | Status |
예 |
creationTimestamp |
ISO 8601 형식의 광고주가 만든 타임스탬프입니다. | 속성 | Timestamp |
예 |
lastModifiedTimestamp |
ISO 8601 형식으로 표시된 광고주의 최근 수정 타임스탬프. | 속성 | Timestamp |
예 |
agency |
대행사 이름 | 속성 | String |
예 |
agencyId |
DS 대행사 ID | 속성 | ID |
예 |
advertiser |
광고주 이름입니다. | 속성 | String |
예 |
advertiserId |
DS 광고주 ID | 속성 | ID |
예 |
dfaAdvertiserId |
이 DS 광고주와 연결된 Campaign Manager 광고주의 ID입니다. | 속성 | ID |
예 |
dfaNetworkId |
이 DS 광고주와 연결된 Campaign Manager 네트워크의 ID입니다. | 속성 | ID |
예 |
dfaNetworkTimeZone |
이 DS 광고주와 연결된 Campaign Manager 네트워크의 시간대이며 IANA 시간대 데이터베이스 형식입니다(예: America/New_York). |
속성 | String |
예 |
advertiserCurrencyCode |
ISO 4217 형식의 광고주의 통화 코드입니다. | 속성 | String |
예 |
googleAnalyticsTimeZone |
이 DS 광고주에 연결된 Google 애널리틱스 보기의 시간대입니다. IANA 시간대 데이터베이스 형식(예: America/New_York)을 사용합니다. |
속성 | 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 |
예 |
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 |
예 |
searchImpressionShare |
Google Ads 및 Bing Ads만 해당 검색 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 0.1에서 1 사이의 숫자로 반환되거나, 공유가 0.1보다 작으면 < 10% 문자열입니다. |
측정항목 | Impression share |
예 |
searchBudgetLostImpressionShare |
Google Ads 및 Bing Ads만 해당 검색 네트워크에서 예산 부족으로 광고가 노출되지 못한 횟수의 비율입니다. 0에서 0.9 사이의 숫자 또는 공유가 0.9보다 큰 경우 문자열 > 90%로 반환됩니다. |
측정항목 | Impression share |
예 |
searchRankLostImpressionShare |
Google Ads 및 Bing Ads만 해당 검색 네트워크에서 광고 순위가 낮아 광고가 노출되지 못한 횟수의 비율입니다. 0에서 0.9 사이의 숫자 또는 공유가 0.9보다 큰 경우 문자열 > 90%로 반환됩니다. |
측정항목 | Impression share |
예 |
displayImpressionShare |
(Google Ads만 해당) 디스플레이 네트워크에서 발생한 노출수를 발생 가능한 예상 노출수로 나눈 값입니다. 0.1에서 1 사이의 숫자로 반환되거나, 공유가 0.1보다 작으면 < 10% 문자열입니다. |
측정항목 | Impression share |
예 |
displayBudgetLostImpressionShare |
(Google Ads만 해당) 디스플레이 네트워크에서 예산 부족 때문에 광고가 노출되지 못한 횟수의 비율입니다. 0에서 0.9 사이의 숫자 또는 공유가 0.9보다 큰 경우 문자열 > 90%로 반환됩니다. |
측정항목 | Impression share |
예 |
displayRankLostImpressionShare |
(Google Ads만 해당) 디스플레이 네트워크에서 광고 순위가 낮아 광고가 노출되지 못한 횟수의 비율입니다. 0에서 0.9 사이의 숫자 또는 공유가 0.9보다 큰 경우 문자열 > 90%로 반환됩니다. |
측정항목 | Impression share |
예 |
qualityScoreAvg |
Google Ads 및 Bing Ads만 해당 보고서 범위의 모든 요일 및 키워드에 대한 엔진 품질평가점수 (QS)의 노출 가중치 적용 평균입니다. | 측정항목 | Number |
예 |
topOfPageBidAvg |
(Google Ads만 해당) 보고서 기간 동안 광고가 검색결과 위의 최상위 게재순위에 정기적으로 게재되는 데 필요한 평균 CPC 입찰가의 근사치입니다. | 측정항목 | Money |
예 |
absoluteTopImpressionPercentage |
자연 검색결과 위의 첫 번째 광고로 게재되는 광고 노출수의 비율입니다. | 측정항목 | Impression share |
예 |
searchAbsoluteTopImpressionShare |
절대 상단 위치 (자연 검색결과 위의 첫 번째 광고)에서 발생한 노출수를 상단 위치에서 받을 수 있었던 예상 노출수로 나눈 값입니다. | 측정항목 | Impression share |
예 |
topImpressionPercentage |
자연 검색결과 위에 표시되는 광고 노출수의 비율입니다. | 측정항목 | Impression share |
예 |
searchTopImpressionShare |
상단 위치 (자연 검색결과 위)에서 발생한 노출수를 상단 위치에서 받을 수 있었던 예상 노출수와 비교한 값입니다. | 측정항목 | Impression share |
예 |
searchBudgetLostAbsoluteTopImpressionShare |
예산 부족으로 인해 자연 검색결과 위에 첫 번째 광고로 게재되지 않은 빈도를 예측합니다. | 측정항목 | Impression share |
예 |
searchBudgetLostTopImpressionShare |
예산 부족으로 인해 자연 검색결과 위 어디에도 광고가 게재되지 않은 빈도를 파악하는 데 도움이 됩니다. | 측정항목 | Impression share |
예 |
searchRankLostAbsoluteTopImpressionShare |
광고 순위가 낮아 자연 검색결과 위에 첫 번째 광고로 게재되지 않은 빈도를 추정합니다. | 측정항목 | Impression share |
예 |
searchRankLostTopImpressionShare |
광고 순위가 낮아 자연 검색결과 위 어느 곳에도 광고가 게재되지 않은 빈도를 예측합니다. | 측정항목 | Impression share |
예 |
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 |
예 |