Questo tutorial illustra:
- Una descrizione generale dei casi d'uso di tariffe e tempi di evasione degli ordini supportati.
- Istruzioni specifiche su come specificare il tempo di evasione degli ordini e le commissioni per
action_link
nei tuoi feed - Aspettative relative alla precisione
Per un esempio di feed completo che mostra l'utilizzo del tempo di evasione degli ordini e delle commissioni, consulta l'esempio di EPA relativo al reindirizzamento degli ordini.
Casi d'uso relativi a tariffe e tempi di evasione degli ordini
Casi d'uso relativi alle tariffe
Forniamo diversi modi per specificare le tariffe. I punti riportati di seguito descrivono i diversi casi d'uso supportati, insieme ad alcuni linguaggi di esempio simili a quello che l'utente vedrà nel front-end.
- Tariffa fissa: "Commissione di consegna 5 €" o "Commissione di servizio 5 €"
- Tariffa percentuale: "Commissione di consegna 5%" o "Commissione di servizio 5%"
- Intervalli di commissioni: "Commissioni di consegna 2-10 $" o "Commissioni di servizio 3%-6%"
- Intervalli aperti: "Commissioni di consegna a partire dal 5%" o "Commissioni di servizio fino a 20 $"
Come mostrato negli esempi precedenti, le commissioni possono essere specificate come commissione di consegna o commissione di servizio. È anche possibile specificare più commissioni (ad es. "Commissione di servizio 5%-10%, Commissione di consegna 5 €").
Non sono supportati i casi d'uso che richiedono l'aggiornamento delle tariffe nel corso della giornata o la modifica in base alle informazioni sull'utente.
Casi d'uso relativi al tempo di evasione degli ordini
Sono ammessi diversi formati per specificare il tempo di disponibilità, in modo da garantire l'accuratezza dei dati forniti. I punti riportati di seguito descrivono i diversi casi d'uso supportati, insieme ad alcuni esempi di linguaggio simile a quello che l'utente vedrà nel front-end.
- Tempi fissi: "Consegna tra 30 minuti" o "Ritiro tra 15 minuti"
- Intervalli di tempo: "Consegna tra 30 minuti e 1 ora" o "Ritiro tra 15-20 minuti"
- Intervalli di tempo non disponibili: "Consegna tra più di 10 minuti" o "Ritiro in meno di 1 ora"
I tempi di evasione possono essere specificati sia per il ritiro che per la consegna utilizzando un formato comune (descritto di seguito). Come mostrato negli esempi precedenti, il testo mostrato agli utenti rifletterà il tipo di evasione degli ordini specificato nel link all'azione.
Non sono supportati i casi d'uso che richiedono tempi di aggiornamento durante la giornata o di modifiche in base alle informazioni sull'utente.
Specificare il tempo di evasione degli ordini tramite i feed
La data e l'ora di evasione degli ordini per i collegamenti delle azioni è inclusa nel messaggio del feed del commerciante
action_link
nell'ambito del
campo
food_ordering_metadata
. Per ogni action_link
associato al commerciante, devi fornire le informazioni di evasione utilizzando uno dei percorsi di messaggio.
Tempo di evasione degli ordini fisso
Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration
Questo messaggio deve essere nel seguente formato:
{ "fulfillment_lead_time_duration": { "seconds" : 1800 } }
Tempo di completamento intervallo
Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range
Questo messaggio deve avere il seguente formato:
{ "fulfillment_lead_time_duration_range": { "min_duration": { "seconds" : 1800 }, "max_duration": { "seconds" : 2400 } } }
Specificare le tariffe tramite i feed
Analogamente all'ora di evasione dell'ordine, le tariffe possono essere incluse nel messaggio action_link
nel campo food_ordering_metadata
. Per ogni action_link
associato a un commerciante, puoi fornire informazioni sulla tariffa utilizzando il percorso del messaggio:
merchant.action_link.food_ordering_metadata.fee_details
- Una tariffa di consegna fissa di 1,99 $:
[ { "type": "DELIVERY", "fee_amount": { "amount": { "currency_code": "USD", "units": "1", "nanos": "990000000" } } } ]
- Una commissione di consegna percentuale del 5,6%.
[ { "type": "DELIVERY", "fee_amount": { "cart_percentage": { "value": "5.6" } } } ]
- La commissione di servizio è compresa tra 1,99 $e 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" } } } } ]
- La percentuale di commissione di servizio è compresa tra 1,2% e 2,7%
[ { "type": "SERVICE", "fee_amount": { "cart_percentage": { "value_range": { "min_value": "1.2", "max_value": "2.7" } } } } ]
- Due commissioni, una commissione di servizio di 5 $e una commissione di consegna dell'1, 2%.
[ { "type": "SERVICE", "fee_amount": { "amount": { "currency_code": "USD", "units": "5", "nanos": "0" } } }, { "type": "DELIVERY", "fee_amount": { "cart_percentage": { "value": "1.2" } } } ]
Precisione di commissioni e tempi di evasione degli ordini
Accuratezza della commissione
Quando fornisci dati sulle commissioni a un commerciante, ci aspettiamo che tu fornisca una rappresentazione accurata delle tue commissioni. Devi includere tutte le commissioni di servizio e di consegna che possono essere applicate a un ordine.
Siamo consapevoli che le tariffe possono variare nel tempo e in base all'utente. Per questo motivo, offriamo la possibilità di specificare le tariffe come intervalli, inclusi intervalli aperti. Nei casi in cui le tariffe possano variare in modo significativo, assicurati che l'intervallo fornito includa le tariffe che un utente potrebbe visualizzare durante la transazione.
Se hai dubbi su quali siano i requisiti specifici del tuo caso, rivolgiti al tuo contatto del Centro azioni.
Precisione dei tempi di evasione degli ordini
Sappiamo che le specifiche relative al tempo di evasione degli ordini cambiano in base a una serie di fattori. Questi fattori includono:
- Modifiche all'ora di evasione degli ordini in base al volume
- Modifiche all'ora di evasione dell'ordine in base ai tempi di completamento dell'ordine e del pagamento
- Latenza tra il momento in cui le modifiche all'ora di evasione degli ordini vengono aggiornate tramite i feed
- L'indirizzo di consegna dell'utente.
Ognuno di questi fattori può portare a situazioni in cui l'ora di evasione dell'ordine mostrata inizialmente all'utente non corrisponde all'ora esatta di evasione che vedrà al momento del pagamento. L'obiettivo dell'implementazione del tempo di evasione non è eliminarli completamente, ma fornire agli utenti informazioni chiare il più spesso possibile.
I partner sono tenuti a fornire un'implementazione che consenta di mostrare agli utenti i tempi di evasione degli ordini accurati il più spesso possibile e nel modo migliore possibile. Se esiste una significativa variabilità dei tempi a causa di questi fattori, ti suggeriamo di fornire un intervallo di orari che comprendano questa variabilità. Inoltre, se l'orario di evasione cambia a causa dei dettagli dell'ordine, dovrebbe essere mostrato in modo chiaro agli utenti al momento dell'arrivo nel flusso di ordinazione.
Se hai dubbi in merito ai requisiti specifici del caso, rivolgiti al tuo contatto del Centro azioni.