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

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

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

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

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

שירות ordertrackingsignals כולל נקודת קצה (endpoint) אחת של 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.