מעבר מגרסה 2 לגרסה 3

עדכון אחרון: 31.10.2023

העברת האפליקציה שלך

כדי לעבור מגרסה 2 לגרסה 3, צריך לעדכן את כתובות ה-URL של נקודות הקצה לקריאה לגרסה 3, ולעדכן את האפליקציה כדי להביא בחשבון שינויים שעלולים לגרום לכשלים.

עדכון הקריאות ל-API מגרסה 2 לגרסה 3

כדי להשתמש ב-v3 במקום ב-v2, תצטרכו לעדכן את הבקשות לשימוש בנקודות קצה (endpoints) חדשות ב-v3.

לדוגמה, כדי להפעיל את השיטה advertisers.get עם v2, צריך להשתמש בכתובת ה-URL הבאה:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

בגרסה 3, מעדכנים את כתובת ה-URL לכתובת הבאה:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

אם אתם משתמשים בספריית לקוח כדי לשלוח בקשות ל-API, השתמשו בגרסה העדכנית ביותר של ספריית הלקוח ועדכנו את ההגדרות כך שישתמשו ב-v3.

צריך לבצע את השינויים הנדרשים

הוספנו בגרסה 3 כמה שינויי תוכנה שעלולים לגרום לכשלים. עיינו בהוראות הבאות ובצעו את השינויים הנדרשים הרלוונטיים לשימוש הנוכחי שלכם ב-Display & Video 360 API.

  • המשאבים YoutubeAdGroup ו-YoutubeAdGroupAd הוחלפו במשאבים AdGroup ו-AdGroupAd. המשאבים החדשים מספקים מידע כמעט זהה לזה של משאבי הגרסה ב-v2, אבל יכול להיות שנעשה בהם שימוש בשמות של שדות או בטיפוסים בני מנייה מעודכנים. בשילוב, צריך להחליף את השימוש במשאבים YoutubeAdGroup או YoutubeAdGroupAd במשאבים AdGroup ו-AdGroupAd ולעדכן את הקריאות לשירותי v2 הבאים לשירות v3 המתאים:
  • הפניות ל-YoutubeAndPartnersBiddingStrategy אובייקטים הועברו לשדה youtubeAndPartnersBid חדש בתוך האובייקט הכללי BiddingStrategy. השדה biddingStrategy הוסר מהאובייקט YoutubeAndPartnersSettings. עליכם לעדכן את השילוב כדי לאחזר את שיטת הבידינג לפריטים או לקבוצות של מודעות ב-YouTube מהאובייקט BiddingStrategy בשדה bidStrategy במשאב LineItem או AdGroup.
  • השם של השדה thirdPartyMeasurementSettings השתנה ל-thirdPartyMeasurementConfigs באובייקט YoutubeAndPartnersSettings, והשם של האובייקט YoutubeAndPartnersThirdPartyMeasurementSettings השתנה ל-ThirdPartyMeasurementConfigs. מעדכנים את השילוב כדי לאחזר מידע על הגדרת מדידה של צד שלישי באמצעות השדה החדש והאובייקט החדש.

לכלול את הגדרות החיוב הנדרשות כשיוצרים מפרסמים

השדה billingConfig הוא עכשיו שדה חובה במשאב Advertiser. צריך לעדכן את הבקשות ב-advertisers.create כדי לוודא שהשדה הזה מוגדר. אפשר לאחזר את נתוני החיוב שמוגדרים כברירת מחדל עבור שותף ההורה באמצעות השדה החדש של Partner המשאב billingConfig.

אפשר להשתמש בשדה חדש כדי לשלוט באופטימיזציית טירגוט

שדה enableOptimizedTargeting בוליאני חדש החליף את השדה targetingExpansionLevel באובייקט TargetingExpansionConfig.

צריך לעדכן את השילוב של הזמנת הקמפיין כדי להשתמש בשדה KPI חדש

השדה kpi החדש החליף את השדה performanceGoal במשאב InsertionOrder. בשדה החדש נעשה שימוש באובייקט Kpi במקום באובייקט PerformanceGoal, והוא משתמש בשדות ובטיפוסים בני מנייה חדשים.

הסרת הפניות לשירותים ולשדות שהוצאו משימוש

ישויות שונות הוסרו בגרסה 3 כדי להתאים ליצאו משימוש של תכונות קודמות:

שינויים נוספים

בנוסף לשינויי התוכנה שפירטנו למעלה, v3 כולל גם תכונות חדשות.

תכונות שנוספו לגרסה 3 אחרי ההשקה הראשונית מופיעות בנתוני הגרסה.

ניהול רשימת מיקומים קרובים

בגרסה 3 אפשר לנהל רשימות של מיקומים קרובים, וכך להשתמש בשירות advertisers.locationLists.assignedLocations כדי ליצור ולמחוק מיקומים שהוקצו למשאבי TARGETING_LOCATION_TYPE_PROXIMITY LocationList. אפשר לזהות מיקומים באמצעות המזהה של משאבי TARGETING_TYPE_POI TargetingOption. אפשר לאחזר אותם באמצעות targetingTypes.targetingOptions.search.

יכולת ליצור אלגוריתמים של בידינג בהתאמה אישית המבוססים על כללים

בגרסה 3 תוכלו ליצור ולאחזר אלגוריתמים של בידינג בהתאמה אישית המבוססים על כללים באמצעות השירותים customBiddingAlgorithms, media ו-customBiddingAlgorithms.rules.

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