문제 해결

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

Google Ads UI에서 측정항목 읽기

Google Ads UI는 가져오기 날짜별로 전환 측정항목을 구성하지 않으므로 UI의 보고서를 사용하여 가져오기 결과를 확인하면 오해의 소지가 있을 수 있습니다. 가져오기 상태를 확인하려면 오프라인 진단부터 시작하세요. 리드 확보용 향상된 전환 및 웹용 향상된 전환에 대한 Google Ads UI의 진단에 대해 자세히 알아볼 수도 있습니다.

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

이 섹션에서는 리드 확보용 향상된 전환을 가져오는 중에 발생하는 일반적인 문제를 해결하는 데 중점을 둡니다.

일반적인 오류

오류
NO_CONVERSION_ACTION_FOUND	지정된 전환 액션이 사용 설정되지 않았거나 요청의 `client_id` 필드에 지정된 클라이언트 계정에서 액세스할 수 없습니다. 업로드의 전환 액션 이 사용 설정되어 있고 업로드 요청을 보내는 고객이 소유하고 있는지 확인하세요. 이 오류는 요청의 GCLID가 요청에 지정된 전환 액션에 액세스할 수 없는 고객 계정에 속하는 경우에도 발생할 수 있습니다. 클릭이 발생한 날짜인 click_view.gclid 및 segments.date를 기준으로 필터링하는 쿼리를 제출하여 click_view 리소스를 사용하여 GCLID가 고객 계정에 속하는지 확인할 수 있습니다.
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 는 UploadClickConversionsRequest에서 debug_enabled가 true인 경우에만 이 오류를 반환합니다. 전환에서 이 경고가 발생하면 Google Ads API 는 오프라인 데이터 진단의 successful_event_count에 이를 포함합니다. Google Ads API는 이 경고의 빈도를 모니터링할 수 있도록 alerts 컬렉션에 CLICK_NOT_FOUND 항목을 포함합니다. 클릭이 Google Ads 캠페인에서 발생하지 않은 경우 이 오류가 발생할 수 있습니다. 예를 들어 SA360 또는 DV360에서 발생할 수 있습니다. 가능한 다른 원인은 다음과 같습니다. 업로드하는 고객이 Google Ads 전환 고객과 다릅니다. 태그 가 리드 양식에 올바르게 구성되지 않았습니다. 업로드된 데이터가 올바르게 정규화되고 해싱되지 않았습니다. 업로드하는 고객이 Google Ads 전환 고객과 다른 드문 경우에 이 오류는 업로드하는 고객이 고객 데이터 약관에 동의했지만 게재 고객은 동의하지 않았음을 의미할 수 있습니다. `customer` 리소스를 쿼리하고 `customer.offline_conversion_tracking_info.accepted_customer_data_terms` 필드를 확인하여 계정에서 고객 데이터 약관에 동의했는지 확인할 수 있습니다.

측정항목의 불일치

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

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

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

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

• 업로드에서 동의 를 올바르게 지정하고 있는지 확인하세요. 계정의 기본 동의 설정을 설정하거나(Google Ads UI에서 도구 -> 데이터 관리자 -> 동의 설정 클릭) 업로드된 각 전환에서 ClickConversion.consent 필드를 설정하여 이 작업을 수행할 수 있습니다.

캠페인 실적 문제

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

웹용 향상된 전환 문제

이 섹션에서는 웹용 향상된 전환을 가져오는 중에 발생하는 일반적인 문제를 해결하는 데 중점을 둡니다.

일반적인 오류

오류
CONVERSION_NOT_FOUND	제공된 전환 액션 및 전환 식별자 쌍 또는 order_id의 전환을 찾을 수 없습니다. 전환이 요청의 customer_id에 지정된 Google Ads 전환 고객의 Google Ads 전환인지 확인하세요. 또한 전환이 gbraid 또는 wbraid 대신 gclid가 채워진 클릭에 대한 것이 아닌지 확인하세요. Google Ads는 이러한 전환에 대한 웹용 향상된 전환을 지원하지 않습니다.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	요청의 customer_id에 대해 고객 데이터 이용약관에 동의하지 않았습니다. 이와 관련된 안내는 기본 요건 가이드에서 확인하세요.
CONVERSION_ALREADY_ENHANCED	이 전환은 이미 지정된 order_id 및 conversion_action으로 조정되었습니다. 각 전환에 고유한 order_id을(를) 제공해야 합니다.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	제공된 conversion_action은 웹용 향상된 전환에 적합하지 않습니다. Google Ads UI에서 요청에 참조된 전환 액션의 향상된 전환 사용 체크박스를 선택해야 합니다. 이와 관련된 안내는 고객센터에서 확인하세요.

