In dieser Anleitung werden folgende Schritte erläutert:
- Eine allgemeine Beschreibung der Gebühr und Anwendungsfälle für die Auftragsausführung werden unterstützt
- Spezifische Anweisungen zur Angabe der Dauer der Auftragsabwicklung und der Gebühren für
action_link
in deinen Feeds - Erwartungen an die Genauigkeit
Ein vollständiges Feedbeispiel, das die Nutzung von Dauer und Gebühren für die Auftragsabwicklung zeigt, finden Sie in der EPA-Beispiel für Ordering Redirect:
Gebühr und Anwendungsfälle für die Auftragsausführung
Anwendungsfälle für Gebühren
Es gibt verschiedene Möglichkeiten, Gebühren anzugeben. Die folgenden Punkte beschreiben die verschiedenen Verwendungsmöglichkeiten: unterstützten Fällen sowie Beispielsprache, die dem Nutzer auf der Seite Frontend.
- Feste Gebühr: „Liefergebühr 5 €“ oder „Servicegebühr 5 €“
- Prozentuale Gebühr: „Liefergebühr 5 %“ oder „Servicegebühr 5 %“
- Gebührenbereiche: „Liefergebühren 2–10 €“ oder „Servicegebühren 3–6 %“
- Offener Bereich: „Liefergebühren beginnen bei 5 %“ oder „Servicegebühren bis zu 20 $“
Wie in den Beispielen oben gezeigt, können Gebühren entweder als Liefergebühr oder als Servicegebühr angegeben werden. Sie können auch mehrere Gebühren angeben, z.B. „Servicegebühr 5–10 %, Liefergebühr 5 €“.
Nicht unterstützt werden Anwendungsfälle, bei denen die Gebühren im Laufe des Tages aktualisiert oder geändert werden müssen basierend auf den Informationen über die Nutzenden.
Anwendungsfälle für die Auftragsausführung
Die Verfügbarkeitszeit kann in verschiedenen Formaten angegeben werden, damit Sie korrekte Daten liefern. Nachfolgend werden die verschiedenen unterstützten Anwendungsfälle beschrieben. mit Beispielsprache, die dem ähnelt, was der Nutzer im Frontend sieht.
- Feste Zeiten: „Wird in 30 Min. geliefert“ oder „Abholung in 15 Min.“
- Zeiträume: „Wird in 30 Min.–1 Std. geliefert“ oder „Abholung in 15–20 Minuten“
- Offener Zeitraum: „Wird in mehr als 10 Minuten geliefert“ oder „Abholung in weniger als 1 Std.“
Die Auftragsausführungszeit kann sowohl für Abhol- als auch für Lieferungen in einem gängigen Format angegeben werden. wie unten beschrieben. Wie in den Beispielen oben zu sehen ist, wird der Text, der Nutzern angezeigt wird, die Auftragsausführung Typ, der im Actionlink angegeben ist.
Nicht unterstützt werden Anwendungsfälle, bei denen die Zeiten im Laufe des Tages aktualisiert oder geändert werden müssen basierend auf den Informationen über die Nutzenden.
Auftragsausführungszeit über Feeds angeben
Die Auftragsausführungszeit für Aktionslinks ist im Händlerfeed enthalten
action_link
als Teil des
food_ordering_metadata
ein. Für jede
action_link
die mit dem Händler verknüpft sind, müssen Sie
mit einem der Nachrichtenpfade.
Feste Ausführungszeit
Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration
Diese Nachrichten sollten das folgende Format haben:
{ "fulfillment_lead_time_duration": { "seconds" : 1800 } }
Ausführungszeit des Bereichs
Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range
Diese Nachricht sollte das folgende Format haben:
{ "fulfillment_lead_time_duration_range": { "min_duration": { "seconds" : 1800 }, "max_duration": { "seconds" : 2400 } } }
Gebühren über Feeds angeben
Ähnlich wie bei der Abwicklung der Bestellung können Gebühren
Nachricht action_link
unter food_ordering_metadata
ein. Für jedes mit einem Händler verknüpfte action_link
können Sie Folgendes tun:
Gebühreninformationen mithilfe des Nachrichtenpfads angeben:
merchant.action_link.food_ordering_metadata.fee_details
- Feste Liefergebühr von 1,99 $:
[ { "type": "DELIVERY", "fee_amount": { "amount": { "currency_code": "USD", "units": "1", "nanos": "990000000" } } } ]
- Eine prozentuale Liefergebühr von 5,6%.
[ { "type": "DELIVERY", "fee_amount": { "cart_percentage": { "value": "5.6" } } } ]
- Die Servicegebühr liegt zwischen 1,99 $und 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" } } } } ]
- Der Prozentsatz der Servicegebühr liegt zwischen 1,2% und 2,7 %.
[ { "type": "SERVICE", "fee_amount": { "cart_percentage": { "value_range": { "min_value": "1.2", "max_value": "2.7" } } } } ]
- Zwei Gebühren, eine Servicegebühr von 5 $und eine Liefergebühr von 1, 2%.
[ { "type": "SERVICE", "fee_amount": { "amount": { "currency_code": "USD", "units": "5", "nanos": "0" } } }, { "type": "DELIVERY", "fee_amount": { "cart_percentage": { "value": "1.2" } } } ]
Gebühr und Genauigkeit der Ausführungszeit
Gebührengenauigkeit
Wenn Sie Gebührendaten für einen Händler angeben, erwarten wir von Ihnen, dass Sie genau angeben, Ihrer Gebühren. Geben Sie alle Liefer- und Servicegebühren an, die für eine Bestellung anfallen können.
Uns ist bewusst, dass Gebühren im Laufe der Zeit und je nach Nutzer variieren können. Aus diesem Grund bieten wir die Möglichkeit, Gebühren als Bereiche anzugeben, einschließlich offener Bereiche. In Fällen, in denen Gebühren variieren können müssen Sie deutlich darauf achten, dass der angegebene Bereich die Gebühren umfasst, die für den Nutzer anfallen, ihre Transaktion durchführen.
Wenn Sie sich nicht sicher sind, was genau in Ihrem Fall erforderlich ist, wenden Sie sich an Ihren Actions Center-Kontakt.
Genauigkeit der Zeit für die Auftragsausführung
Uns ist bewusst, dass die Besonderheiten der Auftragsabwicklung basierend auf einer Vielzahl von Faktoren. Diese Faktoren umfassen:
- Änderungen an der Dauer der Auftragsabwicklung je nach Bestellumfang
- Änderungen der Dauer der Auftragsabwicklung basierend auf der Zeit, die zum Abschließen der Bestellung benötigt wird Bezahlvorgang
- Latenz zwischen der Aktualisierung von Änderungen an der Auftragsausführung über Feeds
- Die Lieferadresse des Nutzers.
Jeder dieser Faktoren kann dazu führen, dass die Ausführung der Bestellung Zeit, die dem Nutzer anfänglich angezeigt wird, entspricht nicht dem genauen Zeitpunkt, zu dem er angezeigt wird. Das Ziel der Implementierung ist diese vollständig zu entfernen, sondern den Nutzenden klare Informationen und zwar so oft wie möglich.
Partner müssen eine Implementierung vornehmen, die zu präzisen Ausführungszeit wird Nutzern so oft wie möglich angezeigt, soweit dies möglich ist zu verstehen. Wenn es aufgrund dieser Faktoren erhebliche zeitliche Schwankungen gibt, schlagen wir vor, geben Sie einen Zeitraum an, der diese Variabilität umfasst. Wenn sich die Zeit für die Auftragsausführung aufgrund von Bestelldetails ändert, Dies sollte Nutzern bei der Lieferung während des Bestellvorgangs deutlich angezeigt werden.
Wenn Sie sich nicht sicher sind, in Ihrem Fall erforderlich ist, wenden Sie sich an Ihren Actions Center-Ansprechpartner.