Estos indicadores te permiten proporcionarle a Google tus datos históricos de seguimiento de pedidos para los pedidos completados a través del sitio de un comercio. Esto proporciona a los compradores estimaciones de envío más precisas y precisas. Los indicadores de seguimiento de pedidos también te permiten mejorar tus fichas con anotaciones de envío rápido y gratuito.
Puedes enviar datos para los pedidos realizados mediante el sitio del comercio y mediante Comprar con Google. 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 3 a 7 días, pero el seguimiento histórico de pedidos reciente indica que tus pedidos suelen llegar en 3 días en algunas regiones, Google puede actualizar tus fichas para proporcionar 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 ordertrackingsignals incluye un solo extremo create, que te permite enviar los datos históricos de seguimiento de pedidos. Solo envía los datos de los pedidos entregados, de modo 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 del pedido, el código postal de entrega y el código regional
- 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 cada envío asociado con el pedido - Información de la línea de pedido (
lineItems), incluidos los productos del pedido - Una asignación de las líneas de pedido para pedidos de envíos
(
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 asocian con la cuenta que los envía.
Para obtener más información sobre los campos obligatorios y opcionales de seguimiento de pedidos, consulta la documentación de referencia del recurso ordertrackingsignals.
Cómo enviar datos de nuevos indicadores de seguimiento de pedidos
A continuación, se incluye una solicitud de muestra 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"
}
Cómo actualizar los datos existentes de los indicadores de seguimiento de pedidos
Para modificar los datos de seguimiento de pedidos ya enviados, envía una solicitud que contenga datos nuevos con el mismo orderId. En el caso de las estimaciones de envío y las insignias rápidas y gratuitas, solo se usan los datos enviados más recientes para cada orderId.