4.5 Обработка ошибок
Введение
В этом руководстве мы упоминали потенциальные проблемы, которые могут возникнуть в процессе настройки максимальной эффективности. Однако проблемы могут возникнуть и вне потока, после того как продавец создал кампанию с максимальной эффективностью. Правильная обработка ошибок настолько важна для успеха вашей интеграции, что этот раздел посвящен более подробному описанию лучших практик обработки ошибок.
В этом разделе рассматриваются только распространенные проблемы, которые:
Может повлиять на показ кампаний с максимальной эффективностью , за исключением ошибок, уже упомянутых в шаге 3 (которые не относятся только к объявлениям).
Являются серьезными и могут привести к блокировке аккаунта, отклонению продукта или невозможности обслуживания кампании . Проблемы, классифицированные как «предупреждения», не указаны.
Требуйте разрешения продавца . Общие проблемы, которые вам придется решать самостоятельно, например ошибки в реализации отслеживания конверсий (запись нулевых конверсий или ненужных конверсий, таких как просмотры страниц), не рассматриваются в этом разделе. Обратитесь к предыдущим разделам, особенно к советам по снижению риска возникновения этих проблем после запуска.
Требовать запрос на проверку рекламы . Новый метод поддержки продавцов , позволяющий просматривать запросы .
В частности, в этом разделе рассматриваются следующие 6 проблем, связанных с рекламным аккаунтом:
- Ограниченный доступ к рекламному аккаунту
- Требуется двухэтапная проверка
- Аккаунт заблокирован
- Проверка рекламодателя
- Отсутствует платежная информация (для сценария прямого выставления счетов).
- Конфликт настроек отслеживания конверсий из-за существующего отслеживания конверсий.
Для каждой проблемы предоставлено краткое описание, ссылка на соответствующий раздел реализации в этом руководстве, шаги по устранению проблемы для продавцов и рекомендации о том, где можно сообщить о проблеме.
UX-руководство
Более подробную информацию об ошибках на уровне учетной записи Google Рекламы во время регистрации см. в последнем разделе раздела «Создание учетной записи Рекламы» .
После регистрации ошибки на уровне аккаунта Google Рекламы должны отображаться на уровне всего приложения и на уровне кампании. Ниже показан пример того, как это может выглядеть в случае неверных платежных данных.
Ниже приведен обзор всех ошибок на уровне аккаунта Google Рекламы и того, как они могут проявляться на уровне кампании и страницы.
Другие проблемы, ограничивающие показ рекламы, следует решать таким же образом. Ниже приведен пример того, как может выглядеть неудачная синхронизация продукта.
Если существует несколько ошибок на уровне аккаунта Google Рекламы: чтобы не перегружать пользователя, мы рекомендуем одновременно показывать только самую серьезную ошибку на уровне аккаунта Google Рекламы и показывать следующую по степени серьезности после устранения предыдущей. Google предлагает следующую иерархию:
Техническое руководство
В документации по Ads API описаны рекомендации по общей обработке ошибок при вызовах API. В этом разделе рассматриваются дополнительные концептуальные ошибки, которые могут повлиять на успех кампании продавца с максимальной эффективностью.
Требуется двухэтапная аутентификация
Если вы требуете, чтобы пользователи настроили двухэтапную аутентификацию, ошибка TWO_STEP_VERIFICATION_NOT_ENROLLED возвращается, если вызовы API выполняются с использованием токенов доступа, сгенерированных из токена обновления, который был выдан до того, как пользователь включил двухэтапную проверку. Приложение должно обработать эту ошибку и предложить пользователю включить двухэтапную аутентификацию для своей учетной записи Google по адресу:
https://safety.google/authentication/
Дополнительную информацию см. в разделе «Двухэтапная проверка» данного руководства.
Аккаунт заблокирован
Аккаунт Google Рекламы может быть заблокирован по нескольким причинам . Вы можете проверить статус аккаунта Google Рекламы, используя custome.status , чтобы увидеть, возвращается ли значение «SUSPENDED».
Если учетная запись заблокирована, вам следует предупредить продавца об этом статусе и направить его:
Нажмите уведомление в аккаунте во внешнем интерфейсе Google Рекламы , чтобы просмотреть дополнительную информацию и выполнить действия по подаче апелляции.
Проверьте их электронную почту на наличие письма с уведомлением от Google. В электронном письме содержится идентификатор клиента Google Рекламы, действие которого было заблокировано, причина блокировки и ссылка для подачи апелляции, если продавец считает, что аккаунт был заблокирован по ошибке.
Ограниченный доступ к рекламным аккаунтам
Чтобы связать аккаунт Google Рекламы с аккаунтом Merchant Center , аккаунт пользователя Google Рекламы должен иметь уровень доступа администратора .
Если продавец пытается связать существующий аккаунт Google Рекламы, в котором он является пользователем с доступом только для чтения или стандартным доступом, вызов API вызывает ошибку. Продавцы, использующие ваше приложение для связи с существующим аккаунтом Google Рекламы, в котором они являются пользователем с доступом только для чтения или стандартным доступом, могут столкнуться с ошибкой, связанной с ограниченным доступом к рекламе, когда выполняется вызов API для связывания аккаунта Google Рекламы и аккаунта Merchant Center.
Вам следует предупредить продавца, чтобы он попросил члена его команды с доступом администратора к существующему аккаунту Google Рекламы либо
1) Обновите учетную запись пользователя до учетной записи администратора; или
2) Повторно выполните процедуру регистрации приложения с учетной записью пользователя с правами администратора .
Платежная информация отсутствует (для сценария прямого выставления счетов).
Если в аккаунте Рекламы отсутствует платежная информация, кампании в этом аккаунте не запустятся. Вы можете проверить, завершил ли продавец настройку платежа, используя BillingSetupStatus . Любое значение, кроме «APPROVED», приведет к тому, что объявления не будут показываться.
В соответствии с этапами реализации вы могли предоставить продавцам глубокую ссылку на пользовательский интерфейс Google Рекламы во время регистрации, но они, возможно, не добавили свою платежную информацию (см. другие проблемы с платежами ).
Вам следует предупредить продавца об этой проблеме с выставлением счетов и повторно предоставить ему глубокую ссылку для завершения настройки выставления счетов. Альтернативно, если глубокая ссылка недоступна, вы можете предложить продавцу посетить интерфейс Google Рекламы.
Инструменты и настройки > Оплата > Настройки, чтобы завершить настройку.
Предупреждение о нескольких действиях-конверсиях
Если вы разрешаете продавцам повторно использовать существующую учетную запись Google Рекламы, возможно, они уже настроили свой веб-сайт.