Indicateurs de suivi des commandes

Les indicateurs de suivi des commandes vous permettent de fournir à Google l'historique de vos données de suivi des commandes passées sur le site d'un marchand. Les acheteurs bénéficient ainsi d'estimations plus précises concernant les délais de livraison. Les indicateurs de suivi des commandes vous permettent également d'améliorer vos fiches en ajoutant des annotations de livraison gratuite et rapide.

Vous pouvez envoyer des données concernant les commandes passées sur le site d'un marchand et via Acheter sur Google. Les données que vous envoyez complètent les informations de configuration de livraison que vous avez fournies lors de la configuration de votre compte Merchant Center. Par exemple, si vous indiquez aux acheteurs des délais de livraison estimés de trois à sept jours, mais que l'historique des commandes passées récemment montre que vos commandes arrivent généralement sous trois jours dans certaines régions, Google peut mettre à jour vos fiches pour fournir une estimation plus précise aux acheteurs.

Ce guide explique comment utiliser le service ordertrackingsignals pour envoyer l'historique de vos données de suivi des commandes.

Utiliser le service ordertrackingsignals

Le service ordertrackingsignals inclut un seul point de terminaison create, qui vous permet d'envoyer l'historique de vos données de suivi des commandes. Envoyez uniquement des données concernant les commandes qui ont été livrées afin que nous puissions vérifier les délais de livraison. Vous ne pouvez envoyer qu'une commande par requête. Dans le corps de la requête, vous pouvez envoyer les informations suivantes :

  • Des informations sur la commande, y compris son ID et ses date et heure de création, le code postal de livraison et le code de région.
  • Les frais de port facturés à l'acheteur (customer_shipping_fee).
  • Des informations sur la livraison (shippingInfo), y compris le transporteur, le numéro de suivi, l'origine, la destination et les délais de livraison pour chaque colis associé à la commande.
  • Des informations détaillées sur la commande (lineItems), y compris les produits commandés.
  • La mise en correspondance des articles et des colis de la commande (shipment_line_item_mapping).

  • L'ID du marchand pour lequel vous envoyez des données (merchant_id). Ce champ est facultatif et vous permet de fournir des données pour le compte d'un autre marchand. Si vous n'indiquez aucune valeur pour ce champ, les données sont associées au compte qui les envoie.

Pour en savoir plus sur les champs obligatoires et facultatifs de suivi des commandes, consultez la documentation de référence de la ressource ordertrackingsignals.

Envoyer de nouvelles données d'indicateurs de suivi des commandes

Voici un exemple de requête permettant d'envoyer de nouvelles données de suivi des commandes :

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"
}

Mettre à jour les données existantes d'indicateurs de suivi des commandes

Pour modifier les données de suivi des commandes déjà envoyées, envoyez une requête contenant de nouvelles données avec le même orderId. Pour les estimations de livraison et la mention de livraison gratuite et rapide, seules les données les plus récemment envoyées pour chaque orderId sont utilisées.