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
.