Sygnały śledzenia zamówienia

Sygnały śledzenia zamówień umożliwiają przekazywanie Google historycznych danych śledzenia zamówień zrealizowanych na stronie sprzedawcy. Dzięki temu kupujący będą mogli uzyskać dokładniejsze szacunki kosztów dostawy. Sygnały śledzenia zamówień pozwalają też ulepszać informacje o produktach za pomocą adnotacji o szybkiej i bezpłatnej dostawie.

Możesz przesyłać dane dotyczące zamówień zrealizowanych na stronie sprzedawcy. Przesłane dane uzupełniają informacje o konfiguracji dostawy, które podajesz w ramach konfiguracji konta Merchant Center. Jeśli na przykład podajesz kupującym szacunkowy czas dostawy wynoszący 3–7 dni, ale ostatnie dane śledzenia zamówień wskazują, że w niektórych regionach zamówienia zwykle docierają w ciągu 3 dni, Google może zaktualizować Twoje informacje, aby podać klientom dokładniejszy szacunek.

Z tego przewodnika dowiesz się, jak przesyłać historyczne dane śledzenia zamówień za pomocą usługi ordertrackingsignals.

Korzystanie z usługi ordertrackingsignals

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

  • informacje o zamówieniu, w tym identyfikator zamówienia, datę i godzinę jego utworzenia, kod pocztowy miejsca dostawy i kod regionu;
  • koszt wysyłki pobierany od kupującego (customer_shipping_fee);
  • informacje o wysyłce (shippingInfo), w tym nazwę przewoźnika, numer śledzenia przesyłki, miejsce nadania, miejsce dostawy i czas wysyłki dla każdej przesyłki powiązanej z zamówieniem;
  • informacje o elementach zamówienia (lineItems), w tym o zamówionych produktach.
  • Mapowanie elementów zamówienia na przesyłki zamówienia (shipment_line_item_mapping)

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

Więcej informacji o wymaganych i opcjonalnych polach śledzenia zamówień znajdziesz w dokumentacji referencyjnej 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 danych sygnałów śledzenia zamówienia

Aby zmodyfikować przesłane już dane śledzenia zamówień, wyślij prośbę zawierającą nowe dane z tym samym parametrem orderId. W przypadku szacunkowych kosztów dostawy oraz oznaczeń szybkiej i bezpłatnej dostawy używane są tylko ostatnio przesłane dane dla każdego orderId.