Устранение неполадок со списками клиентов

В этом руководстве рассказывается, как устранять неполадки, связанные с низким коэффициентом соответствия и распространенными ошибками, которые могут возникать при интеграции списков электронных адресов.

Проверьте коэффициент соответствия

Прежде чем проверять коэффициент соответствия, убедитесь, что загрузка завершена.

Коэффициент соответствия может быть ниже ожидаемого по ряду причин, в том числе:

  • Данные не были хешированы перед загрузкой.
  • Данные были неправильно отформатированы перед хешированием.
  • Вы сравниваете коэффициенты соответствия в разных системах.
  • Вы пытаетесь добавить несколько идентификаторов пользователей в один объект UserIdentifier. Вместо этого добавьте несколько объектов UserIdentifier в один объект UserData, как показано в примере кода.

Рекламодатель может охватить от 1 до 99 % пользователей из списка в зависимости от того, насколько они активны в Google Поиске, Gmail и на YouTube. Подробные инструкции по устранению неполадок, связанных с низким коэффициентом соответствия, можно найти в Справочном центре.

Различия между коэффициентом соответствия и размером списка

Размер списка и коэффициент соответствия отражают разные значения. При расчете коэффициента соответствия учитываются все пользователи с аккаунтом Google, даже если они не могут быть охвачены с помощью списка электронных адресов. Размер списка – это количество активных пользователей, которые сопоставлены с аккаунтом Google и которым можно показывать персонализированную рекламу.

Как устранять распространенные ошибки

Ошибка
USER_PERMISSION_DENIED Если вы попытаетесь изменить список, созданный в другом аккаунте, то можете столкнуться с ошибками, связанными с разрешениями. Вы можете изменять только списки, созданные в вашем аккаунте.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS Эта ошибка может возникнуть, если вы попытаетесь создать несколько заданий с одним и тем же значением external_id.
CONFLICTING_OPERATION Эта ошибка может возникнуть, если в одном задании смешаны операции remove и create.
TOO_MANY_USER_IDENTIFIERS Операции create в одном задании содержат более 100 000 user_identifiers. Разделите запрос на несколько, чтобы не превышать ограничение.
CONCURRENT_MODIFICATION Эта ошибка может возникнуть, если вы попытаетесь одновременно выполнить несколько операций с одним и тем же списком.
RESOURCE_EXHAUSTED Эта ошибка может возникнуть, если вы пытаетесь отправить слишком много запросов. Чтобы избежать этого, выполняйте операции пакетами, как описано в рекомендациях по использованию. Вы также можете ознакомиться с рекомендациями по лимитам и квотам API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Эта ошибка возникает, если в вашем проекте Google Cloud (или устаревшем токене разработчика, поддержка которого прекращена 9 сентября 2026 г.) не было запросов списков электронных адресов в период с 1 октября 2025 г. по 31 марта 2026 г. Вместо этого для работы со списками электронных адресов необходимо использовать Data Manager API.

Дополнительная поддержка по устранению неполадок

Если у вас по-прежнему возникают проблемы, свяжитесь с нами через инструмент устранения неполадок со списками электронных адресов.