Рекомендации

При использовании Data Manager API следуйте приведенным ниже рекомендациям.

Отправлять все идентификаторы пользователей

Независимо от того, отправляете ли вы участников аудитории или события с помощью UserData, включите как можно больше user_identifiers, в том числе несколько идентификаторов одного типа.

Например, если у пользователя несколько адресов электронной почты, добавьте отдельный элемент UserIdentifier для каждого из них. Аналогично, если у вас есть идентификаторы разных типов для одного пользователя, например адреса электронной почты, номера телефонов и адреса, добавьте отдельный элемент UserIdentifier для каждого идентификатора, не превышая максимальное количество идентификаторов.

Оптимизация запросов

Чтобы не превысить дневной лимит, объединяйте в одном запросе как можно больше элементов, но не превышайте ограничения на один запрос.

Например, если вы хотите добавить в аудиторию 10 000 участников, добавьте их все в список audience_members в одном запросе IngestAudienceMembersRequest. Добавить всех 10 000 участников одним запросом эффективнее,чем отправлять отдельный запрос для каждого участника.

Отправка параллельных запросов

Чтобы сократить общее время, необходимое для передачи данных, отправляйте параллельные запросы к IngestionService. Рекомендуем отправлять не более 10 запросов одновременно, чтобы снизить вероятность превышения лимита запросов в минуту.

Вы можете отправлять параллельные запросы, даже если у них одинаковый параметр destinations.

Как использовать validateOnly для проверки на наличие ошибок, приводящих к быстрому сбою

Отправляйте запросы, в которых для параметра validateOnly задано значение true, чтобы выявлять ошибки быстрого сбоя. Data Manager API выполняет те же проверки, что и обычный запрос, но не добавляет и не удаляет данные.

Успешное выполнение запроса только для проверки не гарантирует, что при обработке не возникнет ошибок, поэтому после отправки обычного запроса продолжайте проверять диагностику.

Посмотреть данные диагностики

Запишите и соберите request_id из каждого объекта IngestAudienceMembersResponse или IngestEventsResponse и используйте идентификаторы запросов для диагностики.

Как отслеживать квоты и получать оповещения о них

Чтобы избежать неожиданных отклонений запросов, настройте оповещения о квотах и мониторинг в консоли Google Cloud. Отслеживание использования квот помогает выявлять закономерности в потреблении ресурсов и оптимизировать пакетную обработку запросов до того, как приложение достигнет дневных или минутных ограничений.

Развертывание рабочей версии

При переходе от локального тестирования к рабочим нагрузкам используйте Application Default Credentials с прикрепленным сервисным аккаунтом или Workload Identity Federation, чтобы безопасно выполнять аутентификацию без взаимодействия с пользователем.

Подробные сведения о настройке аутентификации для разных рабочих сред приведены в статье Развертывание в рабочей среде.