전환을 관리하려면 복잡한 통합이 필요하며, 상호 의존적인 여러 도구와 프로세스가 포함되는 경우가 많습니다. 이 가이드에서는 이해할 수 없는 API 오류가 표시되거나 UI에 표시되는 측정항목 또는 진단에 혼란이 있는 경우 문제를 해결하기 위해 취할 수 있는 자세한 단계를 제공합니다.
Google Ads UI에서 측정항목 읽기
Google Ads UI에서는 가져오기 날짜별로 전환 측정항목을 정리하지 않으므로 UI의 보고서를 사용하여 가져오기 결과를 확인하면 오해의 소지가 있을 수 있습니다. 가져오기 상태를 확인하려면 오프라인 진단부터 시작하세요. Google Ads UI에서 리드 확보용 향상된 전환 및 웹용 향상된 전환의 진단에 대해 자세히 알아볼 수도 있습니다.
리드 확보용 향상된 전환 관련 문제
이 섹션에서는 리드용 향상된 전환을 가져오는 동안 발생하는 일반적인 문제를 해결하는 데 중점을 둡니다.
일반적인 실수
| 오류 | |
|---|---|
NO_CONVERSION_ACTION_FOUND
|
지정된 전환 액션이 사용 설정되지 않았거나 요청의 `client_id` 필드에 지정된 클라이언트 계정에서 액세스할 수 없습니다. 업로드의 전환 액션이 사용 설정되어 있고 업로드 요청을 전송하는 고객이 소유하고 있는지 확인합니다. 이 오류는 요청의 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는 오프라인 데이터 진단의 클릭이 Google Ads 캠페인에서 발생하지 않은 경우 이 오류가 표시됩니다. 예를 들어 SA360 또는 DV360에서 가져올 수 있습니다. 기타 가능한 원인은 다음과 같습니다.
업로드하는 고객이 Google Ads 전환 고객과 다른 드문 경우에 이 오류는 업로드하는 고객이 고객 데이터 약관에 동의했지만 게재하는 고객은 동의하지 않았음을 의미할 수 있습니다. customer 리소스를 쿼리하고 customer.offline_conversion_tracking_info.accepted_customer_data_terms 필드를 확인하여 계정에서 고객 데이터 약관에 동의했는지 확인할 수 있습니다.
|
측정항목 불일치
다음과 같은 일반적인 문제에 유의하세요.
다양한 이유로 Google 처리 파이프라인에서 전환이 삭제될 수 있으며 이러한 전환은 복구할 수 없습니다. 자세한 내용은 업로드 성공 후 데이터 불일치 도움말을 참고하세요.
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오류가 발생합니다. 다른 기여 분석 모델의 지원 중단을 알리는 블로그 게시물에서 자세한 내용을 확인하세요.AD_CALL및WEBSITE_CALL유형의 전환 액션의 경우click_through_lookback_window_days필드의 허용 범위는[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의 조합이 동일한 전환이 이전에 업로드되었습니다. 업로드를 다시 시도하고 이 변환이 이전에 성공한 경우 이 오류를 무시하세요. 이전에 업로드한 전환 외에 다른 전환을 추가하려면 이전에 업로드한 전환이 중복되지 않도록 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만 사용하도록 전환을 업데이트하고 여러 클릭을 동일한 전환으로 결합하지 않도록 합니다. 각 클릭에는 클릭 ID가 하나만 있습니다.
|
VALUE_MUST_BE_UNSET
|
GoogleAdsError의 location을 확인하여 다음 문제 중 어떤 문제가 오류를 일으켰는지 확인합니다.
|