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

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

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

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

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

  • Данные не хешировались перед загрузкой.

  • Данные были неправильно отформатированы перед хешированием.

  • Вы сравниваете коэффициенты соответствия в другой системе.

  • Вы пытаетесь добавить несколько идентификаторов пользователей в один объект 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 .

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

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

,

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

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

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

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

  • Данные не хешировались перед загрузкой.

  • Данные были неправильно отформатированы перед хешированием.

  • Вы сравниваете коэффициенты соответствия в другой системе.

  • Вы пытаетесь добавить несколько идентификаторов пользователей в один объект 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 .

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

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