보고서 유형: 방문

방문수에 대한 원시 이벤트 데이터입니다. 방문은 소비자가 광고를 클릭하고 방문 페이지로 리디렉션될 때마다 발생합니다.

이 보고서는 비동기식 요청 (즉, Reports.request() 메서드를 통해 전달될 수 있습니다.

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

요청 발췌문

정기적으로 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