전환을 관리하려면 종종 상호 종속된 여러 도구와 프로세스가 포함된 복잡한 통합이 필요합니다. 이 가이드에서는 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인지 확인합니다.
|
CLICK_CONVERSION_ALREADY_EXISTS
|
이 클릭에 대해 이 conversion_date_time가 포함된 전환이 이미 있습니다. conversion_date_time이 이벤트마다 고유한지 확인하고 다시 시도하세요.
|
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에서 요청에 참조된 전환 액션의 향상된 전환 사용 설정 체크박스를 선택해야 합니다. 고객센터에서 자세한 안내를 확인하세요.
|
일반 전환 관리 문제
다음과 같은 일반적인 문제에 유의하세요.
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의 조합이 동일한 전환이 이전에 업로드되었습니다. 업로드를 다시 시도 중이고 이전에 이 변환이 성공한 경우 이 오류를 무시합니다. 이전에 업로드한 전환 외에도 다른 전환을 추가하려면 이전에 업로드한 전환이 중복되지 않도록 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를 확인하여 다음 문제 중 어떤 문제가 오류를 일으켰는지 확인합니다.
|