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。 - 元のイベントと同じリンク先とコンバージョン アクション。
- 調整するフィールドの更新後の値。
- イベントに必要なすべてのフィールド。
adIdentifiersやuserDataなどの識別子が少なくとも 1 つ含まれている必要があります。オフライン コンバージョンまたはマルチソース コンバージョンのイベントと識別子の要件を確認します。
元のイベントで送信またはキャプチャしたのと同じ識別子を送信することをおすすめします。transactionId が既存のコンバージョンと一致しない場合、Google 広告はこれらの識別子を使用して新しいコンバージョンを関連付けます。
調整タイプを指定する必要はありません。Data Manager API は、transactionId と指定されたフィールドに基づいてリクエストの処理方法を推測します。
取り込みリクエストの送信について詳しくは、オフライン コンバージョンまたはマルチソース コンバージョンのイベント送信ガイドをご覧ください。
サポートされるフィールド
次の表に、イベントが既存のコンバージョンと一致する場合に、Google 広告が各フィールドをどのように適用するかを示します。
| フィールド | 動作 |
|---|---|
conversionValue、currency |
上書きされる。新しい値が記録された値に置き換わります。 |
userData |
元のイベントにユーザーデータがなかった場合は補完され、それ以外の場合は無視されます。 |
その他のすべてのフィールド（adIdentifiers.gclid など） |
更新されていません。Google 広告では、元のイベントで記録された値が保持されます。必須フィールドは引き続き存在する必要があります。 |
コンバージョン値
新しい conversionValue と currency を送信して、記録されたコンバージョンの値を修正します。新しい値は、コンバージョン数を増やすことなく、レポートと入札で以前に記録された値をオーバーライドします。
ユーザーデータ
メールアドレスや電話番号などの userData は、Google 広告で次のように処理されます。
不足分を補完: 元のイベントがユーザーデータなしで取得された場合、調整によってユーザーデータが追加され、アトリビューションが改善されます。
存在する場合は無視: Google タグまたは以前のアップロードでユーザーデータがすでにキャプチャされている場合、新しいユーザーデータは無視されます。既存のユーザーデータは上書きされず、追加もされません。
その他のフィールド
一致したイベントのコンバージョン値、通貨、ユーザーデータ以外の識別子とメタデータ（adIdentifiers.gclid など）は更新できません。Google 広告では、元のイベントで記録された値が保持されます。
ただし、少なくとも 1 つの識別子など、必須のフィールドは含める必要があります。Data Manager API は、イベントごとに検証します。
一致しないイベント
transactionId が既存のイベントと一致しない場合、リクエストは調整ではなく、新しいコンバージョンのアップロードとして処理されます。
Google 広告は、提供された識別子（adIdentifiers.gclid や userData など）を使用して、新しいコンバージョンを広告クリックに関連付けようとします。