תהליכי עבודה של API

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

יצירת מבצע

1. כדי לבדוק אם מוצר כבר נוצר, מתקשרים אל LIST products עם המסנן externalDealId. הערה: מחרוזת המסנן יכולה להיות בפורמט camelCase externalDealId או בפורמט snake_case external_deal_id. external_deal_id חייב להיות ייחודי לכל המוצרים.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. יצירת הזמנה. שם ההזמנה נוצר על ידי DV360, ומומלץ לשמור את המזהה הזה במערכת שלכם כדי לאחזר אותו בעתיד.

3. יצירת מוצר בקטע Order (הזמנה) שם המוצר נוצר על ידי DV360, ומומלץ לשמור את המזהה הזה במערכת שלכם כדי לאחזר אותו בעתיד.

אפשר גם להתקשר לרשימה באמצעות external_deal_id. השדה Name (שם) של המשאב מכיל גם את מזהה ההזמנה וגם את מזהה המוצר, כך שאפשר לזהות את ההזמנה הראשית.

ביטול מבצע

1. עדכון סטטוס ההזמנה לערך CANCELED. אפשר לבטל רק אם ההזמנה עדיין לא אושרה. בוטל הוא מצב סופי. אי אפשר להפעיל מחדש הזמנה אחרי שהיא בוטלה. אם ההזמנה כללה מוצרים, אי אפשר לעשות שימוש חוזר בערך external_deal_id שלהם.

קבלת פרטים על עסקה

1. קבלת פרטים על הזמנה. הסטטוס מתעדכן ברגע שהמשתמש מאשר, מעביר לארכיון או מבטל את ההזמנה.
2. קבלת פרטים של מוצר.

קבלת רשימה של מבצעים

1. LIST orders with a status filter to get all accepted or pending acceptance orders.
2. LIST products with the external_deal_id filter.
3. ‫LIST כל המוצרים בהזמנה.

עדכון מבצע

1. עדכון סדר הפרטים ליצירת קשר של בעל התוכן הדיגיטלי.
   1. אי אפשר לעדכן את name (אי אפשר להגדיר אותו ב-updateMask). אפשר להגדיר את הסטטוס רק ל-CANCELED באמצעות ה-API.
   2. אי אפשר לעדכן את partner_id.
2. עדכון מוצר לעדכון של תקופת עסקה ספציפית.
   1. name, externalDealId, transactionType, pricingType, ו-updateTime לא ניתן לעדכן.
   2. עדכון של displayName לא מחייב את המשתמשים לאשר מחדש את התנאים.
   3. עדכון של rateDetails או creativeConfig משנה את סטטוס הזמנת ההורה לPENDING_ACCEPTANCE. מפרסמים ב-DV360 יתבקשו לאשר את התנאים החדשים בדף 'משא ומתן', גם אם ההזמנה הקודמת כבר אושרה.

בודקים אם המשתמש אישר את העסקה

1. ‫Get Order אם ידוע לכם שם ההזמנה המתאים. בודקים את השדה status.
2. אם שם ההזמנה לא נרשם: List Products with external_deal_id filter, identify Order Name from Product Name, and then call Get Order. בודקים את השדה status.

בודקים אם המשתמש הגדיר את העסקה (רק לגבי פרוגרמטי מובטח)

1. קבלת מקור מלאי שטחי פרסום. שם המשאב הוא exchanges/{exchangeId}/inventorysources/{external_deal_id}. בודקים את סטטוס הקונה.
   1. מבצעים על הזמנות:
      1. ‫BUYER_STATUS_ACTIVE: העסקה אושרה והוגדרה. ההוצאות על העסקה יתחילו כש-DV360 יקבל בקשות להצעות מחיר שתואמות לתנאי העסקה. פריט מודעה נוצר באופן אוטומטי במהלך הגדרת העסקה. פרטים נוספים זמינים במאמר בנושא הגדרת מבצעים.
      2. ‫BUYER_STATUS_PENDING: ההזמנה אושרה, אבל עדיין לא הוגדר הסכם. לא מתבצעת הוצאה במדינה הזו.
      3. ‫BUYER_STATUS_PAUSED: המפרסם השהה את המבצע. לא מתבצעת הוצאה במדינה הזו.
   2. מבצעים ללא הזמנה:
      1. ‫BUYER_STATUS_ACTIVE: העסקה אושרה. ההוצאות על העסקה יתחילו כשמערכת DV360 תקבל בקשות תואמות להצעות מחיר, כשפריט פעיל בקמפיין מטרגט את העסקה וכשהבקשות להצעות מחיר תואמות לקריטריוני הטירגוט של פריט הקמפיין. פרטים נוספים זמינים במאמר בנושא פריטים. (הערה: אין Seller API שאפשר להשתמש בו כדי לברר אם מבצע מטורגט על ידי פריטי קמפיין).
      2. BUYER_STATUS_PENDING: לא רלוונטי לעסקאות ללא הזמנה.
      3. ‫BUYER_STATUS_PAUSED: המבצע הושהה באופן מפורש על ידי המפרסם. לא מתבצעת הוצאה במדינה הזו.

השהיה וביטול ההשהיה של עסקה אחרי האישור

1. עדכון מקור המלאי סטטוס המוכר.
   1. השהיה או ביטול ההשהיה לא מפסיקים את הצגת המבצע. אם מוֹכר משהה עסקה, המפרסמים רואים הודעה אינפורמטיבית בממשק המשתמש של DV360, כדי לעזור להם לפתור בעיות בעסקאות שלא מניבות הוצאות.

משא ומתן מחדש (עדכון מבצע אחרי אישור)

משא ומתן מחדש מתייחס לעדכונים שבוצעו בעסקה אחרי שהקונה אישר אותה. כך בורסות וקונים יכולים לשנות את התנאים בעסקאות קיימות. לדוגמה, יכול להיות שבבורסה יגלו ששעת הסיום של תקופת ההפעלה של עסקה שאושרה שגויה. במקרה כזה, הבורסה יכולה להשתמש ב-Product Patch כדי לשלוח עדכונים לקונים ב-DV360 לפני שהעסקה מתחילה להציג מודעות.

שינויים שמותרים ושינויים שאסורים

במאמרים במרכז העזרה של Display & Video 360 מפורטים כללי המשא ומתן והמשא ומתן מחדש על עסקאות:

• ניהול משא ומתן מחדש על עסקה מסוג פרוגרמטי מובטח
• ניהול משא ומתן על עסקה ב-Display & Video 360