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

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

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

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

Вероятность совпадения ваших запросов может быть ниже ожидаемой по ряду причин, в том числе:

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

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

  • Вы сравниваете показатели совпадений с показателями в другой системе.

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

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

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

Обратите внимание, что размер списка и коэффициент соответствия отражают разные значения. Коэффициент соответствия учитывает всех пользователей с учетной записью 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 Эта ошибка возникает, если ваш токен разработчика ранее не отправлял запросы на сопоставление клиентов до 1 апреля 2026 года. Вместо этого для рабочих процессов сопоставления клиентов необходимо использовать API Data Manager .

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

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