방문에 관한 원시 이벤트 데이터입니다. 방문은 소비자가 광고를 클릭하고 방문 페이지로 리디렉션될 때마다 발생합니다.
이 보고서는 비동기식 요청에 의해서만 반환될 수 있습니다 (즉, Reports.request() 메서드를 통해).
이벤트는 특정 날짜에 발생하므로 이 보고서에 대한 요청은 timeRange를 지정해야 합니다. 다음 중 하나를 지정할 수 있습니다.
- startDate 및 endDate
- changedMetricsSinceTimestamp(changedAttributesSinceTimestamp가 이벤트에 유효하지 않음)
발췌 요청
일반 Reports.request() 요청 본문을 보내지만 "reportType": "visit"
를 지정합니다.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
보고서에서 반환 또는 필터링하려는 각 열에 대해 아래 표에 나열된 columnName
를 지정합니다.
선택사항으로 headerText, startDate, endDate를 지정할 수도 있습니다.
일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참조하세요.
columnName | 설명 | 동작 | 유형 | 필터링 가능 |
---|---|---|---|---|
status |
방문 상태입니다. 방문수는 변경할 수 없으므로 항상 Active 입니다. |
속성 | Status |
예 |
deviceSegment |
방문이 기여한 기기 세그먼트: Desktop , Mobile , Tablet 또는 Other |
속성 | Device segment |
예 |
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 |
예 |
visitId |
DS 방문 ID | 속성 | ID |
예 |
visitSearchQuery |
이 방문을 생성한 검색어입니다. | 속성 | String |
예 |
visitDate |
방문이 발생한 엔진 계정 시간대의 날짜입니다. 이 날짜는 방문 집계에 사용됩니다. 예를 들어 DS에서 5월 1일의 방문을 집계할 때 visitDate 이 5월 1일인 모든 방문을 집계합니다. |
속성 | Date |
예 |
visitTimestamp |
방문이 발생한 UTC 타임스탬프입니다. | 속성 | Timestamp |
예 |
visitNetworkType |
이 방문을 생성한 광고 네트워크입니다(Content , Search 또는 Other ). |
속성 | Network type |
예 |
visitReferrer |
방문의 리퍼러 URL입니다. | 속성 | String |
예 |
visitExternalClickId |
gclid URL 매개변수로 방문 페이지에 전달되는 방문마다 고유한 문자열입니다. 전환 API 통합 또는 Google 애널리틱스 통합을 사용하는 광고주만 사용 설정할 수 있습니다. | 속성 | String |
예 |
feedItemId |
이 방문과 연결된 피드 항목 행의 ID입니다. | 속성 | ID |
예 |
feedId |
이 방문과 연결된 피드 표의 ID입니다. | 속성 | ID |
예 |
feedType |
이 방문과 연결된 피드 유형입니다. | 속성 | Feed type |
예 |