Эта страница переведена с помощью Cloud Translation API.

Срок выполнения и стоимость

В этом уроке рассматриваются:

Высокоуровневое описание того, какие варианты использования комиссий и времени выполнения поддерживаются.
Конкретные инструкции о том, как указать время выполнения заказа и комиссию для 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
    }
  }
}

Предупреждение. Не указывайте одновременно fulfillment_lead_time_duration и fulfillment_lead_time_duration_range как часть одного объекта action_link .

Примечание. fulfillment_lead_time_duration , fulfillment_lead_time_duration_range.min_duration , fulfillment_lead_time_duration_range.max_duration имеют тип google.protobuf.Duration и предоставляют пользователям расчетное время выполнения для их действия.

Указание комиссий через фиды

Как и в случае со временем выполнения заказа, сборы могут быть включены в сообщение 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"
      }
    }
  }
]

Примечание. Записи amount и amount_range имеют тип google.type.Money

Точность комиссии и времени выполнения

Точность комиссии

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

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

Если вы не уверены в том, что конкретно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.

Точность сроков выполнения заказа

Мы понимаем, что особенности сроков выполнения заказов меняются в зависимости от множества факторов. Эти факторы включают в себя:

Изменения времени выполнения заказа в зависимости от размера заказа
Изменения времени выполнения заказа в зависимости от времени завершения заказа и оформления заказа.
Задержка между обновлениями времени выполнения заказа через каналы
Адрес доставки пользователя.

Любой из этих факторов может привести к ситуациям, когда время выполнения заказа, отображаемое пользователю изначально, не будет точным временем выполнения, которое он увидит при оформлении заказа. Целью реализации времени выполнения является не полное их устранение, а предоставление пользователям четкой информации как можно чаще.

Ожидается, что партнеры обеспечат реализацию, которая приведет к тому, что пользователи будут видеть точное время выполнения как можно чаще и приложит все усилия. Если из-за этих факторов существует значительная изменчивость сроков, мы предлагаем вам указать диапазон времени, охватывающий эту изменчивость. Кроме того, если время выполнения меняется из-за деталей заказа, это должно быть ясно показано пользователям, когда они появятся в вашем потоке заказов.