Sipariş takibi sinyalleri, satıcının sitesi üzerinden tamamlanan siparişlerle ilgili geçmiş sipariş takibi verilerinizi Google'a sağlamanıza olanak tanır. Bu sayede alıcılara daha kesin ve doğru kargo tahminleri sunulur. Sipariş takibi sinyalleri, listelemelerinizi ücretsiz ve hızlı kargo notlarıyla zenginleştirmenize de olanak tanır.
Satıcının sitesinde 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 arasında teslimat tahmini sunuyorsanız ancak son sipariş takibi geçmişiniz, siparişlerinizin bazı bölgelerde genellikle 3 günde teslim edildiğini gösteriyorsa Google, müşterilere daha kesin bir tahmin sunmak için listelemelerinizi güncelleyebilir.
Bu kılavuzda, geçmiş sipariş izleme verilerinizi göndermek için ordertrackingsignals hizmetini nasıl kullanacağınız açıklanmaktadır.
ordertrackingsignals hizmetini kullanma
ordertrackingsignals hizmeti, geçmiş sipariş izleme verilerinizi göndermenize olanak tanıyan tek bir create uç noktası içerir. Kargo sürelerini doğrulayabilmemiz için yalnızca teslim edilen siparişlerle ilgili verileri 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 kargo maliyeti (
customer_shipping_fee) - Siparişle ilişkili her bir gönderim için kargo, takip, başlangıç noktası, varış noktası ve kargo süreleri dahil kargo bilgileri (
shippingInfo) - Sipariş satır öğesi bilgileri (
lineItems), siparişteki ürünler dahil - 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 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 belgelerine bakın.
Yeni sipariş izleme sinyalleri verileri gönderme
Yeni sipariş izleme verileri göndermek için örnek bir 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 sinyalleri verilerini güncelleme
Daha önce gönderilmiş sipariş takibi verilerini değiştirmek için orderId ile aynı yeni verileri içeren bir istek gönderin. Kargo tahminleri ve hızlı ve ücretsiz rozeti için her orderId ile ilgili yalnızca en son gönderilen veriler kullanılır.