При использовании 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 и используйте идентификаторы запросов, чтобы проверить диагностику.
Развертывание в рабочей среде
При переходе от локального тестирования к рабочим нагрузкам используйте Application Default Credentials с прикрепленным сервисным аккаунтом или Workload Identity Federation для неинтерактивной и безопасной аутентификации.
Подробнее о том, как настроить аутентификацию для разных рабочих сред…