Регион и город распределения номера: как правильно интерпретировать результаты CarrierLookup

Руководство по использованию данных о географии распределения номеров без их ошибочного отождествления с местоположением пользователя.

Поля региона и города распределения номера описывают географический контекст, связанный с диапазоном телефонных номеров. В результатах CarrierLookup они не определяют местоположение человека, телефона или текущее сетевое подключение. Рассматривайте их как метаданные распределения, которые могут помочь сгруппировать записи для анализа данных. Эти поля могут оставаться пустыми даже при успешном выполнении запроса, а первоначальный оператор номера может отличаться от текущего поставщика услуг из-за переноса номера (MNP). Сохраняйте эти поля вместе с источником запроса и временем проверки, оставляйте пустые значения пустыми и используйте отдельные источники для любых задач, требующих точного адреса клиента или местоположения устройства.

Что описывает география распределения

Планы нумерации присваивают номера и диапазоны номеров в соответствии с административными правилами. Например, в североамериканской системе коды администратора плана нумерации Северной Америки определяют код зоны, префикс, операционную компанию и центр тарификации для назначенных кодов. Это информация о назначении, а не данные GPS-наблюдения. Поля country_code, region и city в CarrierLookup следует рассматривать в той же категории контекста распределения. На странице продукта Определение исходного оператора описана доступная информация об операторе и распределении номеров.

Полезно использовать внутреннее обозначение «регион распределения номера» вместо «регион клиента». Такая формулировка делает происхождение поля понятным при выгрузке в CRM или на панели мониторинга аналитика. Это также предотвращает ситуацию, когда команда неявно меняет суть решаемого вопроса. Если правило торговой территории основано на заявленном адресе клиента, следует использовать поле адреса, а не город распределения номера. Если специалист исследует, почему несколько записей имеют общий шаблон нумерации, поля распределения могут служить подходящим контекстом. Всегда уточняйте, на какой именно вопрос отвечает рабочий процесс, прежде чем использовать эти поля.

Почему значение города не является текущим местоположением

Номер может оставаться прежним, когда человек переезжает, меняет устройства или операторов. В рекомендациях FCC для потребителей поясняется, что клиент может сохранить номер при смене поставщика услуг в рамках переноса номера. Поэтому местоположение, связанное с назначением номера, не должно использоваться как наблюдение за текущим местоположением. Результат CarrierLookup не содержит GPS-координат, данных о перемещении устройства, адреса абонента или доказательств того, что устройство подключено в указанном месте. Даже если поле города содержит знакомое название, оно привязано к контексту распределения номера.

Это различие важно для практических рабочих процессов. Представитель службы поддержки может увидеть город распределения, который отличается от адреса доставки; само по себе это несоответствие не является поводом для отклонения адреса, указанного клиентом. Аналитик может агрегировать номера по региону распределения, чтобы понять структуру списка номеров; график должен быть соответствующим образом подписан. Специалист по борьбе с мошенничеством может использовать это поле как один из элементов контекста, но не может утверждать, что клиент «находится в» этом городе на основании результата. Отношение к полю как к атрибуту диапазона номеров, а не человека, предотвращает превращение полезной точки данных в ложное утверждение о личности.

Чтение региона и города в контексте остальных результатов

CarrierLookup предлагает синхронную одиночную проверку и синхронные множественные проверки для номеров в формате E.164, а также отдельный асинхронный продукт для массовой обработки файлов. Документированный результат включает исходного оператора, базового оператора, тип номера, код страны, регион и город. Для одиночной проверки завершенный результат может содержать пустые поля оператора. Пустые значения распределения означают, что для этих полей не было возвращено полезного значения; сами по себе они не доказывают, что номер является недействительным, неактивным или отключенным. Сохраняйте различие между завершенным поиском с пустыми полями и неудачным запросом или отклоненным форматом номера. Документация API содержит актуальный контракт.

