Сигналы отслеживания заказов позволяют вам предоставлять Google исторические данные отслеживания заказов, выполненных через сайт продавца. Это дает покупателям более точные и точные оценки доставки. Сигналы отслеживания заказов также позволяют улучшить ваши списки с помощью бесплатных и быстрых аннотаций о доставке .
Вы можете отправлять данные о заказах, оформленных через сайт продавца. Отправляемые вами данные дополняют информацию о конфигурации доставки, которую вы предоставляете при настройке учетной записи Merchant Center. Например, если вы предоставляете покупателям расчетный срок доставки в 3–7 дней, но недавнее отслеживание исторических заказов показывает, что в некоторые регионы ваши заказы обычно доставляются в течение 3 дней, Google может обновить ваши списки, чтобы предоставить клиентам более точную оценку.
В этом руководстве объясняется, как использовать службу ordertrackingsignals для отправки исторических данных отслеживания заказов.
Используйте сервис ordertrackingsignals
Служба ordertrackingsignals включает в себя единую конечную точку create , которая позволяет вам отправлять исторические данные отслеживания заказов. Отправляйте данные только о доставленных заказах, чтобы мы могли проверить время доставки. Вы можете отправить один заказ на один запрос. В теле запроса вы можете указать следующую информацию:
- Информация о заказе, включая идентификатор заказа и время создания заказа, почтовый индекс доставки и код региона.
- Стоимость доставки взимается с покупателя (
customer_shipping_fee) - Информация о доставке (
shippingInfo), включая перевозчика, отслеживание, происхождение, место назначения и время доставки для каждой отправки, связанной с заказом. - Информация о позиции заказа (
lineItems), включая продукты в заказе. - Сопоставление позиций заказа с поставками заказа (
shipment_line_item_mapping). Идентификатор продавца, для которого вы отправляете данные (
merchant_id). Это поле является необязательным и позволяет указать данные от имени другого продавца. Если вы не укажете значение для этого поля, данные будут связаны с учетной записью, которая их отправляет.
Дополнительные сведения об обязательных и необязательных полях отслеживания заказов см. в справочной документации по ресурсу ordertrackingsignals .
Отправьте данные сигналов отслеживания новых заказов
Вот пример запроса на отправку новых данных отслеживания заказов:
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"
}
Обновить существующие данные сигналов отслеживания заказов
Чтобы изменить уже отправленные данные отслеживания заказов, отправьте запрос, содержащий новые данные с тем же orderId . Для расчета стоимости доставки и быстрого и бесплатного присвоения бейджей используются только самые последние отправленные данные для каждого orderId .