문제 해결

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

Google Ads UI에서 측정항목 읽기

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

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

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

일반적인 오류

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

오류
NO_CONVERSION_ACTION_FOUND

지정된 전환 액션이 사용 설정되지 않았거나 요청의 customer_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는 이를 오프라인 데이터 진단의 successful_event_count에 포함합니다. Google Ads API에는 alerts 컬렉션에 CLICK_NOT_FOUND 항목이 포함되어 있으므로 이 경고의 빈도를 모니터링할 수 있습니다.

Google Ads 캠페인에서 발생한 클릭이 아닌 경우 이 오류가 발생할 수 있습니다. 예를 들어 SA360 또는 DV360에서 가져올 수 있습니다. 다른 가능한 원인은 다음과 같습니다.

업로드하는 고객이 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 제품 지원팀에 문의하여 도움을 받으세요.

웹용 향상된 전환 관련 문제

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

일반적인 오류

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

오류
CONVERSION_NOT_FOUND 제공된 전환 액션 및 전환 식별자 쌍 또는 order_id의 전환을 찾을 수 없습니다. 전환이 요청의 customer_id에 지정된 Google Ads 전환 고객의 Google Ads 전환인지 확인합니다.
또한 gclid 대신 gbraid 또는 wbraid가 채워진 클릭에 대한 전환이 아닌지 확인합니다. 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~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 내에서 찾을 수 없습니다. 전환 설정에 대한 정보를 검색하여 업로드의 전환 액션이 사용 설정되어 있고 업로드 요청의 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의 조합이 동일한 전환이 이전에 업로드되었습니다. 업로드를 다시 시도하고 이 전환이 이전에 성공한 경우 이 오류를 무시하세요. 이전에 업로드한 전환 외에 다른 전환을 추가하려면 이전에 업로드한 전환이 중복되지 않도록 ClickConversion의 conversion_date_time를 조정합니다.
EVENT_NOT_FOUND Google Ads에서 클릭 ID와 customer_id의 조합을 찾을 수 없습니다. customer_id 요구사항을 검토하고 올바른 Google Ads 계정을 사용하여 업로드하고 있는지 확인합니다.
EXPIRED_EVENT 가져온 클릭이 click_through_lookback_window_days 필드에 지정된 기간 전에 발생했습니다. 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 GoogleAdsError의 location를 확인하여 다음 문제 중 오류를 일으킨 문제를 확인합니다.
  • ClickConversion에는 gclid에 대한 값과 gbraid 또는 wbraid 중 하나 이상에 대한 값이 설정되어 있습니다. 하나의 클릭 ID 또는 URL 매개변수만 사용하도록 전환을 업데이트하고 여러 클릭을 동일한 전환으로 결합하지 않도록 합니다. 각 클릭에는 클릭 ID 또는 URL 매개변수가 하나만 있습니다.
  • ClickConversion에는 gbraid 또는 wbraid에 설정된 값이 있고 custom_variables의 값이 있습니다. Google Ads는 gbraid 또는 wbraid URL 매개변수가 있는 전환에 대한 맞춤 변수를 지원하지 않습니다. 전환의 custom_variables 필드를 설정 해제합니다.
이전
보고