従来の Search Ads 360 Reporting API は廃止されました。新しい Search Ads 360 Reporting API を使用してレポートを作成できるようになりました。

なお、Search Ads 360 Conversion API の get メソッドと getByCustomerId メソッドは、2025 年第 3 四半期に非推奨になります。コンバージョンデータを引き続き利用するには、新しい Search Ads 360 Reporting API を使用してコンバージョンリソースを使用してレポートを作成する必要があります。詳しくは、こちらをご覧ください。

残りの検索広告 360 Conversion API 関数は引き続きサポートされます。

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

Conversion: insert

新しいコンバージョンのバッチを DoubleClick Search に挿入します。実習をご覧ください。

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/doubleclicksearch/v2/conversion

承認

このリクエストには、次のスコープによる認証が必要です。

スコープ
`https://www.googleapis.com/auth/doubleclicksearch`

詳細については、認証と認可のページをご覧ください。

リクエスト本文

リクエストの本文には、以下のプロパティを使用してコンバージョンリソースを指定します。

プロパティ名	値	説明
必須プロパティ
`conversion[].conversionId`	`string`	オフラインコンバージョンの場合は、広告主がこの ID を指定します。広告主は、自分にとって意味のある任意の ID を指定できます。リクエストの各コンバージョンには一意の ID を指定する必要があります。また、ID とタイムスタンプの組み合わせは広告主のすべてのコンバージョン間で一意である必要があります。オンラインコンバージョンの場合、広告主の Floodlight 指示に応じて、`dsConversionId` または `floodlightOrderId` がこのプロパティにコピーされます。
`conversion[].conversionTimestamp`	`unsigned long`	コンバージョンが発生した時刻（エポックミリ秒（UTC））。
`conversion[].segmentationType`	`string`	このコンバージョンのセグメントタイプ（例: `FLOODLIGHT`）。指定できる値は次のとおりです。 <ph type="x-smartling-placeholder"> </ph> 「`FLOODLIGHT`」

レスポンス

成功すると、このメソッドはレスポンスの本文でコンバージョンリソースを返します。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。または、スタンドアロンエクスプローラをご覧ください。