4.5 오류 처리

소개


이 가이드에서는 실적 최대화 캠페인 설정 흐름에서 발생할 수 있는 잠재적인 문제를 언급했습니다. 그러나 판매자가 실적 최대화 캠페인을 만든 후 흐름 밖에서 문제가 발생할 수도 있습니다. 올바른 오류 처리는 성공적인 통합에 매우 중요하므로 이 섹션에서는 오류 처리 권장사항을 자세히 설명합니다.

이 섹션에서는 다음과 같은 일반적인 문제만 다룹니다.

  • 실적 최대화 캠페인 게재에 영향을 미칠 수 있습니다. 단, 3단계에서 이미 언급한 오류 (광고에만 국한되지 않음)는 제외됩니다.

  • 심각도가 높으며 계정 정지, 제품 비승인 또는 캠페인 게재 중단으로 이어질 수 있습니다. '경고'로 분류된 문제는 나열되지 않습니다.

  • 판매자의 해결 요청 전환 추적 구현 오류 (전환 0회 또는 페이지 조회수와 같은 불필요한 전환 기록)와 같이 직접 해결해야 하는 일반적인 문제는 이 섹션에서 다루지 않습니다. 이전 섹션, 특히 출시 후 이러한 문제가 발생할 위험을 완화하기 위한 팁을 참고하세요.

  • 광고 검토 요청 필요. 검토 요청을 사용 설정하는 새로운 판매자 지원 방법

특히 이 섹션에서는 Google Ads 계정과 관련된 다음과 같은 6가지 문제를 다룹니다.

  1. 광고 계정에 대한 제한된 액세스
  2. 2단계 인증 필요
  3. 계정 정지됨
  4. 광고주 확인
  5. 결제 정보 누락 (직접 결제 시나리오의 경우)
  6. 기존 전환 추적으로 인해 전환 추적 설정이 충돌합니다.

각 문제에 관한 간단한 설명, 이 가이드의 관련 구현 섹션 링크, 판매자 해결 단계, 문제를 표시할 위치에 관한 권장사항이 제공됩니다.

UX 안내


온보딩 중 Google Ads 계정 수준 오류에 대한 자세한 내용은 Google Ads 계정 만들기 섹션의 마지막 부분을 참고하세요.

온보딩 후 Google Ads 계정 수준 오류는 앱 전체와 캠페인 수준에 표시되어야 합니다. 다음은 잘못된 결제 정보 시나리오에서 어떻게 표시되는지 보여주는 예입니다.

오류

아래에는 모든 Google Ads 계정 수준 오류와 이러한 오류가 캠페인 및 페이지 수준에서 표시되는 방법에 대한 개요가 나와 있습니다.

errors2

광고 게재를 제한하는 다른 문제도 같은 방식으로 처리해야 합니다. 다음은 실패한 제품 동기화의 예입니다.

실패

Google Ads 계정 수준 오류가 여러 개 있는 경우: 사용자가 부담을 느끼지 않도록 한 번에 가장 심각한 Google Ads 계정 수준 오류만 표시하고 이전 오류가 해결된 후 다음으로 가장 심각한 오류를 표시하는 것이 좋습니다. Google은 다음과 같은 계층 구조를 제안합니다.

errors3

기술 가이드


Ads API 문서에서는 API 호출 시 일반적인 오류 처리에 관한 권장사항을 다룹니다. 이 섹션에서는 판매자의 실적 최대화 캠페인의 성공에 영향을 미칠 수 있는 더 많은 개념적 오류를 다룹니다.

2단계 인증 필요

사용자가 2단계 인증을 설정해야 하는 경우, 사용자가 2단계 인증을 사용 설정하기 전에 발급된 갱신 토큰에서 생성된 액세스 토큰을 사용하여 API를 호출하면 TWO_STEP_VERIFICATION_NOT_ENROLLED 오류가 반환됩니다. 애플리케이션은 이 오류를 처리하고 사용자에게 다음 페이지에서 Google 계정에 2단계 인증을 사용 설정하도록 안내해야 합니다.

    https://safety.google/authentication/

자세한 내용은 이 가이드의 2단계 인증 섹션을 참고하세요.

계정 정지됨

Google Ads 계정은 여러 가지 이유로 정지될 수 있습니다. custome.status를 사용하여 Google Ads 계정의 상태를 확인하면 'SUSPENDED' 값이 반환되는지 알 수 있습니다.

계정이 정지된 경우 판매자에게 이 상태를 알리고 다음 중 하나로 안내해야 합니다.

  1. Google Ads 프런트엔드에서 계정 내 알림을 클릭하여 자세한 정보를 확인하고 이의신청을 제출하는 단계를 진행합니다.

  2. Google에서 보낸 알림 이메일이 있는지 확인합니다. 이메일에는 정지된 Google Ads 계정 CID, 정지 사유, 계정 정지 조치가 잘못되었다고 생각하는 경우 이의를 제기할 수 있는 링크가 포함됩니다.

광고 계정에 대한 제한된 액세스

Google Ads 계정을 판매자 센터 계정에 연결하려면 Google Ads 사용자 계정에 관리 액세스 수준이 있어야 합니다.

판매자가 읽기 전용 또는 일반 액세스 권한이 있는 사용자인 기존 Google Ads 계정을 연결하려고 하면 API 호출에 오류가 발생합니다. 읽기 전용 또는 일반 액세스 권한이 있는 사용자의 기존 Google Ads 계정을 연결하기 위해 애플리케이션을 활용하는 판매자의 경우 Google Ads 계정과 판매자 센터 계정을 연결하기 위한 API 호출을 실행할 때 Google Ads 액세스 제한과 관련된 오류가 발생할 수 있습니다.

기존 Google Ads 계정에 대한 관리자 액세스 권한이 있는 팀원에게

1) 사용자 계정을 관리자 계정으로 업그레이드

2) 관리자 액세스 사용자 계정으로 애플리케이션의 온보딩 흐름을 다시 진행합니다.

결제 정보 누락 (직접 결제 상황)

Google Ads 계정에 결제 정보가 없으면 해당 계정의 캠페인이 운영되지 않습니다. BillingSetupStatus를 사용하여 판매자가 결제 설정을 완료했는지 확인할 수 있습니다. 'APPROVED' 이외의 값을 사용하면 광고가 게재되지 않습니다.

구현 단계에 따라 온보딩 중에 판매자에게 Google Ads UI 딥 링크를 제공했지만 판매자가 결제 정보를 추가하지 않았을 수 있습니다 (기타 결제 문제 참고).

판매자에게 이 결제 문제를 알리고 결제 설정을 완료할 수 있도록 딥 링크를 다시 표시해야 합니다. 딥 링크를 사용할 수 없는 경우에는 판매자에게 Google Ads 프런트엔드로 이동하도록 안내할 수도 있습니다.

'도구 및 설정' > '결제' > '설정'으로 이동하여 설정을 완료합니다.

여러 전환 액션 경고

판매자가 기존 Google Ads 계정을 재사용하도록 허용하는 경우 판매자가 이미 웹사이트를 구성했을 수 있습니다.