보고서 유형: conversion

전환에 관한 원시 이벤트 데이터입니다.

이 보고서는 비동기식 요청 (즉, Reports.request() 메서드)으로만 반환할 수 있습니다.

이벤트는 특정 날짜에 발생하므로 이 보고서 요청에는 timeRange를 지정해야 합니다. 다음 중 하나를 지정할 수 있습니다.

발췌 요청

일반 Reports.request() 요청 본문을 전송하지만 "reportType": "conversion"를 지정합니다. 

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

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

columnName설명동작유형필터링 가능
status 전환 상태(Active 또는 Removed)입니다. 속성 Status 예
deviceSegment 전환 기여도가 부여된 기기 세그먼트입니다(Desktop, Mobile, Tablet, Other). 속성 Device segment 예
floodlightGroup 플러드라이트 그룹 이름입니다. 속성 String 예
floodlightGroupConversionType 이 그룹의 플러드라이트 활동에서 생성된 전환 유형입니다(Action 또는 Transaction). 속성 Conversion type 예
floodlightGroupId DS 플러드라이트 그룹 ID입니다. 속성 ID 예
floodlightGroupTag 플러드라이트 그룹 태그 속성 String 예
floodlightActivity 플러드라이트 활동 이름입니다. 속성 String 예
floodlightActivityId DS 플러드라이트 활동 ID입니다. 속성 ID 예
floodlightActivityTag 플러드라이트 활동 태그 속성 String 예
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 예
keywordId DS 키워드 ID입니다. 값이 0이면 키워드가 기여 비구분 상태임을 나타냅니다. 속성 ID 예
keywordMatchType 키워드 일치 유형: Broad, Exact, Phrase 또는 Content 속성 Match type 예
keywordText 키워드 텍스트 속성 String 예
productTargetId DS 제품 타겟 ID입니다. 속성 ID 예
productGroupId 이 전환과 연결된 제품 그룹 ID입니다. 쇼핑 캠페인의 전환에만 제품 그룹 ID가 있습니다. 제품 그룹 ID는 조인에 사용해서는 안 됩니다. 속성 ID 예
ad 광고 이름입니다. 속성 String 예
adId DS 광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다. 속성 ID 예
isUnattributedAd 이 행의 측정항목을 특정 광고에 기여도 부여할 수 없는지 여부를 나타냅니다. 예를 들어 지원되지 않는 형식의 광고 또는 잘못된 클릭서버 URL은 DS가 광고에 측정항목 기여도를 부여하지 못하게 할 수 있습니다. 속성 Boolean 예
inventoryAccountId 전환과 연결된 제품이 포함된 DS 인벤토리 계정 ID입니다. 사용자가 DS에서 인벤토리 계정을 연결하면 DS에서 이 ID를 생성합니다. 속성 ID 예
productId 이 전환과 연결된 제품의 ID입니다. 속성 String 예
productCountry 이 전환과 연결된 제품이 포함된 인벤토리 피드에 등록된 국가 (ISO 3166 형식)입니다. 속성 String 예
productLanguage 이 전환과 연결된 제품의 언어 (ISO 639-1)입니다. 속성 String 예
productStoreId 전환과 연결된 오프라인 판매점 인벤토리 광고의 매장입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다. 속성 String 예
productChannel 전환과 연결된 제품의 영업 채널: Online 또는 Local 속성 Product channel 예
conversionId Search Ads 360에서 각 전환에 대해 생성하는 ID입니다. 속성 ID 예
advertiserConversionId 오프라인 전환의 경우 광고주가 제공하는 ID입니다. 광고주가 이러한 ID를 지정하지 않으면 Search Ads 360이 ID를 생성합니다. 온라인 전환의 경우 광고주의 플러드라이트 지침에 따라 conversionId 열 또는 floodlightOrderId 열과 동일합니다. 속성 String 예
conversionType 전환 유형: Action 또는 Transaction 속성 Conversion type 예
conversionRevenue 전환으로 발생한 총 금액입니다. 속성 Money 예
conversionQuantity 전환으로 기록된 항목 수입니다. qty 매개변수에 따라 결정됩니다. 광고주가 매개변수를 동적으로 채워야 하며(예: 전환에서 판매된 항목 수) 그렇지 않은 경우 기본값은 1입니다. 속성 Number 예
conversionDate Campaign Manager 네트워크 시간대의 전환 날짜입니다. 이 날짜는 전환 측정항목 집계에 사용됩니다. 예를 들어 DS가 5월 1일의 액션을 집계하면 conversionDate이 5월 1일인 모든 액션 전환이 집계됩니다. 속성 Date 예
conversionTimestamp 전환이 발생한 시점의 UTC 타임스탬프입니다. 속성 Timestamp 예
conversionLastModifiedTimestamp 전환이 마지막으로 수정된 시간의 UTC 타임스탬프입니다. 속성 Timestamp 예
conversionAttributionType 전환 기인 대상: Visit 또는 Keyword+Ad 속성 Conversion attribution type 예
conversionVisitId 전환의 기인 대상이 되는 DS 방문 ID입니다. 속성 ID 예
conversionVisitTimestamp 전환의 기인 대상이 되는 방문의 UTC 타임스탬프입니다. 속성 Timestamp 예
conversionVisitExternalClickId 방문 페이지에 gclid URL 매개변수로 전달되며, 전환의 기인 대상이 되는 방문에 대한 고유 문자열입니다. 전환 API 통합 또는 Google 애널리틱스 통합이 있는 광고주에게만 사용 설정됩니다. 속성 String 예
conversionSearchTerm 전환으로 이어진 검색어입니다. 속성 String 예
floodlightOriginalRevenue 플러드라이트 통화 안내 수정 전 플러드라이트 이벤트와 연관된 원래의 변경되지 않은 수익입니다(현재 보고서의 통화). 속성 Money 예
floodlightEventRequestString 전환의 플러드라이트 요청 문자열입니다. 속성 String 예
floodlightReferrer 전환의 플러드라이트 리퍼러 웹사이트입니다. 속성 String 예
floodlightOrderId 광고주가 전환을 위해 제공한 플러드라이트 주문 ID입니다. 속성 String 예
feedItemId 이 전환과 연결된 피드 항목 행의 ID입니다. 속성 ID 예
feedId 이 전환과 연결된 피드 테이블의 ID입니다. 속성 ID 예
feedType 이 전환과 연결된 피드 유형입니다. 속성 Feed type 예