보고서 유형: 피드 항목

피드 항목의 실적 측정항목 및 구성 속성 (예: 사이트링크, 위치, 통화 또는 앱 광고 확장)입니다.

이 보고서는 비동기식 요청에 의해서만 반환될 수 있습니다 (즉, 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 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 1일을 반환합니다. 세그먼트 Date 예
monthEnd 보고서를 월별로 분류합니다. 각 행과 해당 집계 측정항목은 매월 하나씩, 여러 개의 행으로 분할됩니다. 이 열은 각 행에서 매월 말일을 반환합니다. 세그먼트 Date 예
quarterStart 보고서를 분기별로 분류합니다. 각 행과 집계된 측정항목은 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. 세그먼트 Date 예
quarterEnd 보고서를 분기별로 분류합니다. 각 행과 집계된 측정항목은 분기마다 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 분기 말일을 반환합니다. 세그먼트 Date 예
weekStart 보고서를 주 (일요일~토요일)로 분류하고, 각 행과 해당 측정항목의 집계 측정항목을 주당 하나씩 여러 행으로 나눕니다. 이 열은 각 행의 첫 번째 날 (일요일)을 반환합니다. 세그먼트 Date 예
weekEnd 보고서를 주 (일요일~토요일)로 분류하고, 각 행과 해당 측정항목의 집계 측정항목을 주당 하나씩 여러 행으로 나눕니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. 세그먼트 Date 예
yearStart 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목은 연 1회씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 첫날을 반환합니다. 세그먼트 Date 예
yearEnd 보고서를 연도별로 분류합니다. 각 행과 해당 집계 측정항목은 연 1회씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도의 마지막 날을 반환합니다. 세그먼트 Date 예
floodlightGroup 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 그룹당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 그룹 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예
floodlightGroupId 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 그룹당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 DS 플러드라이트 그룹 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 ID 예
floodlightGroupTag 플러드라이트 그룹별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 그룹당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 그룹 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예
floodlightActivity 플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 액티비티당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 액티비티 이름을 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예
floodlightActivityId 플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 액티비티당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 DS 플러드라이트 액티비티 ID를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 ID 예
floodlightActivityTag 플러드라이트 액티비티별로 보고서를 분류합니다. 각 행과 집계된 측정항목이 각 플러드라이트 액티비티당 최대 1개의 여러 행으로 분할됩니다. 이 열은 각 행의 플러드라이트 액티비티 태그를 반환합니다. 일부 측정항목에는 클릭수 및 방문수와 같은 플러드라이트 분류 값이 없습니다. 세그먼트 String 예