문제 해결

전환을 관리하려면 복잡한 통합이 필요하며, 여기에는 상호 의존적인 여러 도구와 프로세스가 포함되는 경우가 많습니다. 이 가이드에서는 API에서 이해할 수 없는 오류가 발생하거나 UI에 표시되는 측정항목 또는 진단에 혼동이 있는 경우 문제를 해결하기 위해 취할 수 있는 자세한 단계를 제공합니다.

중요: API에서 가져오기 응답이 성공했다고 해서 반드시 전환이 기여 분석되었다는 의미는 아닙니다. 가져오기 성공 후 데이터 불일치에 대한 자세한 내용은 업로드 성공 후 데이터 불일치를 참고하세요.

Google Ads UI에서 측정항목 읽기

Google Ads UI는 가져오기 날짜별로 전환 측정항목을 구성하지 않으므로 UI의 캠페인 보고서를 사용하여 가져오기 결과를 확인하면 오해의 소지가 있을 수 있습니다. API 요청 수준 가져오기 상태를 확인하려면 오프라인 데이터 진단부터 시작하세요. 오프라인 데이터 진단은 향상된 전환의 비동기 태그 일치 또는 사용자 식별자 품질을 평가하지 않습니다. 일치 상태를 확인하려면 Google Ads UI 진단 보고서에서 리드 확보용 향상된 전환 및 웹용 향상된 전환을 확인하세요. 문제 해결 단계는 API 업로드 성공 후 UI 진단 알림을 참조하세요.

리드 확보용 향상된 전환 관련 문제

이 섹션에서는 리드 확보용 향상된 전환을 가져오는 동안 발생하는 일반적인 문제를 해결하는 방법을 중점적으로 설명합니다.

일반적인 오류

다음 안내는 리드 확보용 향상된 전환의 일반적인 오류를 진단하고 해결하는 데 도움이 됩니다.

오류
NO_CONVERSION_ACTION_FOUND	지정된 전환 액션이 사용 설정되지 않았거나 요청의 customer_id 필드에 있는 계정에서 액세스할 수 없습니다. 업로드의 전환 액션이 사용 설정되어 있고 소유자가 클릭의 Google Ads 전환 고객이거나 업로드 계정의 전환 추적 계층 구조에 있는 계정인지 확인합니다. 요청의 GCLID가 요청에 지정된 전환 액션에 액세스할 수 없는 고객 계정에 속하는 경우에도 이 오류가 발생할 수 있습니다. click_view 리소스를 사용하여 GCLID가 고객 계정에 속하는지 확인할 수 있습니다. 이때 click_view.gclid 및 segments.date로 필터링하는 쿼리를 제출합니다. 여기서 날짜는 클릭이 발생한 날짜입니다.
INVALID_CONVERSION_ACTION_TYPE	지정된 전환 액션에 리드 확보용 향상된 전환에 유효하지 않은 유형이 있습니다. 업로드 요청에 지정된 ConversionAction의 유형이 UPLOAD_CLICKS인지 확인합니다.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	전환 설정에서 리드 확보용 향상된 전환을 사용 설정했는지 확인합니다. 이에 관한 안내는 기본 요건 가이드를 참고하세요.
DUPLICATE_ORDER_ID	가져온 이벤트에 주문 ID가 동일한 전환이 여러 개 포함되어 있어 처리되지 않았습니다. 주문 ID가 고유한지 확인한 후 다시 시도해 주세요.
CLICK_NOT_FOUND	제공된 사용자 식별자와 일치하는 클릭이 없습니다. 참고: 대부분의 전환에서 발생하지 않는 한 이 오류는 경고로 취급하세요. 전환에 이 경고가 발생하면 Google Ads API가 오프라인 데이터 진단의 successful_event_count에 이를 포함합니다. Google Ads API에는 alerts 컬렉션에 CLICK_NOT_FOUND 항목이 포함되어 있으므로 이 경고의 빈도를 모니터링할 수 있습니다. Google Ads 캠페인에서 발생한 클릭이 아닌 경우 이 오류가 발생할 수 있습니다. 예를 들어 SA360 또는 DV360에서 가져올 수 있습니다. 다른 가능한 원인은 다음과 같습니다. 업로드하는 고객이 Google Ads 전환 고객과 다릅니다. 리드 양식에 태그 지정이 올바르게 구성되지 않았습니다. 업로드된 데이터가 올바르게 정규화 및 해싱되지 않았습니다. 업로드하는 고객이 Google Ads 전환 고객과 다른 드문 경우, 이 오류는 업로드하는 고객이 고객 데이터 약관에 동의했지만 게재하는 고객은 동의하지 않았음을 의미할 수 있습니다. customer 리소스를 쿼리하고 customer.conversion_tracking_setting.accepted_customer_data_terms 필드를 확인하여 계정이 고객 데이터 약관에 동의했는지 확인할 수 있습니다.

