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