תהליכי עבודה של 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. שיעור העדכוןDetails, 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 מציין שהעסקה אושרה. המערכת צפויה להוציא כסף על העסקה הזו כשהיא מקבלת בקשה להצעת מחיר שתואמת לתנאי העסקה, וגם יש פריט פעיל בקמפיין שמטרגט את העסקה הזו, וגם הבקשה להצעת מחיר תואמת לקריטריונים של הטירגוט של פריט הקמפיין. פרטים נוספים זמינים במאמר בנושא פריט.** אין Seller API שאפשר להשתמש בו כדי לשלוח שאילתה ולבדוק אם פריטים מסוימים מכוונים לעסקה. **
      2. BUYER_STATUS_PENDINGלא רלוונטי.
      3. BUYER_STATUS_PAUSEDהמשמעות היא שהמפרסמים השהו את העסקה באופן מפורש. לא תהיה הוצאה במצב הזה.

השהיה או ביטול השהיה של מבצע אחרי אישור

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

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

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

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

אנחנו מאפשרים שינויים בכל השדות, למעט כמה שדות קריטיים להצגת מודעות כמו: startTime,‏ endTime,‏ rateDetails,‏ creativeConfig וכו'. יש לנו אימותים לגבי השדות הקריטיים האלה להצגת מודעות. באופן כללי, מותר לעדכן את השדות האלה, למעט creativeConfig, אם שעת ההתחלה של המבצע חלה לפחות יום אחד מאוחר יותר בעתיד. מותרים רק עדכונים מצטברים של מבצעים פעילים, שזמן ההתחלה שלהם חל בעבר אבל זמן הסיום שלהם חל בעתיד. לא ניתן לבצע שינויים בעסקאות שהושלמו, שזמן הסיום שלהן חל בעבר. לדוגמה, אסור לעדכן את rateDetails של עסקה שהושלמה לפני שנה. במקרים כאלה, הפעולה Update Product ב-DV3 תחזיר שגיאת אימות.