Indicatori di monitoraggio dell'ordine

Gli indicatori di monitoraggio degli ordini ti consentono di fornire a Google i dati storici di monitoraggio degli ordini completati tramite il sito di un commerciante. In questo modo, gli acquirenti ricevono stime di spedizione più precise e accurate. I segnali di monitoraggio degli ordini ti consentono anche di migliorare le tue schede con le annotazioni relative alla spedizione rapida e senza costi.

Puoi inviare i dati per gli ordini completati tramite il sito di un commerciante. I dati che invii integrano le informazioni di configurazione della spedizione che fornisci durante la configurazione dell'account Merchant Center. Ad esempio, se fornisci agli acquirenti stime di spedizione di 3-7 giorni, ma il monitoraggio storico recente degli ordini indica che i tuoi ordini arrivano in genere 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 di monitoraggio degli ordini storici.

Utilizza il servizio ordertrackingsignals

Il servizio ordertrackingsignals include un singolo endpoint create, che ti consente di inviare i dati storici di monitoraggio degli ordini. Invia solo i dati relativi agli ordini consegnati, in modo che possiamo verificare i tempi di spedizione. Puoi inviare un ordine per richiesta. Nel corpo della richiesta puoi inviare le seguenti informazioni:

• Informazioni sull'ordine, tra cui 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), tra cui 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 il quale stai inviando i dati (merchant_id). Questo campo è facoltativo e ti consente di fornire dati per conto di un altro commerciante. Se non fornisci un valore per questo campo, i dati vengono associati all'account che li invia.

  Nota :devi essere abilitato prima di poter inviare dati per conto di un altro commerciante. Per richiedere l'accesso, contattaci all'indirizzo [e-mail].

Per ulteriori informazioni sui campi di monitoraggio degli ordini obbligatori e facoltativi, consulta la documentazione di riferimento per la risorsa ordertrackingsignals.

Inviare nuovi dati sugli indicatori di monitoraggio dell'ordine

Ecco una richiesta di esempio per inviare nuovi dati di monitoraggio dell'ordine:

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 dell'ordine esistenti

Per modificare i dati di monitoraggio degli ordini già inviati, invia una richiesta che contenga nuovi dati con lo stesso orderId. Per le stime di spedizione e i badge spedizione rapida e senza costi, vengono utilizzati solo i dati inviati più di recente per ogni orderId.