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

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

אתם יכולים לשלוח נתונים גם של הזמנות שהושלמו דרך אתר של מוֹכר וגם דרך 'קונים ב-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.