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

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

マッチ率を確認する

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

以下のような理由により、一致率が想定よりも低くなることがあります。

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

  • データがハッシュ化される前に正しい形式にフォーマットされていなかった。

  • 別のシステムの一致率と比較している。

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

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

マッチ率とリストサイズの違い

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

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

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

その他のトラブルシューティング サポート

それでも問題が解決しない場合は、カスタマー マッチのトラブルシューティングから Google にお問い合わせください。