Indicadores de rastreamento de pedidos

Com os indicadores de rastreamento de pedidos, você fornece 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 e acuradas. Os indicadores de rastreamento de pedidos também permitem melhorar suas listagens com anotações de frete grátis e rápido.

É 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 entrega de 3 a 7 dias, mas o rastreamento histórico de pedidos recentes indicar que os pedidos geralmente chegam em 3 dias em algumas regiões, o Google poderá atualizar suas informações para fornecer aos clientes uma estimativa mais precisa.

Neste guia, explicamos 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 acompanhamento de pedidos. Envie apenas dados de pedidos que já foram entregues para que possamos verificar os prazos de entrega. É possível enviar um pedido por solicitação. No corpo da solicitação, você pode enviar as seguintes informações:

• informações do pedido, como ID, horário de criação, código postal da entrega e 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 prazos de entrega 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 envios do pedido (shipment_line_item_mapping)

• O ID do comerciante para quem 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 enviou.

  Observação: você precisa estar habilitado para enviar dados em nome de outro comerciante. Para solicitar acesso, entre em contato com [e-mail].

Para mais informações sobre os campos obrigatórios e opcionais de rastreamento de pedidos, 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 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 códigos de rastreamento de pedidos

Para modificar 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 rápidos e sem custo financeiro, apenas os dados enviados mais recentemente para cada orderId são usados.