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 広告のコンバージョン顧客の親または子孫であるアカウント。
データ マネージャー 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 エラーを返しません。 - リクエストで調整タイプを指定する必要はありません。データ マネージャー API は、イベントで指定されたフィールドに基づいて調整の処理方法を推測します。
- Google Ads API とは異なり、Data Manager API ではコンバージョンの撤回はサポートされていません。コンバージョンの撤回では、コンバージョン値とコンバージョン数を
0に設定することで、以前に記録されたコンバージョンが完全に削除されます。コンバージョン値を修正できますが、コンバージョン数は変更されません。
詳しくは、コンバージョンの調整をご覧ください。