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

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

يمكنك إرسال بيانات الطلبات المكتملة من خلال الموقع الإلكتروني للتاجر. تكمّل البيانات التي ترسلها معلومات إعدادات الشحن التي تقدّمها كجزء من عملية إعداد حسابك على Merchant Center. على سبيل المثال، إذا كنت تقدّم للمشترين تقديرات للشحن تتراوح بين 3 و7 أيام، ولكن يشير سجلّ تتبُّع الطلبات الأخير إلى أنّ طلباتك تصل عادةً في غضون 3 أيام في بعض المناطق، يمكن أن تعدّل Google بياناتك لتقدّم للعملاء تقديرًا أكثر دقة.

يوضّح هذا الدليل كيفية استخدام خدمة ordertrackingsignals لإرسال بيانات تتبُّع الطلبات السابقة.

استخدام خدمة "ordertrackingsignals"

تتضمّن خدمة ordertrackingsignals نقطة نهاية create واحدة تتيح لك إرسال بيانات تتبُّع الطلبات السابقة. يجب إرسال بيانات الطلبات التي تم تسليمها فقط، حتى نتمكّن من التحقّق من أوقات الشحن. يمكنك إرسال طلب واحد فقط في كل مرة. في نص الطلب، يمكنك إرسال المعلومات التالية:

• معلومات عن الطلب، بما في ذلك معرّف الطلب ووقت إنشائه والرمز البريدي للتسليم ورمز المنطقة
• تكلفة الشحن التي تم تحصيلها من المشتري (customer_shipping_fee)
• معلومات الشحن (shippingInfo)، بما في ذلك شركة النقل والتتبّع وبلد المغادرة وبلد الوجهة وأوقات الشحن لكلّ شحن مرتبط بالطلب
• تفاصيل عن الطلب (lineItems)، بما في ذلك المنتجات التي يشملها
• خريطة لسلع الطلب وشحنات الطلب (shipment_line_item_mapping)

• تمثّل هذه السمة معرّف التاجر الذي ترسِل البيانات إليه (merchant_id). هذا الحقل اختياري ويسمح لك بتقديم البيانات نيابةً عن تاجر آخر. في حال عدم تقديم قيمة لهذا الحقل، سيتم ربط البيانات بالحساب الذي يرسلها.

  ملاحظة: يجب أن تكون مفعَّلاً قبل أن تتمكّن من إرسال بيانات نيابةً عن تاجر آخر. لطلب إذن الوصول، يُرجى التواصل معنا على [e-mail].

لمزيد من المعلومات حول حقول تتبُّع الطلبات المطلوبة والاختيارية، راجِع مستندات المرجع الخاصة بمورد 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.