전환을 관리하려면 복잡한 통합이 필요하며, 상호 의존적인 여러 도구와 프로세스가 포함되는 경우가 많습니다. 이 가이드에서는 이해할 수 없는 API 오류가 표시되거나 UI에 표시되는 측정항목 또는 진단에 혼란이 있는 경우 등 문제를 해결하기 위해 취할 수 있는 자세한 단계를 제공합니다.
Google Ads UI에서 측정항목 읽기
Google Ads UI에서는 가져오기 날짜별로 전환 측정항목을 정리하지 않으므로 UI의 보고서를 사용하여 가져오기 결과를 확인하면 오해의 소지가 있을 수 있습니다. 가져오기 상태를 확인하려면 오프라인 데이터 진단부터 시작하세요. Google Ads UI에서 리드 확보용 향상된 전환 및 웹용 향상된 전환의 진단에 대해 자세히 알아볼 수도 있습니다.
리드 확보용 향상된 전환 관련 문제
이 섹션에서는 리드 확보용 향상된 전환을 가져오는 동안 발생하는 일반적인 문제를 해결하는 데 중점을 둡니다.
일반적인 오류
다음 안내는 리드 확보용 향상된 전환의 일반적인 오류를 진단하고 해결하는 데 도움이 됩니다.
| 오류 | |
|---|---|
NO_CONVERSION_ACTION_FOUND
|
지정된 전환 액션이 사용 설정되어 있지 않거나 요청의 이 오류는 요청의 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는 오프라인 데이터 진단의 클릭이 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에서 요청에 참조된 전환 액션에 대해 향상된 전환 사용 설정 체크박스를 선택해야 합니다. 고객센터에서 이와 관련된 안내를 확인하세요.
|
일반적인 전환 관리 문제
다음과 같은 일반적인 문제에 유의하세요.
열거형 필드를
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를 확인하여 다음 문제 중 어떤 문제가 오류를 일으켰는지 확인합니다.
|