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

אותות מעקב אחר הזמנות מאפשרים לכם לספק ל-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.