訪問に関する生のイベントデータ。訪問は、広告をクリックしたユーザーがランディング ページにリダイレクトされるたびに行われます。
このレポートは、非同期リクエスト(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 |
商品に関するデータを含む 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 |
このアクセスが発生した広告ネットワーク: Content 、Search 、または Other 。 |
属性 | Network type |
対応 |
visitReferrer |
訪問の参照元 URL。 | 属性 | String |
対応 |
visitExternalClickId |
gclid URL パラメータとしてランディング ページに渡される、各訪問の一意の文字列。コンバージョン API または Google アナリティクスを統合している広告主様のみ有効です。 | 属性 | String |
対応 |
feedItemId |
この訪問に関連付けられたフィード アイテムの行の ID。 | 属性 | ID |
対応 |
feedId |
この訪問に関連付けられたフィード テーブルの ID。 | 属性 | ID |
対応 |
feedType |
この訪問に関連付けられたフィードのタイプ。 | 属性 | Feed type |
対応 |