고객 목록 관련 문제 해결
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 가이드를 사용하여 고객 일치 타겟팅 통합에서 발생할 수 있는 낮은 일치율과 일반적인 오류를 해결하세요.
일치율 검증
일치율을 검증하기 전에 업로드 작업이 완료되었는지 확인하세요.
다음과 같은 여러 가지 이유로 일치율이 예상보다 낮을 수 있습니다.
데이터가 업로드되기 전에 해싱되지 않았습니다.
데이터가 해싱되기 전에 형식이 올바르게 지정되지 않았습니다.
다른 시스템의 일치율과 비교하고 있습니다.
단일 UserIdentifier 객체에 여러 사용자 식별자를 추가하려고 합니다. 대신 이 코드 예시와 같이 단일 UserData 객체에 여러 UserIdentifier를 추가하세요.
광고주는 Google 검색, Gmail 또는 YouTube에서 사용자의 활동 수준에 따라 목록의 1% 에서 99% 까지 도달할 수 있습니다. 낮은 일치율 문제 해결에 관한 자세한 가이드는 고객센터를 참고하세요.
일치율과 목록 크기의 차이
목록 크기와 매치율은 서로 다른 값을 반영합니다. 일치율은 고객 일치 타겟팅 목록으로 실제로 도달할 수 없는 사용자도 포함하여 Google 계정이 있는 모든 사용자를 집계합니다. 목록 크기는 Google 계정과 일치하고 Google Ads 맞춤설정으로 도달할 수 있는 활성 사용자를 집계합니다.
일반적인 오류 디버그
추가 문제 해결 지원
그래도 문제가 해결되지 않으면 고객 일치 타겟팅 문제 해결 도구를 통해 문의해 주세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-09-05(UTC)
[null,null,["최종 업데이트: 2025-09-05(UTC)"],[[["\u003cp\u003eThis guide helps you troubleshoot low Customer Match rates and debug common errors during integration.\u003c/p\u003e\n"],["\u003cp\u003eLow match rates can stem from data formatting issues, hashing problems, or comparing against different systems.\u003c/p\u003e\n"],["\u003cp\u003eMatch rate and list size differ: match rate includes all matched Google Accounts, while list size only includes active, reachable users.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors like permission issues, conflicting operations, and exceeding user identifier limits are addressed with solutions.\u003c/p\u003e\n"],["\u003cp\u003eFor persistent issues, consult the Customer Match troubleshooter or Help Center for detailed guidance.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot customer list issues\n\nUse this guide to help you troubleshoot low match rates and common errors that\nmight come up in your Customer Match integration.\n\nValidate match rate\n-------------------\n\nEnsure that your upload job has completed before attempting to validate your\nmatch rate.\n\nYour match rate might be lower than expected for a number of reasons, including:\n\n- The data was not hashed before it was uploaded.\n\n- The data was not correctly formatted before it was hashed.\n\n- You are comparing against match rates in a different system.\n\n- You are trying to add multiple user identifiers to a single `UserIdentifier`\n object. Instead, add multiple `UserIdentifier`s to a single `UserData`\n object as shown in this\n [code example](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#code_example).\n\nIt's possible for an advertiser to reach anywhere from 1% to 99% of their list,\nbased on how active their users are on Google Search, Gmail, or YouTube. For a\nmore detailed guide on troubleshooting low match rates, visit the [Help\nCenter](//support.google.com/google-ads/answer/7474166).\n\n### Differences between match rate and list size\n\nNote that list size and match rate reflect different values. Match rate\ncounts all users with a Google Account even if they are not actually able to be\nreached with the Customer Match list. List size counts\n[active](//support.google.com/google-ads/answer/7474166?#zippy=%2Ctroubleshoot-low-traffic)\nusers that matched a Google Account and are able to be reached by Ads\npersonalization.\n\nDebug common errors\n-------------------\n\n| Error ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [`USER_PERMISSION_DENIED`](/google-ads/api/reference/rpc/v21/AuthorizationErrorEnum.AuthorizationError#user_permission_denied) | You might run into permissions errors if you attempt to modify a list that was created by another account. You can only edit a list that your own account created. |\n| [`EXTERNAL_UPDATE_ID_ALREADY_EXISTS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#external_update_id_already_exists) | This error can occur if you attempt to create multiple jobs with the same [`external_id`](/google-ads/api/reference/rpc/v21/OfflineUserDataJob#external_id). |\n| [`CONFLICTING_OPERATION`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#conflicting_operation) | This error can occur if `remove` operations are mixed with `create` operations in a single job. |\n| [`TOO_MANY_USER_IDENTIFIERS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#too_many_user_identifiers) | The `create` operations in a single job contain more than 100,000 `user_identifiers` in total. Split the request into multiple requests that don't exceed that limit. |\n| [`CONCURRENT_MODIFICATION`](/google-ads/api/reference/rpc/v21/DatabaseErrorEnum.DatabaseError#concurrent_modification) | This error can occur if you try to operate on the same list at the same time. |\n| [`RESOURCE_EXHAUSTED`](/google-ads/api/reference/rpc/v21/QuotaErrorEnum.QuotaError#resource_exhausted) | This error can occur if you try to send too many requests. You can mitigate this by batching your operations as per the recommended [usage flow](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#usage-flow). You can also refer to the best practices guide for [API limits and quotas](/google-ads/api/docs/best-practices/quotas). |\n\nAdditional troubleshooting support\n----------------------------------\n\nIf you're still having issues, reach out to us through the Customer Match\n[troubleshooter](//support.google.com/google-ads/troubleshooter/10028577)."]]
