よくある質問

注意すべき制限がいくつかあります。

• 個々の batchinsert リクエストと batchupdate リクエストは、1,000 件のコンバージョンに制限されています。
• 送信時から最大 28 日前までのタイムスタンプのコンバージョンを送信できます。
• コンバージョンを送信できるのは、キャンペーン マネージャー 360 のユーザー プロフィールがアクセス権を持つ Floodlight 設定に対してのみです。

両方のサービスで提供される機能の詳細な比較については、検索広告 360 ヘルプセンターをご覧ください。

同じコンバージョンをキャンペーン マネージャー 360 と検索広告 360 の両方に挿入した場合、エントリの重複除去は行われません。この場合は、別々の Floodlight アクティビティを使用します。

開発効率が向上するほか、さまざまな追加機能を利用できるようになるため、Data Manager API を使用することをおすすめします。

序数値は、重複するコンバージョンの処理方法を指定します。Floodlight アクティビティ、Floodlight 設定 ID、ユーザー ID、コンバージョンのタイムスタンプが同一のコンバージョンが複数存在する場合、序数に基づいて次のことが決定されます。

• コンバージョンの重複が除去され、1 つだけが残ります。これは、すべてのコンバージョンに同じ序数値が設定されている場合に発生します。
• コンバージョンは個別に処理され、すべて保持されます。これは、すべてのコンバージョンに異なる序数値がある場合に発生します。

値自体に意味がある必要はありません。一般に、すべてのコンバージョンに固定値（1 など）を使用すると、重複除去が有効になります。コンバージョンごとにランダムな値または一意の値を使用すると、この機能は無効になります。

batchinsert と batchupdate は、ベスト エフォート ベースでコンバージョンを処理します。バッチ リクエストは HTTP 200 OK レスポンスを返すことができますが、バッチ内の個々のコンバージョンは失敗します。レスポンスの hasFailures を常に確認し、各 ConversionStatus オブジェクトの errors[] リストを検査します。

• INTERNAL（再試行）: コンバージョンの処理中に、Google のシステム内で一時的なエラーが発生しました。コンバージョンは挿入または更新されませんでした。指数バックオフを使用して、失敗したコンバージョンを再試行します（たとえば、数分後に開始し、数時間かけて再試行します）。このとき、ordinal、timestampMicros、floodlightActivityId、ユーザー ID またはクリック ID はまったく同じままにします。
• NOT_FOUND（遅延して再試行）: 識別子（gclid、dclid、matchId、mobileDeviceId）または編集中の既存のコンバージョンがまだ見つかりませんでした。オンライン クリック、Floodlight タグ、コンバージョンの処理とインデックス登録には 1 ～ 2 時間かかることがあるため、NOT_FOUND コンバージョンを定期的に（たとえば、1 ～ 3 時間ごとに、最大 6 時間）再試行します。6 時間経過しても NOT_FOUND が続く場合は、次のセクションで識別子タイプ別の一般的な原因をご覧ください。
• INVALID_ARGUMENT と PERMISSION_DENIED（再試行しない）: コンバージョン データが無効であるか（28 日以上前のコンバージョン タイムスタンプや、形式が正しくないフィールドなど）、ユーザー プロファイルにターゲット Floodlight 設定の権限がありません。根本的な問題を解決せずに、これらの変換を再試行しないでください。

HTTP リクエスト全体が 5xx サーバーエラーまたは 429 割り当て / レート制限エラーで失敗した場合は、指数バックオフを使用してリクエストを再試行します。

安全な再試行と重複除去: INTERNAL または NOT_FOUND で失敗したコンバージョンを再試行する場合（または結果が不明な HTTP 5xx タイムアウトの後）、常にまったく同じ ordinal と timestampMicros を送信します。コンバージョンがすでに記録されている場合、キャンペーン マネージャー 360 は、ordinal、ユーザー識別子、Floodlight アクティビティ、コンバージョン日に基づいて、自動的に重複除去を行います。

このエラーの最も一般的な原因は次のとおりです。

• mobileDeviceId が無効です。
• mobileDeviceId は検索広告 360 で認識されていません。これは、デバイスにキャンペーン マネージャー 360 から広告がまだ配信されていないことを意味します。

このエラーの最も一般的な原因は次のとおりです。

• gclid が無効です。
• gclid が、検索広告 360 キャンペーンまたはディスプレイ＆ビデオ 360 の YouTube 広告申込情報に関連付けられていません。これは、検索広告 360 を経由しない Google 広告のクリック リダイレクト（住所表示オプションのクリックなど）から gclid が収集された場合や、ディスプレイ＆ビデオ 360 の YouTube 広告申込情報に関連付けられていない YouTube 広告のクリック リダイレクトから収集された場合に発生することがあります。
• gclid に関連付けられているクリックが発生してから、かなり時間が経過しています。コンバージョンを挿入できるのは、60 日前までのクリックに対してのみです。
• gclid に関連付けられているクリックの発生が最近すぎます。gclid ベースのコンバージョン アップロードを 1 時間遅らせて、gclid が処理され、マッチングに使用できるようにすることをおすすめします。

このエラーの最も一般的な原因は次のとおりです。

• dclid が無効です。
• dclid に関連付けられているクリックが発生してから、かなり時間が経過しています。コンバージョンを挿入できるのは、発生から 60 日以内のクリックに対してのみです。
• dclid に関連付けられているクリックの発生が最近すぎます。dclid ベースのコンバージョン アップロードを 1 時間遅らせて、dclid が処理され、マッチングに使用できるようにすることをおすすめします。

このエラーの最も一般的な原因は次のとおりです。

• matchId がキャンペーン マネージャー 360 で認識されていません。これは、キャンペーン マネージャー 360 を適切に通過しなかった Floodlight 呼び出しから matchId が収集された場合に発生することがあります（matchId タグ パラメータを含む Floodlight 呼び出しが正しく機能していることを確認してください）。
• matchId に関連付けられた Floodlight 呼び出しに Cookie が含まれていませんでした。Floodlight 呼び出しには、キャンペーン マネージャー 360 が matchId を正しく保存するための Cookie / 識別子が含まれている必要があります（ユーザーが Cookie をブロックしているか、オプトアウトしている可能性があります）。
• matchId に関連付けられた Floodlight 呼び出しが、かなり前に発生しています。オフライン コンバージョンのアップロードは、matchId を含む Floodlight 呼び出しから 60 日以内に行う必要があります。
• matchId に関連付けられた Floodlight 呼び出しが最近発生しました。matchId が処理され、照合に使用できるように、matchId ベースのコンバージョンのアップロードを 2 時間遅らせることをおすすめします。

Floodlight アクティビティの作成前のタイムスタンプが付いたオフライン コンバージョンのアップロードは、送信時から最大 28 日前まで、Floodlight インプレッション、アトリビューションなし/割り当てられたコンバージョンとしてレポートされる可能性があります。ただし、この動作は保証されておらず、信頼すべきではありません。オフライン コンバージョンの最も早いタイムスタンプよりも前に Floodlight アクティビティを作成することをおすすめします。

オーディエンス リストの作成を有効にするには、広告のユーザーデータの同意に加えて、nonPersonalizedAd フィールドを明示的に false に設定する必要があります。