Видео : Посмотрите доклад о передовых практиках с семинара 2019 года.
В этом руководстве описаны некоторые передовые методы, которые вы можете внедрить для оптимизации эффективности и производительности ваших приложений.
Текущее техническое обслуживание
Чтобы ваше приложение работало без сбоев:
Поддерживайте актуальность своего адреса электронной почты разработчика в центре API. Это псевдоним, который мы используем для связи с вами. Если мы не сможем связаться с вами по поводу соблюдения Условий использования API, ваш доступ к API может быть отозван без вашего предварительного уведомления. Избегайте использования личного адреса электронной почты, привязанного к индивидуальной или неконтролируемой учетной записи. Для просмотра центра API необходимо войти в свою учетную запись менеджера.
Чтобы быть в курсе таких вопросов, как изменения в продукте, простои на техническое обслуживание, даты прекращения поддержки и так далее, подпишитесь на нашу рассылку.
Обеспечьте соответствие вашего приложения условиям использования Google Ads API (Условия и положения ). При необходимости команда по проверке и обеспечению соответствия токенов свяжется с вами по указанному вами адресу электронной почты. Если у вас есть вопросы или замечания по поводу Условий и положений, вы можете связаться с командой проверки, ответив на электронное письмо, которое они отправили вам при проверке вашей заявки на получение токена разработчика.
Оптимизация
Вы можете оптимизировать свое приложение, выполняя пакетные операции и, при необходимости, отправляя разреженные объекты.
Пакетные операции
Отправка запроса к API влечет за собой ряд фиксированных затрат, таких как задержка в сети в обоих направлениях, обработка сериализации и десериализации, а также вызовы к бэкэнд-системам. Чтобы уменьшить влияние этих фиксированных затрат и повысить общую производительность, большинство методов изменения в API предназначены для приема массива операций. Объединяя несколько операций в один запрос, вы можете уменьшить количество отправляемых запросов и связанные с ними фиксированные затраты. По возможности избегайте запросов, содержащих только одну операцию.
Например, предположим, вы добавляете 50 000 ключевых слов в кампанию, охватывающую несколько групп объявлений. Вместо того чтобы делать 50 000 запросов по одному ключевому слову в каждом, сделайте 100 запросов по 500 ключевых слов в каждом или даже 10 запросов по 5000 ключевых слов в каждом. Существуют ограничения на количество операций в запросе, поэтому вам может потребоваться скорректировать размер пакета для достижения оптимальной производительности.
Отправка разреженных объектов
При отправке объектов в API поля должны быть десериализованы, проверены и сохранены в базе данных. Передача полных объектов, когда необходимо обновить только несколько полей, может привести к увеличению времени обработки и снижению производительности. Для решения этой проблемы API Google Ads поддерживает разреженные обновления, позволяющие заполнять только те поля объекта, которые необходимо изменить или которые являются обязательными. Разреженные обновления обрабатываются быстрее и с меньшей вероятностью приводят к ошибкам. Поля, не включенные в update_mask (также известный как FieldMask ), остаются неизмененными.
Например, приложению, которое обновляет ставки на уровне ключевых слов, может быть полезно использовать разреженные обновления, поскольку потребуется заполнить только поля ID группы объявлений, ID критерия и ставки.
Обработка и управление ошибками
В процессе разработки вы, вероятно, столкнетесь с ошибками. В этом разделе описаны соображения и стратегии по внедрению системы управления ошибками в ваше приложение. Помимо этого раздела, посетите руководство по устранению неполадок для получения дополнительной информации об управлении ошибками.
Различить источники запросов
Некоторые приложения в основном интерактивны, выполняя вызовы API непосредственно в ответ на действия пользователя в пользовательском интерфейсе. Другие работают преимущественно в автономном режиме, выполняя вызовы API в рамках периодического процесса на стороне сервера. Многие приложения сочетают в себе оба подхода. При рассмотрении вопросов управления ошибками полезно различать эти разные типы запросов.
При обработке запросов, инициированных пользователями, вашей главной задачей должно быть обеспечение удобного взаимодействия с пользователем. Используйте описание конкретной ошибки, чтобы предоставить пользователю как можно больше контекста в пользовательском интерфейсе. Предложите простые шаги, которые он может предпринять для устранения ошибки (ознакомьтесь с предложениями ниже).
Для запросов, инициированных на стороне сервера, реализуйте обработчики для различных типов ошибок, с которыми может столкнуться ваше приложение. Всегда включайте обработчик по умолчанию для обработки редких или ранее не встречавшихся ошибок. Хорошим подходом для обработчика по умолчанию является добавление неудачной операции и ошибки в очередь для проверки оператором и определения соответствующего решения.
Различать типы ошибок
Знание различий между типами ошибок в Google Ads API имеет решающее значение при создании надежной системы обработки ошибок. К наиболее распространенным типам ошибок относятся:
Для получения более подробной информации см. разделы «Типы ошибок» и «Распространенные ошибки» .
Синхронизация бэкэндов
Если пользователи вашего приложения имеют ручной доступ к аккаунтам Google Ads, они могут вносить изменения, о которых ваше приложение не знает, что приводит к рассинхронизации локальной базы данных. Как отмечено в нашем руководстве по типам ошибок , вы можете реагировать на ошибки синхронизации, когда они возникают, но вы также можете попытаться предотвратить их на упреждающем уровне. Одна из таких стратегий — запускать ежедневную синхронизацию всех ваших аккаунтов, получая объекты Google Ads из ваших аккаунтов и сравнивая их с локальной базой данных.
Ошибки журнала
Для облегчения отладки и мониторинга все ошибки должны быть зарегистрированы. Как минимум, следует регистрировать идентификатор запроса, операции, вызвавшие ошибку, и саму ошибку. Также следует регистрировать идентификатор клиента, API-сервис, задержку запроса в обоих направлениях, количество повторных попыток, а также необработанные запрос и ответ.
Отслеживание тенденций
Обязательно отслеживайте тенденции ошибок API, чтобы выявлять и устранять проблемы в вашем приложении. Рассмотрите возможность создания собственного решения или использования одного из множества доступных коммерческих инструментов, которые могут использовать ваши журналы для создания интерактивных панелей мониторинга и отправки автоматических оповещений.
Разработка
Используйте тестовые учетные записи во время разработки.
Используйте тестовые аккаунты
Тестовые аккаунты — это аккаунты Google Ads, которые фактически не показывают рекламу. Вы можете использовать тестовый аккаунт для экспериментов с API Google Ads и проверки того, что подключение вашего приложения, логика управления кампаниями или другие процессы работают должным образом. Для использования в тестовом аккаунте ваш токен разработчика не требует одобрения, поэтому вы можете начать разработку с использованием API Google Ads сразу после запроса токена разработчика, даже до того, как ваше приложение будет проверено.