レポートタイプ: 訪問

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

このレポートを返すことができるのは、非同期リクエスト( 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 に誤りがあったりすると、指標を広告に関連付けることができなくなります。 属性 Boolean ○
inventoryAccountId クリックされた商品を含む DS 在庫アカウント ID。DS で在庫アカウントをリンクすると、この ID が生成されます。 属性 ID ○
productId クリックされた商品の ID。 属性 String ○
productCountry クリックされた商品を含む在庫フィードに登録されている国(ISO 3166 形式)。 属性 String ○
productLanguage 商品に関するデータを含む Merchant Center フィードに設定されている言語(ISO 639-1)。 属性 String ○
productStoreId クリックされたローカル在庫広告のストア。この ID はローカル商品フィードで使用されているストア 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 ○