측정항목의 불일치

다음과 같은 일반적인 문제에 유의하세요.

• 전환은 다양한 이유로 처리 파이프라인에서 삭제될 수 있으며, 이러한 전환은 복구할 수 없습니다. 자세한 내용은 업로드 성공 후 데이터 불일치를 참고하세요.

• Google 태그가 웹페이지에 올바르게 설정되어 있고 리드 양식 제출 시 실행되는지 다시 한번 확인합니다. 양식 제출 시 태그가 실행되지 않거나 잘못된 데이터가 전송되는 경우 업로드된 전환의 기여도가 낮거나 없을 수 있습니다. 리드 확보용 향상된 전환을 위해 Google 태그를 구성하고 Google 태그 관리자를 구성하는 방법에 관한 고객센터 도움말을 검토하세요.

• 웹페이지에 Google 태그를 사용하지 않고 리드 확보용 향상된 전환을 사용하는 경우 각 전환에 ClickConversion.gclid 필드를 설정하여 전환 가져오기에 GCLID를 포함해야 합니다.

• 업로드 시 동의를 올바르게 지정하고 있는지 확인합니다. 이렇게 하려면 계정의 기본 동의 설정을 지정하거나(Google Ads UI에서 도구 > 데이터 관리 도구 > 동의 설정 클릭) 업로드된 각 전환에 ClickConversion.consent 필드를 설정하면 됩니다.

캠페인 실적 문제

전환을 업로드하는 데 기술적인 문제가 없고 표시되는 측정항목에 만족하지만 리드 확보용 향상된 전환을 구현한 후 예상되는 캠페인 실적 개선 또는 '상승'이 표시되지 않는 경우 Google Ads 제품 지원팀에 문의하여 도움을 받으세요.

웹용 향상된 전환 관련 문제

이 섹션에서는 웹용 향상된 전환을 가져오는 동안 발생하는 일반적인 문제를 해결하는 방법을 중점적으로 설명합니다.

일반적인 오류

다음 안내는 웹용 향상된 전환의 일반적인 오류를 진단하고 해결하는 데 도움이 됩니다.

오류
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	요청의 customer_id에 대해 고객 데이터 이용약관에 동의하지 않았습니다. 이에 관한 안내는 기본 요건 가이드에서 확인할 수 있습니다.
CONVERSION_ALREADY_ENHANCED	이 전환은 이미 지정된 order_id 및 conversion_action 필드로 ENHANCEMENT 조정을 받았습니다. 각 전환에 고유한 order_id 값을 제공해야 합니다.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	제공된 conversion_action은 웹용 향상된 전환에 사용할 수 없습니다. Google Ads UI에서 요청에 참조된 전환 액션의 향상된 전환 사용 설정 체크박스를 선택해야 합니다. 이에 관한 안내는 고객센터에서 확인하세요.
INVALID_USER_IDENTIFIER	해싱된 사용자 식별자 필드(hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name 또는 hashed_street_address)가 유효한 64자 16진수 SHA-256 다이제스트가 아닙니다. 사용자 제공 데이터를 가져오기 전에 정규화하고 해싱합니다. 자세한 내용은 사용자 제공 데이터 정규화 및 해싱을 참고하세요.
CONVERSION_NOT_FOUND	Google Ads에서 제공된 conversion_action 필드 및 전환 식별자(order_id 또는 gclid_date_time_pair)와 일치하는 전환을 찾을 수 없습니다. 이 오류는 RESTATEMENT 및 RETRACTION 조정에만 적용됩니다. 자세한 내용은 전환 조정 가져오기 요구사항을 참고하세요. ENHANCEMENT 조정의 경우 API는 CONVERSION_NOT_FOUND 오류를 반환하지 않고 요청을 수락하고 태그-API order_id 일치를 비동기식으로 평가합니다. 일치하지 않는 order_id 값의 비율이 높으면 Google Ads UI의 향상된 전환 진단 보고서에서 주문 ID 불일치 알림이 트리거됩니다. 문제 해결 단계는 API 업로드 성공 후 UI 진단 알림을 참고하세요.

