إشارات تتبّع الطلبات

تتيح لك إشارات تتبّع الطلبات تزويد Google ببيانات تتبّع الطلبات السابقة للطلبات التي تم إكمالها من خلال موقع التاجر الإلكتروني. يوفر هذا للمشترين تقديرات شحن أكثر دقة ودقة. تتيح لك إشارات تتبُّع الطلبات أيضًا تحسين بيانات منتجاتك باستخدام تعليقات توضيحية بشأن الشحن السريع المجاني والسريع.

يمكنك إرسال البيانات الخاصة بكل من الطلبات المكتملة من خلال الموقع الإلكتروني للتاجر أو من خلال ميزة "الشراء على 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.