従来版の Search Ads 360 Reporting API は、2024 年 6 月 30 日に廃止され、廃止されます。なお、Search Ads 360 Conversion API は影響を受けず、引き続きサポートされます。新しいレポートの作成には、必ず新しい Search Ads 360 Reporting API を使用してください。

2024 年 4 月以降、レポートをリクエストすると、unsupportedApiVersion エラーが返されます。詳しくはこちらをご覧ください。

また、既存の検索広告 360 の実装を新しい API に移行することを強くおすすめします。詳しくは、新しい Search Ads 360 Reporting API のスタートガイドと移行ガイドをご覧ください。

このページは Cloud Translation API によって翻訳されました。

レポートタイプ: コンバージョン

コンバージョンに関する元のイベントデータ。

このレポートは、非同期リクエスト（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`	対応