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

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

Вы можете отправлять данные как о заказах, совершенных через сайт продавца, так и через Buy on 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 .