コンバージョンに関する未加工のイベントデータ。
このレポートを返すことができるのは、非同期リクエスト( 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 に誤りがあったりすると、指標を広告に関連付けることができなくなります。 | 属性 | Boolean |
○ |
inventoryAccountId |
コンバージョンに関連付けられた商品を含む DS 在庫アカウント ID。DS で在庫アカウントをリンクすると、この ID が生成されます。 | 属性 | 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 |
コンバージョンが発生した日付(キャンペーン マネージャー ネットワークのタイムゾーンを使用)。この日付はコンバージョン指標の集計に使用されます。たとえば、DS で 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 |
○ |