コンバージョンに関する元のイベントデータ。
このレポートは、非同期リクエスト(Reports.request() メソッド経由)でのみ返すことができます。
イベントは特定の日付で発生するため、このレポートのリクエストでは timeRange を指定する必要があります。次のいずれかを指定できます。
- startDate と endDate です。
- changedMetricsSinceTimestamp(changedAttributesSinceTimestamp はイベントに対して有効ではありません)
抜粋をリクエスト
通常の Reports.request() リクエストの本文を送信しますが、"reportType": "conversion"
を指定します。
{ ... "reportType": "conversion", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName
を指定します。headerText、startDate、endDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。
columnName | 説明 | 動作 | タイプ | フィルタ可能 |
---|---|---|---|---|
status |
コンバージョンのステータス: Active または Removed 。 |
属性 | Status |
対応 |
deviceSegment |
コンバージョンが関連付けられているデバイス セグメント: Desktop 、Mobile 、Tablet 、または Other 。 |
属性 | Device segment |
対応 |
floodlightGroup |
Floodlight グループ名。 | 属性 | String |
対応 |
floodlightGroupConversionType |
このグループの Floodlight アクティビティで生成されたコンバージョンのタイプ: Action または Transaction 。 |
属性 | Conversion type |
対応 |
floodlightGroupId |
DS Floodlight グループ ID。 | 属性 | ID |
対応 |
floodlightGroupTag |
Floodlight グループタグ。 | 属性 | String |
対応 |
floodlightActivity |
Floodlight アクティビティ名。 | 属性 | String |
対応 |
floodlightActivityId |
DS Floodlight アクティビティ ID。 | 属性 | ID |
対応 |
floodlightActivityTag |
Floodlight アクティビティ タグ。 | 属性 | String |
対応 |
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 |
対応 |
conversionId |
検索広告 360 によってコンバージョンごとに生成される ID。 | 属性 | ID |
対応 |
advertiserConversionId |
オフライン コンバージョンの場合、これは広告主から提供された ID です。広告主から上記の ID が指定されていない場合、検索広告 360 によって ID が生成されます。オンライン コンバージョンの場合、これは広告主の Floodlight 処理に応じて conversionId 列または floodlightOrderId 列と同じです。 | 属性 | String |
対応 |
conversionType |
コンバージョンのタイプ(Action または Transaction )。 |
属性 | Conversion type |
対応 |
conversionRevenue |
コンバージョンによって発生した費用の合計額。 | 属性 | Money |
対応 |
conversionQuantity |
コンバージョンで記録された項目の量。qty パラメータで決定されます。広告主は、パラメータ(コンバージョンで販売されたアイテムの数など)を動的に入力する必要があります。そうしないと、デフォルトで 1 に設定されます。 | 属性 | Number |
対応 |
conversionDate |
コンバージョンが発生したキャンペーン マネージャーのネットワーク タイムゾーンの日付。この日付はコンバージョン指標の集計に使用されます。たとえば、5 月 1 日のアクションが集計されると、conversionDate が 5 月 1 日であるアクション コンバージョンがすべてカウントされます。 |
属性 | Date |
対応 |
conversionTimestamp |
変換が発生した UTC タイムスタンプ。 | 属性 | Timestamp |
対応 |
conversionLastModifiedTimestamp |
コンバージョンの最終更新日の UTC タイムスタンプ。 | 属性 | Timestamp |
対応 |
conversionAttributionType |
コンバージョンの関連付けの理由: Visit または Keyword+Ad 。 |
属性 | Conversion attribution type |
対応 |
conversionVisitId |
コンバージョンを関連付ける DS 訪問 ID。 | 属性 | ID |
対応 |
conversionVisitTimestamp |
コンバージョンに貢献した訪問の UTC タイムスタンプ。 | 属性 | Timestamp |
対応 |
conversionVisitExternalClickId |
コンバージョンに関連付けられた訪問用の一意の文字列で、gclid URL パラメータとしてランディング ページに渡されます。コンバージョン API または Google アナリティクスを統合している広告主様のみ有効です。 | 属性 | String |
対応 |
conversionSearchTerm |
コンバージョンにつながった検索語句。 | 属性 | String |
対応 |
floodlightOriginalRevenue |
Floodlight 通貨処理を変更する前の、Floodlight イベントに関連付けられた元の変更されていない収益(現在のレポートの通貨)。 | 属性 | Money |
対応 |
floodlightEventRequestString |
コンバージョンの Floodlight リクエスト文字列。 | 属性 | String |
対応 |
floodlightReferrer |
コンバージョンの Floodlight リファラーのウェブサイト。 | 属性 | String |
対応 |
floodlightOrderId |
広告主がコンバージョンに提供する Floodlight オーダー ID。 | 属性 | String |
対応 |
feedItemId |
このコンバージョンに関連付けられたフィード アイテムの行の ID。 | 属性 | ID |
対応 |
feedId |
このコンバージョンに関連付けられたフィード テーブルの ID。 | 属性 | ID |
対応 |
feedType |
このコンバージョンに関連付けられているフィードのタイプ。 | 属性 | Feed type |
対応 |