このガイドでは、カスタマー マッチの統合で発生する可能性のあるマッチ率の低下や一般的なエラーのトラブルシューティングについて説明します。
マッチ率を確認する
マッチ率を確認する前に、アップロード ジョブが完了していることを確認してください。
マッチ率が想定よりも低くなる原因としては、次のようなことが考えられます。
データがアップロード前にハッシュ化されていない。
データがハッシュ化される前に正しくフォーマットされていない。
別のシステムのマッチ率と比較している。
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
|
デベロッパー トークンが 2026 年 4 月 1 日より前にカスタマー マッチ リクエストを送信していない場合、このエラーが発生します。代わりに、カスタマー マッチ ワークフローに Data Manager API を使用する必要があります。 |
その他のトラブルシューティング サポート
上記の手順を試しても事象が解決しない場合は、カスタマー マッチ のトラブルシューティング ツールからお問い合わせください。