전환에 대한 원시 이벤트 데이터입니다.
이 보고서는 비동기식 요청 (즉, Reports.request() 메서드를 통해 전달될 수 있습니다.
이벤트가 특정 날짜에 발생하므로 이 보고서에 대한 요청에서는 timeRange, 다음 중 하나를 지정할 수 있습니다.
- startDate 및 endDate를 설정할 수 있습니다.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp 이벤트에 사용할 수 없음).
요청 발췌문
정기적으로
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 |
예 |