レポートタイプ:

訪問に関する生のイベントデータ。訪問は、広告をクリックしたユーザーがランディング ページにリダイレクトされるたびに行われます。

このレポートは、非同期リクエスト(Reports.request() メソッド経由)でのみ返すことができます。

イベントは特定の日付で発生するため、このレポートのリクエストでは timeRange を指定する必要があります。次のいずれかを指定できます。

抜粋をリクエスト

通常の Reports.request() リクエストの本文を送信しますが、"reportType": "visit" を指定します。

{
...
  "reportType": "visit",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName を指定します。headerTextstartDateendDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。

columnName説明動作タイプフィルタ可能
status 訪問のステータス。訪問は不変なので、これは常に Active です。 属性 Status 対応
deviceSegment 訪問が関連付けられているデバイス セグメント: DesktopMobileTablet、または 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 AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaidu、または 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 キーワードのマッチタイプ: BroadExactPhrase、または 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 商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO 639-1)。 属性 String 対応
productStoreId クリックされたローカル在庫広告の店舗。ローカル商品フィードで使用されている店舗 ID と一致している必要があります。 属性 String 対応
productChannel クリックされた商品の販売チャネル: Online または Local 属性 Product channel 対応
visitId DS 訪問 ID。 属性 ID 対応
visitSearchQuery この訪問が発生した検索語句。 属性 String 対応
visitDate 訪問が発生したエンジン アカウントのタイムゾーンの日付。この日付は訪問の集計に使用されます。たとえば、5 月 1 日の訪問が集計されると、visitDate が 5 月 1 日であるすべての訪問がカウントされます。 属性 Date 対応
visitTimestamp 訪問が発生したときの UTC タイムスタンプ。 属性 Timestamp 対応
visitNetworkType このアクセスが発生した広告ネットワーク: ContentSearch、または Other 属性 Network type 対応
visitReferrer 訪問の参照元 URL。 属性 String 対応
visitExternalClickId gclid URL パラメータとしてランディング ページに渡される、各訪問の一意の文字列。コンバージョン API または Google アナリティクスを統合している広告主様のみ有効です。 属性 String 対応
feedItemId この訪問に関連付けられたフィード アイテムの行の ID。 属性 ID 対応
feedId この訪問に関連付けられたフィード テーブルの ID。 属性 ID 対応
feedType この訪問に関連付けられたフィードのタイプ。 属性 Feed type 対応