API 업로드 성공 후 UI 진단 알림

ConversionAdjustmentUploadService 서비스를 사용하여 ENHANCEMENT 조정을 업로드하면 API는 수집 시 요청 형식의 유효성을 검사하고 웹사이트 태그 이벤트에 대한 개선사항을 비동기식으로 일치시킵니다. 따라서 API 요청은 partial_failure_error 필드에 오류 없이 성공하고 오프라인 데이터 진단에 EXCELLENT 상태를 표시할 수 있습니다. 동시에 Google Ads UI의 향상된 전환 진단 보고서에는 여전히 알림이 표시될 수 있습니다.

API 업로드가 성공한 후 UI 진단 알림이 표시되면 다음 원인을 확인하세요.

• 필수 주소 필드 누락: address_info 필드의 OfflineUserAddressInfo 객체에는 동일한 항목에 hashed_first_name, hashed_last_name, country_code, postal_code의 4개 필드가 필요합니다. hashed_street_address, city, state 필드는 선택사항입니다. hashed_street_address 필드를 채우는 경우에도 유효한 64자 SHA-256 16진수 다이제스트여야 합니다. API는 partial_failure_error 필드에서 오류를 반환하지 않고 비어 있지 않은 부분 address_info 객체(예: 이름과 성만)를 허용합니다. 그러나 다운스트림 일치는 불완전한 주소를 삭제하고 누락된 주소 필드에 대한 알림을 트리거합니다. 필수 입력란 4개 중 하나라도 사용할 수 없는 경우 address_info 필드의 UserIdentifier 객체를 생략합니다.

• 웹사이트 태그 이벤트에 거래 ID가 누락됨: API의 ENHANCEMENT 조정에서 order_id 필드를 생략하면 동기식 FieldError.REQUIRED 오류가 반환됩니다. API 요청에 order_id 필드가 포함된 경우 전환 이벤트에서 거래 ID가 누락됨에 대한 UI 알림은 웹사이트 태그를 참조합니다. 이 알림은 웹사이트 전환 태그 이벤트의 90% 미만에 유효한 거래 ID가 포함된 경우(또는 태그가 "undefined" 또는 "null"와 같은 자리표시자 문자열을 전송하는 경우)에 표시됩니다. 모든 전환 이벤트에 대해 고유한 거래 ID를 전송하도록 웹사이트 전환 태그를 구성하세요.

• 태그와 API의 주문 ID 불일치 또는 지연 업로드: ENHANCEMENT 조정의 경우 API는 업로드 시 CONVERSION_NOT_FOUND 또는 CONVERSION_EXPIRED 오류를 반환하지 않습니다. 대신 일치하지 않는 order_id 값은 UI에서 주문 ID 불일치 알림을 트리거하고, 전환 후 24시간이 지나 업로드된 개선사항은 지연 업로드 알림을 트리거합니다. API order_id 필드를 웹사이트 전환 태그에서 전송한 정확한 거래 ID 문자열과 일치시키고 전환 이벤트 후 24시간 이내에 보강 데이터를 업로드합니다.

• 업로드 전에 해싱된 정규화되지 않은 사용자 데이터: 대문자, 선행 또는 후행 공백, E.164 형식이 아닌 전화번호와 같은 정규화되지 않은 값을 해싱해도 유효한 64자 SHA-256 16진수 다이제스트가 생성됩니다. API는 INVALID_USER_IDENTIFIER 오류를 반환하지 않고 업로드를 수락하지만 다운스트림 일치가 실패하고 형식 지정 또는 낮은 일치율 알림을 보고합니다. 사용자 제공 데이터 정규화 및 해싱의 정규화 규칙을 따릅니다.