일반적인 전환 관리 문제

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

• 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, 30]입니다.

• 대부분의 전환 액션에서 view_through_lookback_window_days 필드의 허용 범위는 [1, 30]입니다. 이 필드는 유형이 AD_CALL 및 WEBSITE_CALL인 전환 액션의 경우 설정 해제 되어야 합니다.

• 전환 액션에서 include_in_conversion_metrics 필드를 설정하거나 업데이트하면 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 내에서 찾을 수 없습니다. 전환 설정에 관한 정보를 검색 하여 업로드의 전환 액션이 사용 설정되어 있고 업로드 요청의 customer_id가 소유하고 있는지 확인하세요.
TOO_RECENT_CONVERSION_ACTION	전환 액션이 새로 생성되었습니다. 작업이 생성된 후 6시간 이상 기다린 후 실패한 전환을 다시 시도하세요.
INVALID_CUSTOMER_FOR_CLICK	요청의 customer_id가 클릭 시 Google Ads API 전환 계정이었던 고객 ID 와 동일하지 않습니다. 요청의 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 조합이 동일한 전환이 이전에 업로드되었습니다. 업로드를 다시 시도하고 이 전환이 이전에 성공한 경우 이 오류를 무시하세요. 이전에 업로드된 전환 외에 다른 전환을 추가하려면 이전에 업로드된 전환이 중복되지 않도록 conversion_date_time의 ClickConversion을 조정하세요.
EVENT_NOT_FOUND	Google Ads에서 클릭 ID와 customer_id의 조합을 찾을 수 없습니다. 요구사항customer_id을 검토하고 올바른 Google Ads 계정을 사용하여 업로드하고 있는지 확인하세요.
EXPIRED_EVENT	가져온 클릭이 click_through_lookback_window_days 필드에 지정된 기간 전에 발생했습니다. A click_through_lookback_window_days 변경하면 변경 후 기록된 클릭에만 영향을 미치므로 전환 확인 기간을 변경해도 특정 클릭에 대한 이 오류는 해결되지 않습니다. 필요한 경우 전환 확인 기간이 더 긴 다른 액션으로 conversion_action을 변경하세요.
CONVERSION_PRECEDES_EVENT	conversion_date_time이 클릭 날짜 및 시간보다 빠릅니다. conversion_date_time을 더 늦은 값으로 업데이트하세요.
GBRAID_WBRAID_BOTH_SET	ClickConversion에 gbraid와 wbraid 모두에 설정된 값이 있습니다. 클릭 ID 또는 URL 매개변수 하나만 사용하도록 전환을 업데이트하고 여러 클릭을 동일한 전환으로 결합하지 않도록 하세요. 각 클릭에는 클릭 ID 또는 URL 매개변수가 하나만 있습니다.
VALUE_MUST_BE_UNSET	location의 GoogleAdsError을 확인하여 다음 문제 중 어떤 문제로 인해 오류가 발생했는지 확인하세요. ClickConversion에 gclid와 gbraid 또는 wbraid 중 하나 이상에 설정된 값이 있습니다. 클릭 ID 또는 URL 매개변수 하나만 사용하도록 전환을 업데이트하고 여러 클릭을 동일한 전환으로 결합하지 않도록 하세요. 각 클릭 에는 클릭 ID 또는 URL 매개변수가 하나만 있습니다. ClickConversion에 gbraid 또는 wbraid 중 하나에 설정된 값이 있고 custom_variables에 값이 있습니다. Google Ads는 gbraid 또는 wbraid URL 매개변수가 있는 전환에 대한 맞춤 변수를 지원하지 않습니다. 전환의 custom_variables 필드를 설정 해제하세요.