تتيح لك إشارات تتبُّع الطلبات تقديم بيانات تتبُّع الطلبات السابقة إلى Google للطلبات التي تم إكمالها من خلال موقع تاجر إلكتروني. وهذا يوفر للمشترين تقديرات شحن أكثر دقة ودقة. تتيح لك إشارات تتبُّع الطلبات أيضًا تحسين بياناتك باستخدام التعليقات التوضيحية بشأن الشحن السريع والمجاني.
يمكنك إرسال بيانات الطلبات المكتملة من خلال موقع تاجر إلكتروني. تكمل البيانات التي ترسلها معلومات إعدادات الشحن التي تقدّمها كجزء من عملية إعداد حسابك على Merchant Center. على سبيل المثال، إذا كنت تقدّم للمشترين تقديرات الشحن التي تتراوح بين 3 و7 أيام، ولكن تتبيّن من سجلّ تتبُّع الطلبات السابق أنّ طلباتك عادةً ما تصل في غضون 3 أيام في بعض المناطق، يمكن أن تعدّل Google بياناتك لمنح العملاء تقدّرًا أكثر دقة.
يوضّح هذا الدليل كيفية استخدام خدمة ordertrackingsignals لإرسال
بيانات تتبُّع الطلبات السابقة.
استخدام خدمة ordertrackingsignals
تتضمّن خدمة ordertrackingsignals نقطة نهاية create واحدة، ما
يتيح لك إرسال بيانات تتبُّع الطلبات السابقة. أرسِل بيانات الطلبات التي تم تسليمها فقط لنتمكّن من التحقّق من أوقات الشحن. يمكنك
إرسال طلب واحد لكل طلب. في نص الطلب، يمكنك إرسال
المعلومات التالية:
- معلومات عن الطلب، بما في ذلك معرّف الطلب ووقت إنشائه والرمز البريدي للتسليم ورمز المنطقة
- تكلفة الشحن التي تم تحصيلها من المشتري (
customer_shipping_fee) - معلومات الشحن (
shippingInfo) بما في ذلك شركة النقل والتتبُّع والمصدر والوجهة وأوقات الشحن لكل شحنة مرتبطة بالطلب - معلومات عن سلع الطلب (
lineItems)، بما في ذلك المنتجات التي يشملها الطلب - تعيين عناصر الطلب إلى شحنات الطلب
(
shipment_line_item_mapping) معرّف التاجر الخاص بالتاجر الذي يتم إرسال بياناته (
merchant_id). هذا الحقل اختياري ويتيح لك تقديم البيانات نيابةً عن تاجر آخر. إذا لم تقدّم قيمة لهذا الحقل، سيتم ربط البيانات بالحساب الذي يرسلها.
لمزيد من المعلومات عن حقول تتبُّع الطلبات المطلوبة والاختيارية، يُرجى الاطّلاع على مستندات المراجع الخاصة بمرجع ordertrackingsignals.
إرسال بيانات جديدة لإشارات تتبُّع الطلبات
في ما يلي نموذج لطلب إرسال بيانات تتبُّع جديدة للطلب:
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"
}
تعديل بيانات إشارات تتبُّع الطلبات الحالية
لتعديل بيانات تتبُّع الطلبات التي سبق أن أرسلتها، أرسِل طلبًا يتضمّن
بيانات جديدة تتضمّن السمة orderId نفسها. بالنسبة إلى تقديرات الشحن والشارة المميّزة المجانية والسريعة، لا يتم استخدام سوى أحدث البيانات التي تم إرسالها لكل orderId.