• 웹사이트 태그 수에 비해 API 보정 수가 적음: UI 진단은 사용자 식별자가 포함된 중복 삭제된 API 보정을 중복 삭제되고 동의한 웹사이트 태그 이벤트와 비교합니다.

  • 동의 모드 구성: Google 태그의 동의 모드가 ad_storage='denied' 설정을 알리면 UI 진단에서 사용자 동의가 이루어지지 않은 웹사이트 태그 이벤트를 비교에서 제외하므로 API 업로드에서 해당 이벤트를 생략해도 적은 양의 알림이 트리거되지 않습니다. 하지만 웹사이트 태그와 백엔드 간의 동의 처리 불일치로 인해 알림이 트리거됩니다.

    • 태그에 ad_storage='denied'가 없고 백엔드에서 업로드를 건너뜀: UI 진단에서 태그 이벤트를 동의한 것으로 집계하고 적용 범위가 낮다는 알림을 보고합니다.
    • 태그 신호 ad_storage='denied', 백엔드 업로드 개선: 업로드된 개선사항에 일치하는 동의 태그 이벤트가 없으며 주문 ID 불일치 알림이 발생합니다.

    웹사이트 태그와 API 보강 업로드 모두에 동일한 동의 상태를 적용합니다.

  • 익명 웹사이트 이벤트: 익명 방문자에 대해 웹사이트 태그가 실행되는 상위 유입경로 전환 액션(예: 페이지 조회 또는 상품 조회)에는 향상된 전환을 사용 설정하지 마세요. 서버가 연락처 정보가 알려진 로그인한 사용자에 대해서만 API 개선사항을 전송하는 경우 일치하지 않는 익명 태그 이벤트로 인해 적용 범위가 낮다는 알림이 트리거됩니다. 사용자 제공 데이터를 지속적으로 사용할 수 있는 전환 액션에만 향상된 전환을 사용 설정합니다.

일반 전환 관리 문제

다음과 같은 일반적인 문제에 유의하세요.

• enum 필드를 UNKNOWN로 설정하려고 하면 RequestError.INVALID_ENUM_VALUE 오류가 발생합니다. 이는 광고주가 동의 여부를 알 수 없는 경우 consent를 지정할 때 발생하는 일반적인 문제입니다. consent의 상태를 알 수 없는 경우 DENIED로 설정해야 합니다.

• 앱 전환 또는 Firebase 및 서드 파티 앱 분석의 전환 액션을 만들 때 생성 시 app_id 필드만 변경할 수 있습니다. 전환 액션이 생성되면 이 필드를 변경할 수 없습니다.

• 전환 액션을 만들 때 ConversionAction.attribution_model_settings.attribution_model 필드를 GOOGLE_ADS_LAST_CLICK 또는 GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN로만 설정할 수 있습니다. 다른 옵션을 사용하면 CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS 오류가 발생합니다. 다른 기여 분석 모델의 지원 중단을 알리는 블로그 게시물에서 자세한 내용을 확인하세요.

• click_through_lookback_window_days 필드에 허용되는 범위는 AD_CALL 및 WEBSITE_CALL 유형의 전환 액션의 경우 1~60일입니다. 다른 대부분의 전환 액션에서 허용되는 범위는 1~90일입니다.

• 대부분의 전환 액션에서 view_through_lookback_window_days 필드에 허용되는 범위는 1~30일입니다. AD_CALL 및 WEBSITE_CALL 유형의 전환 액션의 경우 이 필드를 설정하지 않아야 합니다.

• 전환 액션에서 include_in_conversions_metric 필드를 설정하거나 업데이트하면 FieldError.IMMUTABLE_FIELD 오류가 발생합니다. 대신 전환 목표 가이드에 설명된 대로 primary_for_goal 필드를 설정하세요.

