보고서 유형: 방문

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

이 보고서는 비동기식 요청 (즉, 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 예