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

יצירת מבצע

1. בודקים אם מוצר כבר נוצר באמצעות מוצרי LIST עם מסנן external_deal_id. המזהה החיצוני של המבצע [external_deal_id] חייב להיות ייחודי לכל המוצרים.

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

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

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

   אפשרות אחרת היא להשתמש תמיד בפקודה LIST עם external_deal_id. השדה 'שם' מכיל גם את מזהה ההזמנה וגם את מזהה המוצר, כך שקל לזהות את הפריט ברמת ההורה.

ביטול מבצע

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

קבלת פרטים על מבצע

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

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

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

עדכון מבצע

1. עדכון פרטי ההזמנה ליצירת קשר עם בעל התוכן הדיגיטלי.
   1. name, does not allow update(cannot be set in the field_mask). אפשר להגדיר את הסטטוס כ'בוטל' רק באמצעות API.
   2. לא ניתן לעדכן את הערך של partner_id.
2. עדכון מוצר לעדכון של תקופת עסקה ספציפית.
   1. אי אפשר לעדכן את הערכים של name, ‏ externalDealId, ‏ transactionType, ‏ pricingType, ‏ updateTime .
   2. עדכון של displayName לא דורש אישור מהמשתמש.
   3. פרטים על קצב העדכון, creativeConfig יעדכן את סטטוס ההורה של ההזמנה לסטטוס 'בהמתנה לאישור'. מפרסמים ב-DV360 יתבקשו לאשר את התנאי החדש בדף המשא ומתן, גם אם ההזמנה הקודמת אושרה וגם אם לא.

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

1. Get Order אם ידוע לכם מזהה ההזמנה המתאים. בודקים את שדה הסטטוס.
2. אם מזהה ההזמנה לא נרשם: List Products with external_deal_id filter, figure out order name from product name, and then Get Order. בודקים את שדה הסטטוס.

בדיקה אם המשתמש הגדיר את המבצע(רק ב-PG)

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

משא ומתן מחדש (עדכון העסקה אחרי האישור)

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

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

כאן אפשר לקרוא על שינויים מותרים ואסורים בשלבים שונים של העסקה.