В локальной промежуточной таблице сохраняйте отправленный номер E.164, продукт, время проверки и каждое возвращенное поле в отдельном столбце. Используйте отдельный столбец статуса импорта для ошибок парсинга и сопоставления. Не перезаписывайте ранее известный адрес клиента данными region или city. Если несколько исходных строк имеют один и тот же номер, разрешите их локальное сопоставление владельцу перед применением любого результата. Для массового вывода помните, что идентификатором являются цифры с кодом страны без ведущего знака плюс, используемого при вводе в реальном времени. Нормализуйте ключ сравнения для объединения, сохраняя при этом исходные входные и выходные строки для аудита.

Выбор безопасной группировки или проверки

Поле географии распределения может поддерживать отчет о распределении: подсчитайте, сколько проверенных номеров вернули определенный регион, сколько — город и сколько не имели полезного значения распределения. Это поможет команде проверить список телефонов, собранный из нескольких источников, или решить, какие записи требуют ручной очистки. Избегайте включения пустого региона в группу «неизвестная страна», если был возвращен код страны; каждое поле имеет свою доступность. Аналогично, поле города не должно переноситься в профиль местоположения на уровне человека.

Гипотетический пример показывает различие. Предположим, в строке CRM содержится город доставки, заявленный клиентом, а результат CarrierLookup содержит другой город распределения. Аналитик должен сохранить оба значения под отдельными метками и проводить расследование, только если рабочий процесс имеет для этого иные веские причины. Проверка не фиксировала переезд, мошеннический адрес или роуминг устройства. Если команде нужно провести региональную кампанию, она может использовать собственные проверенные данные о предпочтениях или адресах клиентов, а географию распределения оставить в качестве фонового контекста. Это делает результат полезным, не требуя выводов, которые он не может подтвердить.

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

Запись в словаре данных может предотвратить неправильное использование в будущем. Для region и city запишите: «география распределения диапазона номеров, возвращенная CarrierLookup; может быть пустой; не является местоположением клиента или устройства». Записывайте carrier как исходно назначенного оператора и отмечайте, что перенос номера может отделить это значение от текущего поставщика. Сохраняйте время проверки как время, когда команда проверила номер, а не время, когда номер был назначен или когда человек появился в этом районе. Это локальные метаданные и пояснения, а не дополнительные поля, гарантируемые продуктом.

В графиках и экспортах CSV используйте имена столбцов, такие как allocation_region и allocation_city в собственном преобразованном наборе данных команды. Сохраняйте доступ к необработанным полям продукта для сверки. Явно учитывайте пустые значения и публикуйте знаменатель для любого регионального распределения, поскольку график, который без предупреждения отбрасывает отсутствующие значения, может подразумевать необоснованную полноту данных. Проверяйте последующие объединения перед использованием поля для изменения записи. Метка города наиболее полезна, когда вопрос действительно касается распределения нумерации; для проверки адреса или определения текущего местоположения команде требуются другие доказательства.

Часто задаваемые вопросы

Сообщает ли поле региона, где живет человек?

Нет. Оно описывает географию распределения номера. Клиент может жить или работать в другом месте, а результат не содержит проверенного адреса. Храните любой заявленный клиентом или независимо проверенный адрес в отдельном поле и четко помечайте значение распределения в отчетах.

Что делать с пустым значением города?

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

Может ли перенос номера (MNP) изменить интерпретацию поля оператора?

Да. CarrierLookup сообщает исходно назначенного оператора, а номер впоследствии может быть перенесен. Это значение исходного оператора остается контекстом распределения, а не доказательством того, какой поставщик обслуживает номер в данный момент. Сохраняйте исходное значение в словаре данных и используйте другой документированный источник для вопросов о текущей сети.

Узнайте больше

Выберите информацию о продукте, которая соответствует следующему шагу вашего рабочего процесса.

• Просмотреть документацию по продукту →
• Связаться с командой →