이 가이드를 사용하여 고객 매치 타겟팅 통합에서 발생할 수 있는 낮은 일치율 및 일반적인 오류를 해결하세요.
일치율 검증
일치율을 검증하기 전에 업로드 작업이 완료되었는지 확인합니다.
일치율이 예상보다 낮은 이유는 다음과 같습니다.
- 데이터가 업로드되기 전에 해싱되지 않았습니다.
- 해싱 전에 데이터 형식이 올바르게 지정되지 않았습니다.
- 다른 시스템의 일치율과 비교하고 있습니다.
- 단일
UserIdentifier객체에 여러 사용자 식별자를 추가하려고 합니다. 대신 이 코드 예와 같이 단일UserData객체에 여러UserIdentifier객체를 추가하세요.
광고주는 사용자가 Google 검색, Gmail 또는 YouTube에서 얼마나 활발하게 활동하는지에 따라 목록의 1% 에서 99% 까지 도달할 수 있습니다. 낮은 일치율 문제를 해결하는 방법에 관한 자세한 가이드는 고객센터를 참고하세요.
일치율과 목록 크기의 차이점
목록 크기와 일치율은 서로 다른 값을 반영합니다. 일치율은 고객 매치 타겟팅 목록으로 실제로 도달할 수 없는 경우에도 Google 계정이 있는 모든 사용자를 집계합니다. 목록 크기는 Google 계정과 일치하고 광고 개인 최적화를 통해 도달할 수 있는 활성 사용자 수를 집계합니다.
일반적인 오류 디버그
| 오류 | |
|---|---|
USER_PERMISSION_DENIED
|
다른 계정에서 만든 목록을 수정하려고 하면 권한 오류가 발생할 수 있습니다. 내 계정에서 만든 목록만 수정할 수 있습니다. |
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
이 오류는 동일한
external_id로 여러 작업을 만들려고 할 때 발생할 수 있습니다.
|
CONFLICTING_OPERATION
|
이 오류는 단일 작업에서 remove 작업이 create 작업과 혼합된 경우에 발생할 수 있습니다.
|
TOO_MANY_USER_IDENTIFIERS
|
단일 작업의 create 작업에 총 100,000개 이상의 user_identifiers가 포함되어 있습니다. 요청을 이 한도를 초과하지 않는 여러 요청으로 분할합니다.
|
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를 사용해야 합니다. |
추가 문제 해결 지원
문제가 계속되면 고객 매치 타겟팅 문제 해결 도구를 통해 Google에 문의하세요.