In dieser Anleitung werden folgende Schritte erläutert:
- Allgemeine Beschreibung der unterstützten Anwendungsfälle für Gebühren und Ausführungszeit
- Spezifische Anleitungen zur Angabe der Dauer der Auftragsabwicklung und der Gebühren für Dienstfeeds.
- Erwartungen an die Genauigkeit
Ein vollständiges Feedbeispiel, das die Nutzung der Dauer der Auftragsabwicklung und der Gebühren zeigt, findest du im EPA-Beispiel für Ordering Redirect.
Gebühren
Es gibt verschiedene Möglichkeiten, Gebühren anzugeben. Beispiele:
- 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 %“
- Offene Bereiche „Liefergebühren beginnen bei 5 %“ oder „Servicegebühren bis zu 20 $“
Gebühren können als Liefer- oder 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 sich die Gebühren je nach Nutzerinformationen ändern müssen.
Gebührenbeispiele
Liefer- und Abholgebühren
Die Anwendung unterstützt die Gebührentypen „DELIVERY“ und „SERVICE“.Lieferservice
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Dienst
{
"fee": {
"fee_id": "12345/service_fee",
"fee_type": "SERVICE",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Verschiedene Gebührentypen
Im Folgenden findest du einige nutzerfreundliche Beispiele für die Angabe eines ausgewählten Gebührentyps.Fest
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Warenkorbprozentsatz
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"cart_percentage": {
"base_value": {
"currency_code": "USD",
"units": 3,
"nanos": 500000000
},
"percentage_of_cart_value": 10
},
"service_ids": [
"service/entity002"
]
}
}
Bereich
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"range_amount": {
"min_amount": {
"currency_code": "USD",
"units": 3,
"nanos": 500000000
},
"max_amount": {
"currency_code": "USD",
"units": 5,
"nanos": 600000000
}
},
"service_ids": [
"service/entity002"
]
}
}
Ausführungszeit
Für die Angabe der Verfügbarkeitszeit sind verschiedene Formate zulässig, damit Sie korrekte Daten angeben können. Im Folgenden werden die verschiedenen unterstützten Anwendungsfälle beschrieben. Außerdem finden Sie hier einige Beispielsprachen, die dem Nutzer auf dem Front-End ähneln.
- Feste Zeiten: „Lieferung in 30 Minuten“ oder „Abholung in 15 Minuten“
- Zeiträume: „Wird in 30 Min.–1 Std. geliefert“ oder „Abholung in 15–20 Min.“
Die Auftragsausführungszeit kann sowohl für Abholung als auch für Lieferung in einem gemeinsamen Format angegeben werden (siehe unten).
Nicht unterstützt werden Anwendungsfälle, bei denen sich die erweiterte Textanzeige je nach Nutzerinformationen ändern muss.
Beispiele für die Ausführungszeit
Die Auftragsausführungszeit für Aktionslinks ist in der Nachricht ETA im Dienstleistungsfeed im Feld FoodOrderingService enthalten.
Fest
{
"service": {
"service_id": "service-id",
"service_type": "TAKEOUT",
"parent_entity_id": "entity-id",
"lead_time": {
"min_lead_time_duration": "900s"
},
"action_link_id": "action-link-id"
}
},
Zeitraum
{
"service": {
"service_id": "service-id",
"service_type": "TAKEOUT",
"parent_entity_id": "entity-id",
"lead_time": {
"min_lead_time_duration": "900s"
"max_lead_time_duration": "1200s"
},
"action_link_id": "action-link-id"
}
},
Genauigkeit der Angaben zu Gebühren und Auftragsausführung
Gebührengenauigkeit
Wenn du Gebührendaten für einen Händler angibst, erwarten wir von dir, dass du diese korrekt darstellst. 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. Wenn die Gebühren erheblich variieren können, solltest du darauf achten, dass die angegebene Spanne auch die Gebühren umfasst, die einem Nutzer während der Transaktion berechnet werden können.
Wenn Sie nicht sicher sind, was genau in Ihrem Fall erforderlich ist, wenden Sie sich an Ihren Actions Center-Ansprechpartner.
Genauigkeit der Zeit für die Auftragsausführung
Uns ist bewusst, dass sich die Besonderheiten der Dauer der Auftragsabwicklung aufgrund einer Vielzahl von Faktoren ändern. Diese Faktoren umfassen:
- Änderungen an der Dauer der Auftragsabwicklung je nach Bestellumfang
- Änderungen der Dauer der Auftragsabwicklung basierend auf der Zeit bis zum Abschluss der Bestellung und des Bezahlvorgangs
- Latenz zwischen der Aktualisierung von Änderungen an der Auftragsausführung über Feeds
- Die Lieferadresse des Nutzers.
Alle diese Faktoren können dazu führen, dass die dem Nutzer anfänglich angezeigte Zeit für die Auftragsausführung nicht exakt mit der Zeit übereinstimmt, die der Nutzer an der Kasse sieht. Das Ziel der Implementierung der Auftragsausführungszeit besteht nicht darin, diese vollständig zu eliminieren, sondern den Nutzern so oft wie möglich klare Informationen zur Verfügung zu stellen.
Von Partnern wird erwartet, dass sie eine Implementierung bereitstellen, die dazu führt, dass Nutzern die genaue Auftragsausführungszeit so oft wie möglich und auf Best-Effort-Basis angezeigt wird. Wenn es aufgrund dieser Faktoren zu erheblichen zeitlichen Schwankungen kommt, empfehlen wir, einen Zeitraum anzugeben, in dem diese Variabilität berücksichtigt wird. Wenn sich die Dauer der Auftragsausführung aufgrund von Bestelldetails ändert, sollte dies den Nutzern bei der Ankunft im Bestellablauf deutlich angezeigt werden.
Wenn Sie sich nicht sicher sind, was genau in Ihrem Fall erforderlich ist, wenden Sie sich an Ihren Actions Center-Ansprechpartner.
Rechtzeitige Aktualisierungen von Gebühren und voraussichtlichen Ankunftszeiten
Die Verarbeitung von Änderungen mit einem normalen Feedupload kann mindestens zwei Stunden dauern. Das ist besonders wichtig, wenn Sie Ihre ETA häufig ändern möchten.
Partnern wird dringend empfohlen, Echtzeitaktualisierungen zu implementieren, die es einem API-Aufruf ermöglichen, den Dienstfeed (einschließlich Gebühren und voraussichtliche Ankunftszeiten) innerhalb von maximal 5 Minuten zu ändern.