IngestEvents メソッドを使用して、以前に記録された Google 広告のコンバージョンを調整します。Data Manager API では、調整によってコンバージョン値を修正したり、ユーザーデータを補完したりできます。
Google Ads API から移行する場合は、Google Ads API からアップグレードするで、各 API での調整の処理方法を比較してください。
サポートされているコンバージョンの種類
次の Google 広告のコンバージョン タイプを調整できます。
- マルチソースのコンバージョン:
WEBSITEコンバージョン アクションについて、ウェブサイトの Google タグによって記録されたコンバージョン。 - オフライン コンバージョンとリードの拡張コンバージョン: 以前に
UPLOAD_CLICKSコンバージョン アクション用にアップロードされたオフライン イベント。
調整の仕組み
同じコンバージョン アクション内で、Google 広告は transactionId を使用してイベントを照合します。
transactionIdが同じコンバージョン アクションの既存のコンバージョンと一致する場合、Data Manager API はリクエストをコンバージョン調整として扱います。transactionIdが既存のコンバージョンと一致しない場合、Google 広告は新しいコンバージョンを作成します。一致しないイベントをご覧ください。
調整を送信する
既存のコンバージョンを調整するには、次のものを含む IngestEvents リクエストを送信します。
- 元のイベントと同じ
transactionId。 - 元のイベントと同じ目標とコンバージョン アクション。
- 調整するフィールドの更新された値。
調整タイプを指定する必要はありません。Data Manager API は、transactionId と指定したフィールドに基づいてリクエストの処理方法を推測します。
取り込みリクエストの送信について詳しくは、イベントを送信するをご覧ください。
サポートされるフィールド
次の表に、調整できるフィールドと更新の適用方法を示します。
| フィールド | 動作 |
|---|---|
conversionValue、currency |
上書き。新しい値は記録された値を置き換えます。 |
userData |
元のイベントにユーザーデータがない場合は補完、それ以外の場合は無視されます。 |
adIdentifiers.gclid などの他のフィールドはすべて省略可能です。 |
無視 |
コンバージョン値
新しい conversionValue と currency を送信して、記録されたコンバージョンの値を修正します。新しい値は、コンバージョン数を増やすことなく、レポートと入札で以前に記録された値をオーバーライドします。
ユーザーデータ
Google 広告での userData（メールアドレスや電話番号など）の取り扱いは次のとおりです。
不足分を補完: 元のイベントがユーザーデータなしで取得された場合、調整によってユーザーデータが追加され、アトリビューションが改善されます。
存在する場合は無視: Google タグまたは以前のアップロードですでにユーザーデータが取得されている場合、新しいユーザーデータは無視されます。既存のユーザーデータは上書きも追加もされません。
その他のフィールド
adIdentifiers.gclid などのコンバージョン値、通貨、ユーザーデータ以外の識別子とメタデータは、照合されたイベントで更新できません。Google 広告ではこれらのフィールドは無視され、元のイベントで記録された値が保持されます。
一致しないイベント
transactionId が既存のイベントと一致しない場合、リクエストは調整ではなく新しいコンバージョンのアップロードとして扱われます。
Google 広告は、提供された識別子（adIdentifiers.gclid や userData など）を使用して、新しいコンバージョンを広告クリックに関連付けようとします。