Sygnały śledzenia zamówienia

Dzięki sygnałom śledzenia zamówień możesz przesyłać do Google historyczne dane śledzenia zamówień złożonych w witrynie sprzedawcy. Dzięki temu kupujący mogą dokładniej i dokładniej oszacować dostawę. Sygnały śledzenia zamówienia pozwalają też wzbogacać informacje o produktach za pomocą adnotacji o szybkiej i bezpłatnej dostawie.

Możesz przesłać dane zarówno dla zamówień zrealizowanych w witrynie sprzedawcy, jak i przez usługę Kup przez Google. Przesłane dane uzupełniają informacje o konfiguracji dostawy podane podczas konfiguracji konta Merchant Center. Jeśli np. podajesz kupującym przewidywany czas dostawy to 3–7 dni, ale według danych historycznych z historii zamówień w niektórych regionach Twoje zamówienia zwykle są dostarczane w ciągu 3 dni, Google może zaktualizować informacje o produkcie, aby zaoferować klientom dokładniejsze oszacowania.

Z tego przewodnika dowiesz się, jak używać usługi ordertrackingsignals do przesyłania historycznych danych śledzenia zamówień.

Korzystaj z usługi ordertrackingsignals

Usługa ordertrackingsignals zawiera pojedynczy punkt końcowy create, który umożliwia przesyłanie historycznych danych śledzenia zamówień. Przesyłaj dane tylko w przypadku zamówień, które zostały dostarczone, żebyśmy mogli zweryfikować czas dostawy. W ramach jednej prośby możesz przesłać jedno zamówienie. W treści żądania możesz podać te informacje:

  • informacje o zamówieniu, w tym identyfikator zamówienia, czas jego utworzenia, kod pocztowy miejsca dostawy i kod regionu;
  • Koszt dostawy, którym kupujący zostanie obciążony (customer_shipping_fee)
  • informacje o wysyłce (shippingInfo), w tym nazwę przewoźnika, śledzenie, miejsce nadania, miejsce docelowe i czas dostawy dla każdej przesyłki powiązanej z zamówieniem;
  • informacje o elemencie zamówienia (lineItems), w tym o produktach w zamówieniu;
  • Mapowanie elementów zamówienia na dostawy zamówień (shipment_line_item_mapping)

  • Identyfikator sprzedawcy, w przypadku którego przesyłasz dane (merchant_id). To pole jest opcjonalne i umożliwia podanie danych w imieniu innego sprzedawcy. Jeśli nie podasz wartości w tym polu, dane zostaną powiązane z kontem, które je przesłało.

Więcej informacji o wymaganych i opcjonalnych polach śledzenia zamówień znajdziesz w dokumentacji zasobu ordertrackingsignals.

Przesyłanie nowych danych sygnałów śledzenia zamówienia

Oto przykładowe żądanie przesłania nowych danych śledzenia zamówienia:

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"
}

Aktualizowanie dotychczasowych danych sygnałów śledzenia zamówień

Aby zmodyfikować przesłane wcześniej dane śledzenia zamówień, prześlij prośbę zawierającą nowe dane z tym samym atrybutem orderId. W przypadku szacunków dostawy oraz plakietek dotyczących szybkiej i bezpłatnej dostawy używane są tylko najnowsze dane dotyczące każdego atrybutu orderId.