이 가이드를 사용하여 고객 매치 타겟팅 통합에서 발생할 수 있는 낮은 일치율과 일반적인 오류를 해결하세요.
일치율 검증
일치율을 검증하기 전에 업로드 작업이 완료되었는지 확인하세요.
다음과 같은 여러 가지 이유로 일치율이 예상보다 낮을 수 있습니다.
- 데이터가 업로드되기 전에 해싱되지 않았습니다.
- 데이터가 해싱되기 전에 형식이 올바르게 지정되지 않았습니다.
- 다른 시스템의 일치율과 비교하고 있습니다.
- 단일
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를 사용해야 합니다. |
추가 문제 해결 지원
그래도 문제가 계속되면 고객 일치 타겟팅 문제 해결 도구를 통해 문의해 주세요.