Sipariş izleme sinyalleri

Sipariş takibi sinyalleri, bir satıcının sitesi üzerinden tamamlanan siparişlere ait geçmiş sipariş takibi verilerinizi Google'a göndermenize olanak tanır. Bu sayede alıcılar daha kesin ve doğru kargo tahminleri alır. Sipariş takip sinyalleri, ücretsiz ve hızlı kargo notları ile listelemelerinizi geliştirmenize de olanak tanır.

Satıcının sitesi üzerinden tamamlanan siparişlerle ilgili verileri gönderebilirsiniz. Gönderdiğiniz veriler, Merchant Center hesap kurulumunuzun bir parçası olarak sağladığınız kargo yapılandırma bilgilerini tamamlar. Örneğin, alıcılara 3-7 gün olan gönderim tahminleri sunuyorsanız ancak son geçmiş sipariş takibi verileriniz, siparişlerinizin bazı bölgelerde genellikle 3 günde ulaştığını gösteriyorsa Google, müşterilerinize daha kesin bir tahmin sunmak için listelemelerinizi güncelleyebilir.

Bu kılavuzda, geçmiş sipariş takibi verilerinizi göndermek için ordertrackingsignals hizmetini nasıl kullanacağınız açıklanmaktadır.

ordertrackingsignals hizmetini kullanma

ordertrackingsignals hizmeti, geçmiş sipariş takibi verilerinizi göndermenize olanak tanıyan tek bir create uç noktası içerir. Gönderim sürelerini doğrulayabilmemiz için yalnızca teslim edilmiş siparişlere ait verileri gönderin. Her istek için bir sipariş gönderebilirsiniz. İstek gövdesinde şu 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 kargo maliyeti (customer_shipping_fee)
  • Siparişle ilişkili her bir kargoya ait kargo, takip, kalkış, hedef ve kargo süreleri dahil kargo bilgileri (shippingInfo)
  • Siparişteki ürünler dahil olmak üzere sipariş satır öğesi bilgileri (lineItems)
  • Sipariş satır öğelerinin sipariş gönderimleriyle eşlenmesi (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 sağlamazsanız veriler, 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 dokümanlarına bakın.

Yeni sipariş izleme sinyali verileri gönderme

Yeni sipariş izleme verilerini göndermek için örnek bir istek aşağıda verilmiştir:

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 sinyalleri verilerini güncelleme

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