Генератор UULE для Google

Зачем нужен uule

Google учитывает, откуда пришёл запрос. По одному и тому же слову житель Омска и житель Москвы увидят разные сайты. Из-за этого проверить позиции чужого города, сидя в своём, обычным поиском не выйдет. Ad Preview Tool от Google показывает в основном рекламу и верхушку органики, а VPN и прокси дают регион приблизительно.

Здесь и выручает uule. Это закодированное местоположение, которое поисковик принимает прямо в адресе выдачи. Добавьте его к ссылке, и Google ответит так, будто запрос пришёл из нужного города:

https://www.google.com/search?q=купить+ноутбук&uule=w+CAIQICIUTW9zY293LE1vc2NvdyxSdXNzaWE

Как устроено значение

Внутри uule лежит короткое бинарное сообщение, упакованное в Base64. Собирается оно так:

1. берётся каноническое имя региона на английском из справочника геотаргетинга Google. Например, Moscow,Moscow,Russia или Omsk,Omsk Oblast,Russia;
2. к имени добавляются два служебных признака: роль (местоположение подтверждено пользователем) и источник данных. Они говорят поисковику, что геолокации можно доверять;
3. перед именем ставится байт с его длиной. Поэтому у названий разной длины значение начинается по-разному и подставить чужую строку наугад не получится;
4. всё вместе кодируется в Base64 и получает префикс w+.

Считать длину и искать нужный символ по таблице, как советуют старые инструкции, не нужно. Форма выше делает это сама и берёт правильное каноническое имя из базы. В ней 273 644 регионов Google, включая районы и аэропорты.

Чем uule отличается от ID региона

Эти два значения часто путают. ID региона — это номер записи в справочнике геотаргетинга, у Москвы он равен 1011969. ID нужен при работе через API парсинга Google: вы передаёте region=1011969, а сервер сам соберёт UULE и подставит страну. Найти номер можно на странице регионов Google.

UULE понимает сам поисковик в адресе выдачи. Он пригодится, когда вы открываете Google руками, настраиваете парсер или быстро проверяете гипотезу в браузере. В API его тоже можно передать явно, параметром uule, если хотите задать геолокацию своей строкой вместо справочника.

Регионы, которых нет в справочнике Google

Часть привычных нам территорий Google Ads не выделяет в отдельные геотаргеты: федеральных округов там нет совсем, а Крым и континенты не найти по обычному поиску. UULE для них мы собрали вручную, отталкиваясь от регионов Яндекса. Слева указан код региона Яндекса (lr), по которому мы сопоставляли территории.

Что делать, если городов много

Подставлять uule руками удобно для разовой проверки. Когда городов десятки, а запросов сотни, быстрее снимать выдачу через API. Метод /api/google принимает ID региона и отдаёт готовый JSON с позициями. Метод /api/google/xml возвращает тот же результат в формате Яндекс XML, его понимают Key Collector, TopSite и другие привычные программы. Страница выдачи стоит 0.01 ₽.

Частые вопросы