• WEBSITE_CALL 또는 AD_CALL 유형의 전환 액션을 만들 때 value_settings.always_use_default_value를 true로 설정해야 합니다. false 값을 지정하면 INVALID_VALUE 오류가 발생합니다.

일반적인 오류

다음 안내는 교차 계정 전환 추적 액세스 오류를 비롯한 오프라인 전환 가져오기의 일반적인 오류를 진단하고 해결하는 데 도움이 됩니다.

오류
INVALID_CONVERSION_ACTION_TYPE	지정된 전환 액션에 클릭 전환 업로드에 유효하지 않은 유형이 있습니다. 업로드 요청에 지정된 ConversionAction의 유형이 UPLOAD_CLICKS인지 확인합니다.
NO_CONVERSION_ACTION_FOUND	지정된 전환 액션이 사용 설정되지 않았거나 요청의 customer_id 필드에 있는 계정에서 액세스할 수 없습니다. 전환 추적 설정에 관한 정보를 검색하여 전환 액션이 사용 설정되어 있는지 확인합니다. 전환 액션 소유자는 클릭의 Google Ads 광고 전환 고객이거나 업로드 계정의 전환 추적 계층 구조에 있는 계정이어야 합니다. 예를 들어 전환 액션이 클릭 후 연결 해제된 이전 관리자 계정에 속하는 경우 이 오류가 발생합니다.
TOO_RECENT_CONVERSION_ACTION	전환 액션이 새로 생성되었습니다. 액션이 생성된 후 최소 6시간이 지난 후에 실패한 전환을 다시 시도합니다.
INVALID_CUSTOMER_FOR_CLICK	요청의 customer_id 필드가 클릭 시점의 Google Ads 전환 고객과 일치하지 않습니다. 이 오류는 업로드 계정에 전환 액션에 대한 교차 계정 액세스 권한도 없는 경우에 발생합니다. 요청의 customer_id 필드를 전환 액션 소유자의 계층 구조에 있는 계정으로 업데이트합니다.
EVENT_NOT_FOUND	Google Ads에서 클릭 ID와 customer_id의 조합을 찾을 수 없습니다. customer_id 요구사항을 검토하고 올바른 Google Ads 계정을 사용하여 업로드하고 있는지 확인합니다.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	요청에 포함된 여러 전환의 클릭 ID, conversion_date_time, conversion_action 조합이 동일합니다. 요청에서 중복 전환을 삭제하세요.
CLICK_CONVERSION_ALREADY_EXISTS	클릭 ID, conversion_date_time, conversion_action의 조합이 동일한 전환이 이전에 업로드되었습니다. 업로드를 다시 시도하고 이 전환이 이전에 성공한 경우 이 오류를 무시하세요. 이전에 업로드한 전환 외에 다른 전환을 추가하려면 이전에 업로드한 전환이 중복되지 않도록 ClickConversion의 conversion_date_time를 조정합니다.
EXPIRED_EVENT	가져온 클릭이 click_through_lookback_window_days 필드에 지정된 기간 전에 발생했습니다. click_through_lookback_window_days를 변경하면 변경 후에 기록된 클릭에만 영향을 미치므로 전환 확인 기간을 변경해도 특정 클릭에 대한 이 오류가 해결되지 않습니다. 필요한 경우 conversion_action를 전환 확인 기간이 더 긴 다른 액션으로 변경합니다.
CONVERSION_PRECEDES_EVENT	conversion_date_time가 클릭 날짜 및 시간 이전입니다. conversion_date_time를 이후 값으로 업데이트합니다.
VALUE_MUST_BE_UNSET	ClickConversion에 gbraid 또는 wbraid(gclid 없음)에 대한 값이 설정되어 있고 custom_variables 또는 cart_data에 대한 값이 있습니다. Google Ads는 gbraid 또는 wbraid를 지원하지 않습니다. 충돌하는 필드를 설정 해제합니다. 참고: 전환에서 gbraid 및 wbraid를 모두 설정하고 동일한 전환에서 다른 필드 유효성 검사도 실패하면 API에서 GBRAID_WBRAID_BOTH_SET를 반환할 수 있습니다. 전환의 다른 검증 문제를 해결합니다. 클릭 식별자를 삭제할 필요가 없습니다.