顧客リストに関する問題のトラブルシューティング

このガイドは、カスタマー マッチの統合で発生する可能性のある低い一致率や一般的なエラーのトラブルシューティングに役立ちます。

マッチ率を検証する

一致率の検証を試みる前に、アップロード ジョブが完了していることを確認してください。

マッチ率が想定よりも低い原因としては、次のような理由が考えられます。

  • データがアップロード前にハッシュ化されていません。

  • データがハッシュ化される前に、正しい形式でフォーマットされていませんでした。

  • 別のシステムのマッチ率と比較している。

  • 1 つの UserIdentifier オブジェクトに複数のユーザー識別子を追加しようとしています。代わりに、このコード例に示すように、複数の UserIdentifier を 1 つの UserData オブジェクトに追加します。

広告主様がリストの 1 ～ 99% のユーザーにリーチできるかどうかは、Google 検索、Gmail、YouTube でのユーザーのアクティビティによって異なります。マッチ率が低い場合のトラブルシューティングの詳細なガイドについては、ヘルプセンターをご覧ください。

一致率とリストサイズの違い

リストのサイズとマッチ率は異なる値を反映していることに注意してください。一致率は、カスタマー マッチ リストで実際にリーチできないユーザーであっても、Google アカウントを持つすべてのユーザーをカウントします。リストサイズは、Google アカウントと一致し、広告のパーソナライズでリーチ可能なアクティブ ユーザーの数です。

一般的なエラーをデバッグする

エラー
USER_PERMISSION_DENIED 別のアカウントで作成されたリストを変更しようとすると、権限エラーが発生することがあります。編集できるのは、自分のアカウントで作成したリストのみです。
EXTERNAL_UPDATE_ID_ALREADY_EXISTS このエラーは、同じ external_id を使用して複数のジョブを作成しようとすると発生することがあります。
CONFLICTING_OPERATION このエラーは、1 つのジョブで remove オペレーションと create オペレーションが混在している場合に発生することがあります。
TOO_MANY_USER_IDENTIFIERS 1 つのジョブの create オペレーションの合計 user_identifiers が 100,000 を超えている。リクエストを、その上限を超えない複数のリクエストに分割します。
CONCURRENT_MODIFICATION このエラーは、同じリストを同時に操作しようとすると発生することがあります。
RESOURCE_EXHAUSTED このエラーは、送信するリクエストが多すぎる場合に発生することがあります。この問題を軽減するには、推奨される 使用フローに従ってオペレーションをバッチ処理します。API の上限と割り当てに関するベスト プラクティス ガイドもご覧ください。

追加のトラブルシューティング サポート

上記の手順を試しても問題が解決しない場合は、カスタマー マッチのトラブルシューティング ツールからお問い合わせください。