Sipariş izleme sinyalleri

Sipariş takibi sinyalleri, Google'a bir satıcının sitesi aracılığıyla tamamlanan siparişler için geçmiş sipariş takibi verilerinizi sağlamanıza olanak tanır. Bu, alıcılara daha kesin ve doğru gönderim tahminleri sağlar. Sipariş takibi sinyalleri, listelemelerinizi ücretsiz ve hızlı gönderim ek açıklamalarıyla iyileştirmenize de olanak tanır.

Hem satıcının sitesi hem de Google ile Satın Al üzerinden tamamlanan siparişler için veri gönderebilirsiniz. Gönderdiğiniz veriler, Merchant Center hesap kurulumunuzun bir parçası olarak sağladığınız gönderim yapılandırma bilgilerini tamamlar. Örneğin, alıcılara 3-7 günlük gönderim tahminleri sunuyorsanız ancak yakın zamandaki sipariş takibinize göre siparişlerinizin bazı bölgelerde genellikle 3 gün içinde teslim edildiği görülüyorsa Google, müşterilere daha kesin bir tahmin sunmak için listelemelerinizi güncelleyebilir.

Bu kılavuzda, geçmiş sipariş takibi verilerinizi göndermek için ordertrackingsignals hizmetinin nasıl kullanılacağı açıklanmaktadır.

ordertrackingsignals hizmetini kullanma

ordertrackingsignals hizmeti, geçmiş sipariş takibi verilerinizi göndermenizi sağlayan tek bir create uç noktası içerir. Gönderim sürelerini doğrulayabilmemiz için yalnızca teslim edilen siparişlerin verilerini gönderin. Her istek için bir sipariş gönderebilirsiniz. İstek gövdesinde aşağıdaki bilgileri gönderebilirsiniz:

  • Sipariş kimliği, sipariş oluşturma zamanı, teslimat posta kodu ve bölge kodu dahil sipariş bilgileri
  • Alıcıdan alınan gönderim maliyeti (customer_shipping_fee)
  • Siparişle ilişkili her bir gönderim için kargo, takip, kaynak, hedef ve gönderim süreleri dahil gönderim bilgileri (shippingInfo)
  • Siparişteki ürünler dahil olmak üzere sipariş satır öğesi bilgileri (lineItems)
  • Sipariş satır öğelerinin sipariş gönderimleriyle eşleşmesi (shipment_line_item_mapping)

  • Veri gönderdiğiniz satıcının satıcı kimliği (merchant_id). Bu alan isteğe bağlıdır ve başka bir satıcı adına veri sağlamanıza olanak tanır. Bu alan için bir değer girmezseniz veriler, onu gönderen hesapla ilişkilendirilir.

Zorunlu ve isteğe bağlı sipariş takibi alanları hakkında daha fazla bilgi için ordertrackingsignals kaynağının referans belgelerine bakın.

Yeni sipariş takibi sinyali verilerini gönderme

Yeni sipariş takibi verilerini göndermek için örnek istek:

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

Mevcut sipariş izleme sinyali verilerini güncelleme

Daha önce gönderilmiş sipariş takibi verilerini değiştirmek için aynı orderId ile yeni veriler içeren bir istek gönderin. Gönderim tahminleri ile hızlı ve ücretsiz rozetlerin uygulanmasında, her orderId için yalnızca en son gönderilen veriler kullanılır.