訪問に関する未加工のイベントデータです。訪問は、ユーザーが広告をクリックしてランディング ページにリダイレクトされるたびに発生します。
このレポートを返すことができるのは、非同期リクエスト（ 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 に誤りがあったりすると、指標を広告に関連付けることができなくなります。 | 属性 | 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 |
○ |