Google Ads API から Data Manager API にコンバージョンのアップロードをアップグレードすると、いくつかの改善点と機能を利用できます。
Data Manager API と Google Ads API を使用してコンバージョンを管理する場合の比較は次のとおりです。
| Data Manager API | Google Ads API | |
|---|---|---|
| オフライン コンバージョンとリードの拡張コンバージョンの送信をサポート | サポートされています。 | サポートされています。 |
| タグのコンバージョンの追加データソースとして Google 広告タグのコンバージョンを送信できるようになりました。これにより、広告インタラクション シグナルを最大限に活用し、データと全体的なパフォーマンスを強化できます。 | サポートされています。 | サポートされていません。 |
| データモデル | すべての Google 広告コンバージョンのユースケースとすべての Google 広告サービスにわたる統合データモデル。 | データモデルは Google 広告のユースケース専用であり、ユースケースごとに異なります。 |
| 暗号化 | 暗号化をサポートしている。 | サポートされていません。 |
| 開発者トークン | 不要。 | 必須。 |
| イベントのセッション属性と IP アドレスのアップロードのサポート | すべての API ユーザーが利用可能。 | 特定の API ユーザーのみが利用可能。 |
| コンバージョンの調整 | 統合された IngestEvents メソッドでサポートされています。 |
別途 ConversionAdjustmentUploadService が必要です。 |
| 割り当てと上限 | プロジェクトベースの割り当てとリクエストごとの上限。 | デベロッパーのトークンベースの割り当てとリクエストごとの上限。 |
| エラーモデル | 高速フェイルモデルを使用します。 | 部分的な失敗モデルを使用します。 |
移行先のアカウントの要件の違い
Data Manager API では、宛先の operating_account は Google 広告コンバージョンのお客様である必要があります。これは Google Ads API とは異なります。
Google Ads API では、次のいずれかの customer_id を使用して Google 広告アカウントのコンバージョンを送信できます。
Google 広告コンバージョンのお客様。
Data Manager API はこのアプローチをサポートしています。
Google 広告コンバージョンのお客様の親アカウントまたは子孫アカウント。
Data Manager API はこのアプローチをサポートしていません。Google Ads API でこの動作を利用している場合は、各リンク先の
operating_accountをコンバージョン アクションのオーナーに変更します。これは、Google Ads API リクエストで使用するcustomer_idとは異なる場合があります。
コンバージョンの調整
Data Manager API は、最初のコンバージョンのアップロードとその後のコンバージョン調整を 1 つのメソッドに統合します。
Google Ads API の場合:
- コンバージョンを調整するには、
ConversionAdjustmentUploadServiceで別のUploadConversionAdjustmentsメソッドを使用する必要があります。 - 同じトランザクション ID（
order_id）を持つ同じコンバージョン アクションに対して、標準のUploadClickConversionsメソッドを使用して複数のコンバージョンをアップロードしようとすると、リクエストは失敗します。 - リクエストで
ConversionAdjustmentTypeを指定する必要があります。
Data Manager API の場合:
- コンバージョンのアップロードと調整では、統合された
IngestEventsエンドポイントを使用します。 - 同じコンバージョン アクションに対して既存の
transaction_idを持つイベントをアップロードし、コンバージョン値またはユーザーデータを更新すると、自動的に調整として処理されます。API は重複するトランザクション ID エラーを返しません。 - リクエストに調整タイプは必要ありません。Data Manager API は、イベントで提供されたフィールドに基づいて、調整の処理方法を推測します。
- Google Ads API とは異なり、Data Manager API はコンバージョンの取り消しをサポートしていません。コンバージョンの取り消しとは、コンバージョン値とコンバージョン数を
0に設定して、以前に記録されたコンバージョンを完全に削除することです。コンバージョンの値を修正することはできますが、コンバージョン数は変わりません。
詳しくは、コンバージョンの調整をご覧ください。