Data Manager API を使用して、Google 広告のオフライン コンバージョンまたはリードの拡張コンバージョンのイベントデータを送信します。
Google Ads API からアップグレードする場合は、Google Ads API からのアップグレードをご覧ください。
ワークフローの概要
Data Manager API を使用してイベントデータを送信する手順は次のとおりです。
宛先を準備する: 取り込みリクエストの
destinationsフィールドにDestinationオブジェクトを定義して、ターゲット アカウントとコンバージョンまたはイベントの宛先を指定します。詳しくは、宛先を準備するをご覧ください。イベントデータと識別子を準備する:
Eventフィールドに、イベントの詳細と必要な識別子(広告クリック、クライアント、アプリ インスタンスの識別子など)を入力します。userDataにユーザーの連絡先情報を含める場合は、フォーマット ガイドラインに沿って識別子を正規化して SHA-256 ハッシュ化し、必要に応じて暗号化します。詳細については、イベントデータの準備をご覧ください。取り込みリクエストを作成して送信する:
destinations、Eventレコード、userDataを暗号化した場合はencryptionInfoを含むevents.ingestリクエストを送信します。validateOnly: trueを使用して、本番環境データを送信する前に、高速失敗エラーのペイロードをテストします。フィールドの要件とコードサンプルについては、イベントを送信するをご覧ください。診断を確認してコンバージョンを調整する:
requestStatus.retrieveを使用して非同期処理の診断を取得し、必要に応じて以前に記録されたコンバージョンを調整または取り消します。