コンバージョンの調整

IngestEvents メソッドを使用して、以前に記録された Google 広告のコンバージョンを調整します。Data Manager API では、調整によってコンバージョン値を修正したり、ユーザーデータを補完したりできます。

Google Ads API から移行する場合は、Google Ads API からアップグレードするを参照して、各 API での調整の処理方法を比較してください。

サポートされているコンバージョンの種類

次の Google 広告のコンバージョン タイプを調整できます。

調整の仕組み

同じコンバージョン アクション内で、Google 広告は transactionId を使用してイベントを照合します。

  • transactionId が同じコンバージョン アクションの既存のコンバージョンと一致する場合、Data Manager API はリクエストをコンバージョンの調整として扱います。
  • transactionId が既存のコンバージョンと一致しない場合、Google 広告は新しいコンバージョンを作成します。一致しないイベントをご覧ください。

調整を送信する

既存のコンバージョンを調整するには、次の情報を含む IngestEvents リクエストを送信します。

  • 元のイベントと同じ transactionId。
  • 元のイベントと同じ目標とコンバージョン アクション。
  • 調整するフィールドの更新後の値。
  • イベントに必要なすべてのフィールド（adIdentifiers や userData などの識別子を少なくとも 1 つ含む）。オフライン コンバージョンまたはマルチソース コンバージョンのイベントと識別子の要件をご覧ください。

元のイベントで送信または取得したのと同じ識別子を送信することをおすすめします。transactionId が既存のコンバージョンと一致しない場合、Google 広告はこれらの識別子を使用して新しいコンバージョンを割り当てます。

調整タイプを指定する必要はありません。Data Manager API は、transactionId と指定したフィールドに基づいてリクエストの処理方法を推測します。

取り込みリクエストの送信について詳しくは、オフライン コンバージョンまたはマルチソース コンバージョンのイベント送信に関するガイドをご覧ください。

サポートされるフィールド

次の表に、イベントが既存のコンバージョンと一致した場合に Google 広告が各フィールドをどのように適用するかを示します。

フィールド 動作
conversionValue、currency 上書きされます。新しい値は記録された値を置き換えます。
userData 元のイベントにユーザーデータがない場合は補完、それ以外の場合は無視されます。
その他のフィールド（adIdentifiers.gclid など） 更新されていません。Google 広告では、元のイベントで記録された値が保持されます。必須フィールドは引き続き存在する必要があります。

コンバージョン値

新しい conversionValue と currency を送信して、記録されたコンバージョンの値を修正します。新しい値は、コンバージョン数を増やすことなく、レポートと入札で以前に記録された値をオーバーライドします。

ユーザーデータ

Google 広告でメールアドレスや電話番号などの userData を処理する方法は次のとおりです。

  • 不足分を補完: 元のイベントがユーザーデータなしで取得された場合、調整によってユーザーデータが追加され、アトリビューションが改善されます。

  • 存在する場合は無視: Google タグまたは以前のアップロードですでにユーザーデータが取得されている場合、新しいユーザーデータは無視されます。既存のユーザーデータは上書きも追加もされません。

その他のフィールド

adIdentifiers.gclid などのコンバージョン値、通貨、ユーザーデータ以外の識別子とメタデータは、照合されたイベントで更新できません。Google 広告では、元のイベントで記録された値が保持されます。

ただし、必須のフィールド（少なくとも 1 つの識別子など）は引き続き含める必要があります。データマネージャー API は、すべてのイベントに対してこれらを検証します。

一致しないイベント

transactionId が既存のイベントと一致しない場合、リクエストは調整ではなく新しいコンバージョンのアップロードとして扱われます。

Google 広告は、提供された識別子（adIdentifiers.gclid や userData など）を使用して、新しいコンバージョンを広告クリックに関連付けようとします。