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

Сигналы отслеживания заказов позволяют предоставлять 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 .