Indicadores de seguimiento de pedidos

Los indicadores de seguimiento de pedidos te permiten proporcionar a Google tus datos históricos de seguimiento de pedidos completados a través del sitio de un comercio. Esto les proporciona a los compradores estimaciones de envío más precisas y exactas. Los indicadores de seguimiento de pedidos también te permiten mejorar tus fichas con anotaciones de envío rápido y gratis.

Puedes enviar datos de los pedidos completados a través del sitio de un comercio. Los datos que envías complementan la información de configuración del envío que proporcionas como parte de la configuración de tu cuenta de Merchant Center. Por ejemplo, si les proporcionas a los compradores estimaciones de envío de 3 a 7 días, pero el seguimiento histórico reciente de tus pedidos indica que, por lo general, los pedidos llegan en 3 días en algunas regiones, Google puede actualizar tus fichas para proporcionarles a los clientes una estimación más precisa.

En esta guía, se explica cómo usar el servicio ordertrackingsignals para enviar tus datos históricos de seguimiento de pedidos.

Usa el servicio ordertrackingsignals

El servicio de ordertrackingsignals incluye un solo extremo create, que te permite enviar tus datos históricos de seguimiento de pedidos. Solo envía datos de los pedidos que se hayan entregado para que podamos verificar los tiempos de envío. Puedes enviar un pedido por solicitud. En el cuerpo de la solicitud, puedes enviar la siguiente información:

• Información del pedido, incluidos el ID y la hora de creación, el código postal de la entrega y el código de la región
• Costo de envío cobrado al comprador (customer_shipping_fee)
• Información de envío (shippingInfo), incluida la empresa de transporte, el seguimiento, el origen, el destino y los tiempos de envío de cada envío asociado al pedido
• Información de la línea de pedido (lineItems), incluidos los productos del pedido
• Es una asignación de las líneas de pedido a los envíos del pedido (shipment_line_item_mapping).

• Es el ID del comercio para el que envías datos (merchant_id). Este campo es opcional y te permite proporcionar datos en nombre de otro comercio. Si no proporcionas un valor para este campo, los datos se asociarán con la cuenta que los envíe.

  Nota: Debes habilitar tu cuenta antes de enviar datos en nombre de otro comercio. Para solicitar acceso, comunícate con nosotros a [e-mail].

Para obtener más información sobre los campos de seguimiento de pedidos obligatorios y opcionales, consulta la documentación de referencia del recurso ordertrackingsignals.

Envía datos nuevos de indicadores de seguimiento de pedidos

A continuación, se muestra una solicitud de ejemplo para enviar datos nuevos de seguimiento 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"
}

Actualiza los datos de los indicadores de seguimiento de pedidos existentes

Para modificar los datos de seguimiento de pedidos ya enviados, envía una solicitud que contenga datos nuevos con el mismo orderId. Para las estimaciones de envío y las insignias de envío rápido y gratuito, solo se usan los datos enviados más recientemente para cada orderId.