Los indicadores de seguimiento de pedidos te permiten proporcionar a Google tus datos históricos de seguimiento de pedidos para los pedidos completados a través del sitio de un comercio. Esto les proporciona a los compradores estimaciones de envío más precisas. 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 de envío que proporcionas como parte de la configuración de tu cuenta de Merchant Center. Por ejemplo, si proporcionas a los compradores estimaciones de envío de entre 3 y 7 días, pero el seguimiento histórico de pedidos reciente indica que, por lo general, tus 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, como 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 que se cobra al comprador (
customer_shipping_fee) - Información de envío (
shippingInfo), como la empresa de transporte, el seguimiento, el origen, el destino y los tiempos de cada envío asociado al pedido - Información de la línea de pedido (
lineItems), incluidos los productos del pedido - Una asignación de las líneas de pedido a los envíos de pedidos (
shipment_line_item_mapping) 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ía.
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 nuevos datos de indicadores de seguimiento de pedidos
Esta es una solicitud de ejemplo para enviar datos de seguimiento de pedidos nuevos:
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 que ya se enviaron, envía una solicitud que contenga datos nuevos con el mismo orderId. Para las estimaciones de envío y las insignias rápidas y gratuitas, solo se usan los datos enviados más recientemente para cada orderId.