이 가이드를 사용하여 낮은 일치율과 고객 매치 타겟팅 통합에서 발생할 수 있는 일반적인 오류를 해결하세요.
일치율 확인
일치율을 확인하기 전에 업로드 작업이 완료되었는지 확인하세요.
일치율이 예상보다 낮을 수 있는 이유는 다음과 같습니다.
데이터가 업로드되기 전에 해싱되지 않았습니다.
데이터가 해싱되기 전에 형식이 올바르지 않았습니다.
다른 시스템의 일치율과 비교하고 있습니다.
단일
UserIdentifier객체에 여러 사용자 식별자를 추가하려고 합니다. 대신 이 코드 예와 같이 여러UserIdentifier를 단일UserData객체에 추가하세요.
광고주는 Google 검색, Gmail 또는 YouTube에서 사용자의 활동 수준에 따라 목록의 1% 에서 99% 까지 도달할 수 있습니다. 낮은 일치율 문제 해결에 관한 자세한 가이드는 고객센터를 참고하세요.
일치율과 목록 크기의 차이점
목록 크기와 일치율은 서로 다른 값을 반영합니다. 일치율은 고객 매치 타겟팅 목록으로 실제로 도달할 수 없는 사용자라도 Google 계정이 있는 모든 사용자를 집계합니다. 목록 크기는 활성 사용자를 집계합니다. 이 사용자는 Google 계정과 일치하고 Google Ads 맞춤설정으로 도달할 수 있습니다.
일반적인 오류 디버깅
| 오류 | |
|---|---|
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
|
Google Cloud 프로젝트에서 2026년 4월 1일 이전에 고객 매치 타겟팅 요청을 보낸 적이 없는 경우 이 오류가 발생합니다. 대신 고객 매치 타겟팅 워크플로에 Data Manager API를 사용해야 합니다. |
추가 문제 해결 지원
문제가 계속되면 고객 일치 타겟팅 문제 해결 도구를 통해 문의해 주세요.