Indicatori di monitoraggio dell'ordine

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 avere stime di spedizione più precise e accurate. Gli indicatori di monitoraggio degli ordini ti consentono anche di migliorare le tue schede con annotazioni relative alla spedizione rapida e senza costi.

Puoi inviare i dati sia per gli ordini completati tramite il sito di un commerciante sia tramite Acquista su Google. I dati che invii si integrano con le informazioni sulla configurazione della spedizione che fornisci durante la creazione dell'account Merchant Center. Ad esempio, se fornisci agli acquirenti una stima di spedizione di 3-7 giorni, ma i dati storici recenti del monitoraggio degli ordini indicano che in alcune regioni i tuoi ordini arrivano in genere entro 3 giorni, 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 relativi al monitoraggio degli ordini.

Utilizza il servizio ordertrackingsignals

Il servizio ordertrackingsignals include un singolo endpoint create, che ti consente di inviare i dati storici relativi al monitoraggio degli ordini. Invia i dati solo per gli 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 ID ordine e ora di creazione dell'ordine, il codice postale di consegna e il codice regione
  • Costo di spedizione addebitato all'acquirente (customer_shipping_fee)
  • Informazioni di spedizione (shippingInfo), che includono corriere, monitoraggio, origine, destinazione e tempi di spedizione per ogni spedizione associata all'ordine
  • Informazioni sulle voci dell'ordine (lineItems), inclusi i prodotti inclusi nell'ordine
  • Una mappatura delle voci dell'ordine alle spedizioni degli ordini (shipment_line_item_mapping)

  • L'ID commerciante del commerciante per il quale stai inviando i dati (merchant_id). Questo campo è facoltativo e ti consente di fornire i dati per conto di un altro commerciante. Se non specifichi 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 sugli indicatori di monitoraggio degli ordini

Di seguito è riportato un esempio di richiesta per l'invio di 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 dati nuovi con lo stesso orderId. Per le stime di spedizione e i badge rapidi e senza costi vengono utilizzati solo i dati inviati più di recente per ogni orderId.