Indicadores de rastreamento de pedidos

Com os indicadores de rastreamento de pedidos, você pode fornecer ao Google dados históricos de rastreamento de pedidos concluídos no site de um comerciante. Isso fornece estimativas de frete mais precisas aos compradores. Os indicadores de rastreamento também permitem aprimorar suas listagens com anotações de envio rápido e sem custo financeiro.

Você pode enviar dados de pedidos concluídos no site de um comerciante e pelo Comprar com o Google. Os dados enviados complementam as informações de configuração de frete fornecidas como parte da configuração da sua conta do Merchant Center. Por exemplo, se você fornecer aos compradores estimativas de frete de 3 a 7 dias, mas o histórico recente de rastreamento indicar que os pedidos geralmente chegam em três dias em algumas regiões, o Google poderá atualizar suas listagens 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 dados históricos de rastreamento de pedidos. Envie dados apenas de pedidos que já foram entregues, para que possamos verificar os tempos de envio. É possível enviar um pedido por solicitação. No corpo da solicitação, envie as seguintes informações:

  • informações do pedido, incluindo o código e o horário de criação do pedido, o CEP de entrega e o 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 de cada item associado ao pedido
  • Informações do item de linha do pedido (lineItems), incluindo os produtos presentes
  • Um mapeamento dos itens de linha do pedido para as remessas dos pedidos (shipment_line_item_mapping)

  • O ID do comerciante para quem você está enviando dados (merchant_id). Este 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 os 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 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 os dados de indicadores de rastreamento de pedidos atuais

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.