피드 항목의 실적 측정항목 및 구성 속성 (예: 사이트링크, 위치, 전화번호 또는 앱 광고 확장)
이 보고서는 비동기식 요청 (즉, Reports.request() 메서드를 통해 전달될 수 있습니다.
요청 발췌문
정기적으로
Reports.request()
요청 본문이지만 "reportType": "feedItem"를 지정하세요.
{
...
"reportType": "feedItem",
"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, active 등입니다. |
속성 | 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 |
예 |
sitelinkDisplayText |
피드 항목의 사이트링크 표시 텍스트입니다. | 속성 | String |
예 |
sitelinkDescription1 |
피드 항목의 사이트링크 설명 1입니다. | 속성 | String |
예 |
sitelinkDescription2 |
피드 항목의 사이트링크 설명 2입니다. | 속성 | String |
예 |
sitelinkLandingPageUrl |
피드 항목의 사이트링크 방문 페이지 URL입니다. | 속성 | String |
예 |
sitelinkClickserverUrl |
피드 항목의 사이트링크 클릭서버 URL 이름입니다. | 속성 | String |
예 |
locationBusinessName |
업그레이드된 위치 광고 확장에 정의된 비즈니스의 이름입니다. | 속성 | String |
예 |
locationCategory |
업그레이드된 추가 위치 정보에서 비즈니스에 대해 정의된 카테고리입니다. | 속성 | String |
예 |
locationDetails |
업그레이드된 위치 광고 확장에 정의된 비즈니스에 대한 세부정보입니다. | 속성 | String |
예 |
callPhoneNumber |
전화번호 광고 확장의 전화번호입니다. | 속성 | String |
예 |
callCountryCode |
전화번호 광고 확장의 국가 코드입니다. | 속성 | String |
예 |
callIsTracked |
전화번호 광고 확장의 통화를 추적할 경우 true, 그렇지 않은 경우 false를 반환합니다. | 속성 | Boolean |
예 |
callCallOnly |
전화번호 광고 확장이 전화번호만 표시하도록 설정된 경우 true를 반환합니다. 통화와 링크가 모두 표시되면 false를 반환합니다. | 속성 | Boolean |
예 |
callConversionTracker |
이 전화번호 광고 확장과 연결된 전환 추적기의 이름입니다(있는 경우). | 속성 | String |
예 |
callConversionTrackerId |
이 피드 항목과 연결된 전환 추적기의 ID입니다(있는 경우). | 속성 | ID |
예 |
appId |
앱 광고 확장에 정의된 앱 ID입니다. | 속성 | String |
예 |
appStore |
앱 광고 확장에 대해 정의된 앱 스토어 유형 (Apple App Store, Google Play 스토어)입니다. | 속성 | App store |
예 |
feedItemId |
피드 항목 행 ID입니다. | 속성 | ID |
예 |
feedId |
피드 표 ID | 속성 | ID |
예 |
clicksWithFeedItemShowing |
피드 항목이 표시된 상태에서 광고의 링크를 클릭합니다. 이 열은 피드 항목 보고서 또는 피드 항목 열로 분류된 보고서의 값만 반환합니다. | 측정항목 | Integer |
예 |
costWithFeedItemShowing |
피드 항목이 표시되었을 때의 모든 광고의 비용입니다. 이 열은 피드 항목 보고서 또는 피드 항목 열로 분류된 보고서의 값만 반환합니다. | 측정항목 | Money |
예 |
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 |
예 |
floodlightGroup |
플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 열은 각 행의 플러드라이트 그룹 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
floodlightGroupId |
플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 항목은 각 행의 DS 플러드라이트 그룹 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | ID |
예 |
floodlightGroupTag |
플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 그룹당 하나씩). 이 열은 각 행의 플러드라이트 그룹 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
floodlightActivity |
플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 플러드라이트 활동 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |
floodlightActivityId |
플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 DS 플러드라이트 활동 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | ID |
예 |
floodlightActivityTag |
플러드라이트 활동별로 보고서 분류하기 각 행과 해당 집계 측정항목이 여러 행으로 분할됩니다(플러드라이트 활동당 하나씩). 이 열은 각 행의 플러드라이트 활동 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. | 세그먼트 | String |
예 |