보고서 유형: 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