Продвинутое формирование ссылок на заказ

Чтобы перенаправить пользователя на сайт или в мобильное приложение, необходимо сформировать ссылку, которая содержит параметры поездки. После перехода по такой ссылке пользователь увидит построенный маршрут поездки и сможет заказать такси.

Ссылка по умолчанию ведет в приложение, если оно установлено у пользователя. Если приложение не установлено, то дальнейшее поведение ссылки определяется связкой параметров app_code и appmetrica_tracking_id:

Использование ссылок позволяет собирать статистику заказов. Для получения статистики по вашим заказам напишите на taxi-api@yandex-team.ru.

Формат ссылки

https://<app_code>.redirect.appmetrica.yandex.com/route?
start-lat=<широта>
&start-lon=<долгота>
&end-lat=<широта>
&end-lon=<долгота>
&tariffClass=<тариф>
&ref=<источник>
&appmetrica_tracking_id=<идентификатор_перенаправления>
&lang=<язык>

Параметры:

app_code

Идентификатор сервиса, приложение которого необходимо открыть. Обязательный параметр. Значение параметра для приложения Яндекс Go: 3
Если на устройстве пользователя приложение не установлено, логика редиректа определяется параметром appmetrica_tracking_id.

start-lat

Широта точки отправления. Необязательный параметр. Используется совместно с параметром start-lon.

start-lon

Долгота точки отправления. Необязательный параметр. Используется совместно с параметром start-lat.

end-lat

Широта точки назначения. Необязательный параметр. Используется совместно с параметром end-lon.

end-lon

Долгота точки назначения. Необязательный параметр. Используется совместно с параметром end-lat.

tariffClass

Текстовый идентификатор тарифа. Совпадает со значениями class в запросах к API и ответом API в поле class_name. Необязательный параметр. Доступен только при указании начальной или конечной точек маршрута.

ref

Идентификатор источника. В данном параметре передается идентификатор партнерской программы, или, если его нет, название вашего ресурса. Значение в данном параметре должно содержать только латинские символы. Например, для ресурса mywebsite.ru можно передавать идентификатор mywebsiteru.

appmetrica_tracking_id

Идентификатор, который определяет логику редиректа. Обязательный параметр.
Если у пользователя уже стоит приложения Яндекс Go, то ссылка сработает как deeplink и отправит пользователя в приложение.

Возможные значения зависят от сервиса (который указан в параметре app_code) и назначения редиректа:

Сервис	Перенаправление	Значение параметра app_code	Значение параметра appmetrica_tracking_id
Яндекс Go	Страница приложения Яндекс Go в магазине приложений	3	1178268795219780156
Яндекс Go	Сайт Яндекс Go	3	25395763362139037

Например, если вы хотите перенаправить пользователя, который заходит с мобильного устройства на страницу приложения Яндекс Go в магазине приложений, вам необходимо указать следующие параметры:

https://3.redirect.appmetrica.yandex.com/route?start-lat=55.73400123907955&start-lon=37.588533418821726&end-lat=55.76776211471192&end-lon=37.60714921124336&tariffClass=econom&ref=yoursiteru&appmetrica_tracking_id=1178268795219780156

Пример ссылки

Ссылка для поездки с точкой отправления Москва, улица Льва Толстого, 16 и точкой назначения Москва, улица Малая Дмитровка, 6 для сервиса Яндекс Go выглядит следующим образом:

https://3.redirect.appmetrica.yandex.com/route?start-lat=55.73400123907955&start-lon=37.588533418821726&end-lat=55.76776211471192&end-lon=37.60714921124336&tariffClass=econom&ref=mywebsiteru&appmetrica_tracking_id=1178268795219780156

https://3.redirect.appmetrica.yandex.com/route?start-lat=55.73400123907955&start-lon=37.588533418821726&end-lat=55.76776211471192&end-lon=37.60714921124336&tariffClass=econom&ref=yoursiteru&appmetrica_tracking_id=1178268795219780156