Questo tutorial illustra:
- Una descrizione generale dei casi d'uso relativi a commissioni e tempi di evasione degli ordini supportati
- Istruzioni specifiche su come specificare i tempi di evasione degli ordini e le commissioni per
action_link(i) nei tuoi feed - Aspettative relative all'accuratezza
Per un esempio completo di feed che mostra l'utilizzo del tempo di evasione degli ordini e delle commissioni, consulta Esempio di feed EPA per il reindirizzamento degli ordini.
Casi d'uso relativi a commissioni e tempi di evasione
Casi d'uso delle commissioni
Forniamo diversi modi per specificare le commissioni. I punti riportati di seguito descrivono i diversi casi d'uso supportati, insieme a un esempio di linguaggio simile a quello che l'utente vedrà nel front-end.
- Tariffa fissa: "Spedizione 5 €" o "Commissione di servizio 5 €"
- Commissione percentuale: "Commissione di consegna 5%" o "Commissione di servizio 5%"
- Fasce di tariffe: "Commissioni di consegna 2-10 $" o "Commissioni di servizio 3-6%"
- Fasce di prezzo aperte: "Le spese di consegna partono dal 5%" o "Commissioni di servizio fino a 20 $"
Come mostrato negli esempi precedenti, le tariffe possono essere specificate come tariffa di consegna o tariffa 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 durante il giorno o la loro modifica in base alle informazioni sull'utente.
Casi d'uso relativi al tempo di evasione
Consentiamo diversi formati per specificare l'ora di disponibilità per aiutarti a fornire dati accurati. I punti riportati di seguito descrivono i diversi casi d'uso supportati, insieme a un esempio di linguaggio simile a quello che l'utente vedrà nel front-end.
- Orari fissi: "Consegna tra 30 min" o "Ritira tra 15 min"
- Intervalli di tempo: "Consegna tra 30 min e 1 ora" o "Ritira tra 15-20 min"
- Intervalli di tempo aperti: "Consegna tra più di 10 minuti" o "Ritira entro meno di 1 ora"
L'orario di evasione dell'ordine può essere specificato sia per il ritiro sia per la consegna utilizzando un formato comune (descritto di seguito). Come mostrato negli esempi precedenti, il testo mostrato agli utenti riflette il tipo di evasione specificato nel link di azione.
Non sono supportati i casi d'uso che richiedono l'aggiornamento dei tempi durante la giornata o la loro modifica in base alle informazioni sull'utente.
Specificare il tempo di evasione dell'ordine tramite i feed
Il tempo di evasione degli ordini per i link di azioni è incluso nel messaggio del feed del commerciante
action_link, all'interno del campo
food_ordering_metadata. Per ogni
action_link
associato al commerciante, devi fornire informazioni sul completamento
utilizzando uno dei percorsi dei messaggi.
Tempo di evasione fisso
Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration
Questi messaggi devono avere il seguente formato:
{ "fulfillment_lead_time_duration": { "seconds" : 1800 } }
Tempo di evasione dell'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 commissioni tramite i feed
Come per il tempo di evasione dell'ordine, le commissioni possono essere incluse nel messaggio action_link nel campo food_ordering_metadata. Per ogni action_link associato a un commerciante, puoi fornire informazioni sulle commissioni 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" } } } ]
- Una 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" } } } } ]
- Una percentuale di commissione di servizio compresa tra l'1,2% e il 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 tariffe e tempi di evasione
Accuratezza delle commissioni
Quando fornisci i dati sulle commissioni per un commerciante, ci aspettiamo che tu fornisca una rappresentazione accurata delle commissioni. Devi includere tutte le commissioni di consegna e di servizio che potrebbero essere applicate a un ordine.
Siamo consapevoli che le commissioni possono variare nel tempo e in base agli utenti. Per questo motivo, offriamo la possibilità di specificare le commissioni come intervalli, inclusi quelli aperti. Nei casi in cui le commissioni possono variare in modo significativo, assicurati che l'intervallo fornito includa le commissioni che un utente potrebbe vedere durante la transazione.
Se hai dubbi su cosa è richiesto nel tuo caso specifico, contatta il tuo contatto di Actions Center.
Precisione del tempo di evasione dell'ordine
Siamo consapevoli che i tempi di evasione degli ordini cambiano in base a una serie di fattori. Questi fattori includono:
- Modifiche al tempo di evasione degli ordini in base alle dimensioni
- Modifiche al tempo di evasione dell'ordine in base al tempo necessario per completare l'ordine e il pagamento
- Latenza tra il momento in cui le modifiche del tempo 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 il tempo di evasione dell'ordine visualizzato inizialmente dall'utente non è il tempo esatto che vedrà al momento del pagamento. L'obiettivo dell'implementazione del tempo di evasione non è eliminare completamente questi problemi, ma fornire agli utenti informazioni chiare il più spesso possibile.
I partner devono fornire un'implementazione che consenta di mostrare agli utenti il tempo di evasione accurato il più spesso possibile, secondo il criterio del massimo impegno. Se la variabilità dei tempi è significativa a causa di questi fattori, ti consigliamo di fornire un intervallo di tempo che la includa. Inoltre, se i tempi di evasione cambiano a causa dei dettagli dell'ordine, questo deve essere mostrato chiaramente agli utenti quando arrivano nel flusso di ordinazione.
Se hai dubbi su cosa sia necessario nel tuo caso specifico, contatta il tuo contatto di Actions Center.