Gli indicatori di monitoraggio degli ordini ti consentono di fornire a Google i dati storici di monitoraggio degli ordini per gli ordini completati tramite il sito di un commerciante. In questo modo, gli acquirenti possono usufruire di stime di spedizione più precise. Gli indicatori di monitoraggio degli ordini ti consentono inoltre di migliorare le tue schede con le annotazioni relative alla spedizione rapida e senza costi.
Puoi inviare i dati relativi agli ordini completati tramite il sito di un commerciante. I dati che invii completano le informazioni di configurazione della spedizione che fornisci durante la configurazione del tuo account Merchant Center. Ad esempio, se fornisci agli acquirenti stime di spedizione di 3-7 giorni, ma il monitoraggio degli ordini storici recenti indica che i tuoi ordini in genere arrivano in 3 giorni in alcune regioni, Google può aggiornare le tue schede per fornire ai clienti una stima più precisa.
Questa guida spiega come utilizzare il servizio ordertrackingsignals per inviare i dati storici di monitoraggio degli ordini.
Utilizzare il servizio ordertrackingsignals
Il servizio ordertrackingsignals include un singolo endpoint create, che consente di inviare i dati storici di monitoraggio degli ordini. Invia solo i dati relativi agli ordini che sono stati consegnati, in modo che possiamo verificare i tempi di spedizione. Puoi inviare un solo ordine per richiesta. Nel corpo della richiesta puoi inviare le seguenti informazioni:
- Informazioni sull'ordine, tra cui ad esempio ID ordine, data e ora di creazione dell'ordine, codice postale di consegna e codice regione
- Costo di spedizione addebitato all'acquirente (
customer_shipping_fee) - Informazioni di spedizione (
shippingInfo), inclusi corriere, monitoraggio, origine, destinazione e tempi di spedizione di ogni spedizione associata all'ordine - Informazioni sulle voci dell'ordine (
lineItems), inclusi i prodotti inclusi nell'ordine - Una mappatura degli elementi pubblicitari dell'ordine alle spedizioni dell'ordine
(
shipment_line_item_mapping) L'ID commerciante del commerciante per cui stai inviando i dati (
merchant_id). Questo campo è facoltativo e ti consente di fornire i dati per conto di un altro commerciante. Se non fornisci un valore per questo campo, i dati vengono associati all'account che li invia.
Per ulteriori informazioni sui campi obbligatori e facoltativi per il monitoraggio degli ordini, consulta la documentazione di riferimento per la risorsa ordertrackingsignals.
Inviare nuovi dati degli indicatori di monitoraggio degli ordini
Ecco una richiesta di esempio per inviare nuovi dati di monitoraggio degli ordini:
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/ordertrackingsignals
{
"merchantId": "987654321",
"orderCreatedTime": {
"year": 2020,
"month": 1,
"day": 2,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"orderId": "123456789",
"shippingInfo": [
{
"shipmentId": "1",
"trackingId": "100",
"carrierName": "FEDEX",
"carrierServiceName": "GROUND",
"shippedTime": {
"year": 2020,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
},
{
"shipmentId": "2",
"earliestDeliveryPromiseTime": {
"year": 2020,
"month": 1,
"day": 4,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"latestDeliveryPromiseTime": {
"year": 2020,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"actualDeliveryTime": {
"year": 2020,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippedTime": {
"year": 2020,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
}
],
"lineItems": [
{
"lineItemId": "item1",
"productId": "online:en:US:item1",
"quantity": "3"
},
{
"lineItemId": "item2",
"productId": "online:en:US:item2",
"quantity": "5"
}
],
"shipmentLineItemMapping": [
{
"shipmentId": "1",
"lineItemId": "item1",
"quantity": "1"
},
{
"shipmentId": "2",
"lineItemId": "item1",
"quantity": "2"
},
{
"shipmentId": "1",
"lineItemId": "item2",
"quantity": "4"
},
{
"shipmentId": "2",
"lineItemId": "item2",
"quantity": "1"
}
],
"customerShippingFee": {
"value": "4.5",
"currency": "USD"
},
"deliveryPostalCode": "94043",
"deliveryRegionCode": "US"
}
Aggiornare i dati degli indicatori di monitoraggio degli ordini esistenti
Per modificare i dati di monitoraggio degli ordini già inviati, invia una richiesta contenente nuovi dati con lo stesso orderId. Per le stime di spedizione e i badge di spedizione rapida e senza costi, vengono utilizzati solo i dati inviati più di recente per ogni orderId.