Сигналы отслеживания заказов

Сигналы отслеживания заказов позволяют вам предоставлять Google исторические данные об отслеживании заказов, оформленных через сайт продавца. Это позволяет покупателям более точно оценить сроки доставки. Сигналы отслеживания заказов также позволяют вам улучшить свои листинги, добавляя бесплатные и быстрые аннотации о доставке .

Вы можете отправлять данные о заказах, оформленных через сайт продавца. Эти данные дополняют информацию о настройках доставки, которую вы предоставляете в настройках аккаунта Merchant Center. Например, если вы предоставляете покупателям прогнозируемую доставку в 3–7 дней, но, согласно последним данным отслеживания заказов, в некоторых регионах они обычно доставляются за 3 дня, Google может обновить ваши данные, чтобы предоставить покупателям более точную оценку.

В этом руководстве объясняется, как использовать сервис ordertrackingsignals для отправки данных по отслеживанию истории заказов.

Воспользуйтесь сервисом ordertrackingsignals

Сервис ordertrackingsignals включает в себя единую create точку, которая позволяет вам отправлять данные об истории отслеживания заказов. Отправляйте данные только по доставленным заказам, чтобы мы могли проверить сроки доставки. В одном запросе можно отправить один заказ. В тексте запроса можно указать следующую информацию:

• Информация о заказе, включая идентификатор заказа, время создания заказа, почтовый индекс доставки и код региона.
• Стоимость доставки взимается с покупателя ( customer_shipping_fee )
• Информация о доставке ( shippingInfo ), включая перевозчика, отслеживание, отправителя, получателя и время доставки для каждой партии товара, связанной с заказом.
• Информация о позиции заказа ( lineItems ), включая продукты в заказе
• Сопоставление позиций заказа с отгрузками заказа ( shipment_line_item_mapping )

• Идентификатор продавца, данные которого вы отправляете ( merchant_id ). Это поле необязательно и позволяет вам предоставить данные от имени другого продавца. Если вы не укажете значение в этом поле, данные будут связаны с учётной записью, которая их отправляет.

  Примечание: Для отправки данных от имени другого продавца необходимо включить эту функцию. Чтобы запросить доступ, свяжитесь с нами по адресу [e-mail] .

Дополнительную информацию об обязательных и необязательных полях отслеживания заказов см. в справочной документации по ресурсу 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 .