Indicadores de rastreamento de pedidos

Os indicadores de rastreamento de pedidos permitem que você forneça ao Google dados históricos de rastreamento de pedidos concluídos no site de um comerciante. Isso oferece aos compradores estimativas de frete mais precisas. Os indicadores de rastreamento de pedidos também permitem que você melhore suas listagens com anotações de frete rápido e sem custo financeiro.

É possível enviar dados de pedidos concluídos no site de um comerciante. Os dados enviados complementam as informações de configuração de frete fornecidas como parte da configuração da conta do Merchant Center. Por exemplo, se você fornecer aos compradores estimativas de frete de 3 a 7 dias, mas seu rastreamento de pedidos históricos recentes indicar que os pedidos normalmente chegam em 3 dias em algumas regiões, o Google poderá atualizar suas listagens para fornecer aos clientes uma estimativa mais precisa.

Este guia explica como usar o serviço ordertrackingsignals para enviar seus dados históricos de rastreamento de pedidos.

Usar o serviço ordertrackingsignals

O serviço ordertrackingsignals inclui um único endpoint create, que permite enviar seus dados históricos de rastreamento de pedidos. Envie apenas dados de pedidos que foram entregues para que possamos verificar os tempos de frete. É possível enviar um pedido por solicitação. No corpo da solicitação, você pode enviar as seguintes informações:

• Informações do pedido, incluindo o ID e o horário de criação, o código postal da entrega e o código telefônico regional
• Custo de frete cobrado do comprador (customer_shipping_fee)
• Informações de frete (shippingInfo), incluindo transportadora, rastreamento, origem, destino e tempos de frete para cada item associado ao pedido
• Informações dos itens de linha do pedido (lineItems), incluindo os produtos
• Um mapeamento dos itens de linha do pedido para os fretes (shipment_line_item_mapping)

• O ID do comerciante para o qual você está enviando dados (merchant_id). Esse campo é opcional e permite que você forneça dados em nome de outro comerciante. Se você não fornecer um valor para esse campo, os dados serão associados à conta que os enviar.

Para mais informações sobre os campos de rastreamento de pedidos obrigatórios e opcionais, consulte a documentação de referência do ordertrackingsignals recurso.

Enviar novos dados de indicadores de rastreamento de pedidos

Confira um exemplo de solicitação para enviar novos dados de rastreamento de pedidos:

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

Atualizar dados de indicadores de rastreamento de pedidos

Para modificar os dados de rastreamento de pedidos já enviados, envie uma solicitação que contenha novos dados com o mesmo orderId. Para estimativas de frete e selos de frete rápido e sem custo financeiro, apenas os dados enviados mais recentemente para cada orderId são usados.