このガイドは、カスタマー マッチの統合で発生する可能性のある低い一致率や一般的なエラーのトラブルシューティングに役立ちます。
マッチ率を検証する
照合率の検証を試みる前に、アップロード ジョブが完了していることを確認してください。
マッチ率が予想よりも低くなる原因はいくつか考えられます。たとえば、次のような原因が考えられます。
- データがアップロード前にハッシュ化されていませんでした。
- データがハッシュ化される前に、正しい形式でフォーマットされていませんでした。
- 別のシステムの照合率と比較している。
- 1 つの
UserIdentifierオブジェクトに複数のユーザー識別子を追加しようとしています。代わりに、このコード例に示すように、複数のUserIdentifierオブジェクトを 1 つのUserDataオブジェクトに追加します。
ユーザーが Google 検索、Gmail、YouTube でどの程度アクティブであるかに応じて、広告主様はリストの 1 ～ 99% のユーザーにリーチできます。一致率が低い場合のトラブルシューティングについて詳しくは、ヘルプセンターをご覧ください。
一致率とリストサイズの相違点
リストサイズとマッチ率は異なる値を反映します。一致率は、カスタマー マッチ リストで実際にリーチできないユーザーも含め、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 の上限と割り当てに関するベスト プラクティス ガイドもご覧ください。 |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE
|
このエラーは、2025 年 10 月 1 日から 2026 年 3 月 31 日までの間に Google Cloud プロジェクト（または以前のデベロッパー トークン。2026 年 9 月 9 日に非推奨）で顧客照合リクエストがなかった場合に発生します。代わりに、カスタマー マッチのワークフローに Data Manager API を使用する必要があります。 |
その他のトラブルシューティング サポート
上記の手順を試しても問題が解決しない場合は、カスタマー マッチのトラブルシューティング ツールからお問い合わせください。