Indicadores de rastreamento de pedidos

Os indicadores de rastreamento de pedidos permitem que você forneça ao Google seus dados históricos de rastreamento de pedidos para 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 melhorar suas listagens com notas de frete rápido e sem custo financeiro.

Você pode enviar dados de pedidos concluídos no site de um comerciante. Os dados enviados complementam as informações de configuração de frete que você fornece como parte da configuração da sua conta do Merchant Center. Por exemplo, se você fornecer aos compradores estimativas de frete de três a sete dias, mas o histórico de rastreamento de pedidos recente indicar que seus pedidos normalmente chegam em três dias em algumas regiões, o Google poderá atualizar suas informações do produto para fornecer aos clientes uma estimativa mais precisa.

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

Usar o serviço ordertrackingsignals

O serviço ordertrackingsignals inclui um único endpoint create, que permite enviar os dados históricos de rastreamento de pedidos. Envie somente dados de pedidos que foram entregues. Assim, podemos verificar os tempos de envio. É possível enviar um pedido por solicitação. No corpo da solicitação, é possível enviar as seguintes informações:

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

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

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

Enviar novos dados de códigos de rastreamento de pedidos

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

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 códigos de rastreamento de pedidos

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