В этом уроке рассматриваются:
- Высокоуровневое описание того, какие варианты использования комиссий и времени выполнения поддерживаются.
- Конкретные инструкции о том, как указать время выполнения заказа и комиссию для
action_link
(s) в ваших лентах. - Ожидания от точности
Полный образец фида, показывающий использование времени выполнения заказа и сборов, см. в примере перенаправления заказов EPA .
Варианты использования комиссий и времени выполнения
Варианты использования комиссии
Мы предоставляем несколько различных способов указания комиссий. В приведенных ниже пунктах описаны различные поддерживаемые варианты использования, а также примеры языка, похожего на то, что пользователь увидит во внешнем интерфейсе.
- Фиксированная комиссия: «Комиссия за доставку — 5 долларов США» или «Комиссия за обслуживание — 5 долларов США».
- Процентная комиссия: «Комиссия за доставку 5%» или «Комиссия за обслуживание 5%».
- Диапазон комиссий: «Комиссия за доставку 2–10 долларов США» или «Комиссия за обслуживание 3–6%».
- Открытые диапазоны: «Комиссия за доставку начинается от 5%» или «Комиссия за обслуживание до 20 долларов США».
Как показано в примерах выше, комиссии могут быть указаны как плата за доставку или плата за услугу. Также можно указать несколько комиссий (например, «Комиссия за услугу 5%-10%, плата за доставку 5 долларов США»).
Не поддерживаются варианты использования, требующие обновления сборов в течение дня или изменения в зависимости от информации о пользователе.
Варианты использования времени выполнения
Мы допускаем несколько различных форматов указания времени доступности, чтобы гарантировать предоставление точных данных. В приведенных ниже пунктах описаны различные поддерживаемые варианты использования, а также примеры языка, похожего на то, что пользователь увидит во внешнем интерфейсе.
- Фиксированное время: «Доставка через 30 минут» или «Самовывоз через 15 минут».
- Диапазоны времени: «Доставка через 30 минут–1 час» или «Самовывоз через 15–20 минут».
- Открытые временные диапазоны: «Доставка более 10 минут» или «Самовывоз менее 1 часа».
Время выполнения может быть указано как для самовывоза, так и для доставки, используя общий формат (описанный ниже). Как показано в примерах выше, текст, отображаемый пользователям, будет отражать тип выполнения , указанный в ссылке действия.
Не поддерживаются варианты использования, требующие обновления времени в течение дня или изменения в зависимости от информации о пользователе.
Указание времени выполнения заказа через фиды
Время выполнения заказа для ссылок на действия включено в сообщение action_link
фида продавца как часть поля food_ordering_metadata
. Для каждой action_link
связанной с продавцом, вам необходимо предоставить информацию о выполнении, используя один из путей сообщения.
Фиксированное время выполнения
-
Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration
Эти сообщения должны быть в следующем формате:
{ "fulfillment_lead_time_duration": { "seconds" : 1800 } }
Время выполнения диапазона
-
Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range
Это сообщение должно быть в следующем формате:
{ "fulfillment_lead_time_duration_range": { "min_duration": { "seconds" : 1800 }, "max_duration": { "seconds" : 2400 } } }
Указание комиссий через фиды
Как и в случае со временем выполнения заказа, сборы могут быть включены в сообщение action_link
в поле food_ordering_metadata
. Для каждой action_link
связанной с продавцом, вы можете предоставить информацию о комиссии, используя путь сообщения:
merchant.action_link.food_ordering_metadata.fee_details
- Фиксированная плата за доставку составляет $1,99:
[ { "type": "DELIVERY", "fee_amount": { "amount": { "currency_code": "USD", "units": "1", "nanos": "990000000" } } } ]
- Процентная плата за доставку составляет 5,6%.
[ { "type": "DELIVERY", "fee_amount": { "cart_percentage": { "value": "5.6" } } } ]
- Комиссия за обслуживание варьируется от 1,99 до 9,99 долларов США.
[ { "type": "SERVICE", "fee_amount": { "amount_range": { "min_amount": { "currency_code": "USD", "units": "1", "nanos": "990000000" }, "max_amount": { "currency_code": "USD", "units": "9", "nanos": "990000000" } } } } ]
- Процент комиссии за обслуживание варьируется от 1,2% до 2,7%.
[ { "type": "SERVICE", "fee_amount": { "cart_percentage": { "value_range": { "min_value": "1.2", "max_value": "2.7" } } } } ]
- Две комиссии, плата за обслуживание в размере 5 долларов США и плата за доставку в размере 1,2%.
[ { "type": "SERVICE", "fee_amount": { "amount": { "currency_code": "USD", "units": "5", "nanos": "0" } } }, { "type": "DELIVERY", "fee_amount": { "cart_percentage": { "value": "1.2" } } } ]
Точность комиссии и времени выполнения
Точность комиссии
Когда вы предоставляете данные о комиссиях для продавца, мы ожидаем, что вы предоставите точное представление о ваших комиссиях. Вы должны включить все сборы за доставку и обслуживание, которые могут применяться к заказу.
Мы понимаем, что сборы могут меняться с течением времени и в зависимости от пользователя. По этой причине мы предлагаем возможность указывать комиссии в виде диапазонов, включая открытые диапазоны. В случаях, когда комиссии могут значительно различаться, убедитесь, что указанный диапазон включает комиссии, которые пользователь может видеть во время транзакции.
Если вы не уверены в том, что конкретно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.
Точность сроков выполнения заказа
Мы понимаем, что особенности сроков выполнения заказов меняются в зависимости от множества факторов. Эти факторы включают в себя:
- Изменения времени выполнения заказа в зависимости от размера заказа
- Изменения времени выполнения заказа в зависимости от времени завершения заказа и оформления заказа.
- Задержка между обновлениями времени выполнения заказа через каналы
- Адрес доставки пользователя.
Любой из этих факторов может привести к ситуациям, когда время выполнения заказа, отображаемое пользователю изначально, не будет точным временем выполнения, которое он увидит при оформлении заказа. Целью реализации времени выполнения является не полное их устранение, а предоставление пользователям четкой информации как можно чаще.
Ожидается, что партнеры обеспечат реализацию, которая приведет к тому, что пользователи будут видеть точное время выполнения как можно чаще и приложит все усилия. Если из-за этих факторов существует значительная изменчивость сроков, мы предлагаем вам указать диапазон времени, охватывающий эту изменчивость. Кроме того, если время выполнения меняется из-за деталей заказа, это должно быть ясно показано пользователям, когда они появятся в вашем потоке заказов.
Если вы не уверены в том, что именно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.