위치 타겟, 동적 광고 타겟, 리마케팅 목록 타겟, 연령/성별 타겟, 분류되지 않은 타겟을 포함한 광고 그룹 수준 타겟의 실적 측정항목입니다. 일부 타겟은 특정 유형의 엔진 계정에서만 사용할 수 있습니다.
이 보고서는 비동기식 요청 (즉, Reports.request() 메서드)으로만 반환할 수 있습니다.
발췌 요청
일반 Reports.request() 요청 본문을 전송하지만 "reportType": "adGroupTarget"를 지정합니다.
{
...
"reportType": "adGroupTarget",
"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 |
예 |
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 |
예 |
engineRemarketingList |
타겟과 연결된 리마케팅 목록의 이름입니다. | 속성 | String |
예 |
engineRemarketingListBidModifier |
타겟과 연결된 입찰가 조정입니다. | 속성 | Number |
예 |
dynamicSearchAdsTargetConditions |
동적 광고 타겟이 사이트 도메인 아래의 페이지를 선택하는 데 사용하는 기준입니다. | 속성 | String |
아니요 |
dynamicSearchAdsTargetCpcBid |
동적 광고 타겟의 최대 CPC (최대 클릭당비용) 설정입니다. | 속성 | Money |
예 |
dynamicSearchAdsTargetLandingPageUrl |
동적 광고 타겟의 URL 템플릿입니다. | 속성 | String |
예 |
dynamicSearchAdsTargetCoverage |
동적 광고 타겟과 일치하는 광고주 사이트의 페이지 비율입니다. | 속성 | Number |
예 |
locationTargetName |
위치 타겟의 이름입니다. | 속성 | String |
예 |
locationTargetBidModifier |
타겟 위치와 연결된 입찰가 조정입니다. | 속성 | Number |
예 |
ageTargetAgeRange |
연령대 타겟의 연령대입니다. | 속성 | Age range |
예 |
ageTargetBidModifier |
연령대 타겟과 연결된 입찰가 조정입니다. | 속성 | Number |
예 |
genderTargetGenderType |
성별 타겟의 성별 유형: 남성, 여성, 알 수 없음 | 속성 | Gender type |
예 |
genderTargetBidModifier |
성별 타겟과 연결된 입찰가 조정입니다. | 속성 | Number |
예 |
unclassifiedTargetName |
분류되지 않은 대상의 이름입니다. | 속성 | String |
예 |
unclassifiedTargetType |
분류되지 않은 타겟 유형: Dynamic search. |
속성 | Unclassified target type |
예 |
adGroupTargetId |
광고 그룹 타겟에 대해 생성된 ID DS입니다. | 속성 | ID |
예 |
dfaActions |
Campaign Manager 액션의 총 개수입니다. | 측정항목 | Integer |
예 |
dfaRevenue |
Campaign Manager 거래에서 발생한 총수익입니다. | 측정항목 | Money |
예 |
dfaTransactions |
Campaign Manager 거래의 총 개수입니다. | 측정항목 | Integer |
예 |
dfaWeightedActions |
Campaign Manager 액션의 가중치 합계입니다. | 측정항목 | Number |
예 |
dfaActionsCrossEnv |
교차 환경 캠페인 관리자 액션의 총 수입니다. | 측정항목 | 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 |
보고서를 연도별로 분류합니다. 각 행과 집계 측정항목은 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 첫날을 반환합니다. | 세그먼트 | Date |
예 |
yearEnd |
보고서를 연도별로 분류합니다. 각 행과 집계 측정항목은 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 마지막 날짜를 반환합니다. | 세그먼트 | 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 |
예 |