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

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