コンバージョンに関する元のイベントデータ。
このレポートは、非同期リクエスト（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 |
動的検索広告キャンペーン 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 |
データ ソースの広告 ID。値 0 は、広告が関連付けられていないことを示します。 | 属性 | ID |
はい |
isUnattributedAd |
この行の指標が特定の広告に起因するものかどうかを示します。たとえば、サポートされていないフォーマットの広告や誤ったクリックサーバー URL の広告では、DS が広告に指標をアトリビューションできない場合があります。 | 属性 | Boolean |
はい |
inventoryAccountId |
コンバージョンに関連付けられている商品を含む DS 在庫アカウント ID。この ID は、DS で在庫アカウントをリンクしたときに、DS によって生成されます。 | 属性 | ID |
はい |
productId |
このコンバージョンに関連付けられている商品の ID。 | 属性 | String |
はい |
productCountry |
このコンバージョンに関連付けられている商品を含む在庫フィードに登録されている国（ISO 3166 形式）。 | 属性 | String |
はい |
productLanguage |
このコンバージョンに関連付けられている商品の言語（ISO 639-1）。 | 属性 | String |
はい |
productStoreId |
コンバージョンに関連付けられたローカル在庫広告の店舗。この ID はローカル商品フィードで使用されているストア ID と一致する必要があります。 | 属性 | String |
はい |
productChannel |
コンバージョンに関連付けられている商品の販売チャネル: Online または Local。 |
属性 | Product channel |
はい |
conversionId |
検索広告 360 がコンバージョンごとに生成する ID。 | 属性 | ID |
はい |
advertiserConversionId |
オフライン コンバージョンの場合は、広告主が提供する ID です。このような ID が広告主から指定されていない場合、検索広告 360 によって生成されます。オンライン コンバージョンの場合は、広告主の 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 パラメータとしてランディング ページに渡されます。Conversion 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 |
はい |