אותות למעקב אחר הזמנות

אותות מעקב אחר הזמנות מאפשרים לכם לספק ל-Google את נתוני המעקב ההיסטוריים של ההזמנות שהושלמו דרך האתר של המוכר. כך הקונים יכולים לקבל אומדני משלוח מדויקים יותר. אותות מעקב אחר הזמנות מאפשרים לכם גם לשפר את כרטיסי המוצרים באמצעות הערות על משלוח מהיר וחינמי.

אתם יכולים לשלוח נתונים על הזמנות שהושלמו דרך האתר של המוכר. הנתונים ששולחים משלימים את פרטי ההגדרה של המשלוח שסיפקתם כחלק מהגדרת חשבון Merchant Center. לדוגמה, אם אתם מספקים לקונים זמן משלוח משוער של 3 עד 7 ימים, אבל היסטוריית המעקב אחר ההזמנות שלכם מראה שההזמנות מגיעות בדרך כלל תוך 3 ימים באזורים מסוימים, Google יכולה לעדכן את כרטיסי המוצר שלכם כדי לספק ללקוחות זמן משלוח משוער מדויק יותר.

במדריך הזה מוסבר איך להשתמש בשירות ordertrackingsignals כדי לשלוח את נתוני המעקב ההיסטוריים של ההזמנות.

שימוש בשירות ordertrackingsignals

השירות ordertrackingsignals כולל נקודת קצה יחידה מסוג create, שמאפשרת לשלוח את הנתונים ההיסטוריים של מעקב ההזמנות. יש לשלוח נתונים רק לגבי הזמנות שהועברו, כדי שנוכל לאמת את זמני המשלוח. אפשר לשלוח רק הזמנה אחת לכל בקשה. בגוף הבקשה אפשר לשלוח את הפרטים הבאים:

  • פרטי ההזמנה, כולל מזהה ההזמנה, מועד יצירת ההזמנה, המיקוד ביעד המסירה וקוד האזור
  • עלות המשלוח שהקונה משלם (customer_shipping_fee)
  • פרטי המשלוח (shippingInfo), כולל חברת התובלה, מספר המעקב, המוצא, היעד וזמני המשלוח של כל משלוח שמשויך להזמנה
  • מידע על הפריטים בהזמנה (lineItems), כולל המוצרים שהוזמנו
  • מיפוי של הפריטים בהזמנה לשליחויות של ההזמנות (shipment_line_item_mapping)

  • מספר חשבון Merchant של המוֹכר שעבורו שולחים את הנתונים (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.