このガイドでは、カスタマー マッチの統合で発生する可能性のあるマッチ率の低下や一般的なエラーのトラブルシューティングについて説明します。
マッチ率を確認する
マッチ率を確認する前に、アップロード ジョブが完了していることを確認してください。
マッチ率が想定よりも低くなる原因はいくつか考えられます。たとえば、次のような原因が考えられます。
データがアップロード前にハッシュ化されていない。
データがハッシュ化される前に正しくフォーマットされていない。
別のシステムのマッチ率と比較している。
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 オペレーションに、合計で 100,000 個を超える user_identifiers が含まれています。リクエストを、この上限を超えない複数のリクエストに分割してください。 |
CONCURRENT_MODIFICATION
|
同じリストに対して同時に操作しようとすると、このエラーが発生することがあります。 |
RESOURCE_EXHAUSTED
|
リクエストを送信しすぎると、このエラーが発生することがあります。推奨される 使用フローに従ってオペレーションをバッチ処理することで、この問題を軽減 できます。API の上限と割り当てに関するベスト プラクティス ガイドもご覧ください。 |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE
|
Google Cloud プロジェクトで 2026 年 4 月 1 日より前に カスタマー マッチ リクエストが送信されていない場合、このエラーが発生します。カスタマー マッチのワークフローには Data Manager API を使用する必要があります。 |
その他のトラブルシューティング サポート
上記の手順を試しても事象が解決しない場合は、カスタマー マッチ のトラブルシューティング ツールからお問い合わせください。