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

עדכון אחרון: 31 באוקטובר 2023

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

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

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

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

לדוגמה, כדי להפעיל את ה-method advertisers.get עם גרסה 2: משתמשים בכתובת ה-URL הבאה:

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

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

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

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

ביצוע השינויים הנדרשים

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

  • YoutubeAdGroup ו-YoutubeAdGroupAd משאבים הוחלפו ב- AdGroup ו-AdGroupAd משאבים. מקורות המידע החדשים האלה מספקים מידע כמעט זהה למשאבים בגרסה 2, אבל יכול להיות שנעשה בו שימוש בשדה מעודכן שמות או טיפוסים של טיפוסים בני מנייה (enum). בשילוב, החליפו את השימושים שלכם ב- YoutubeAdGroup או YoutubeAdGroupAd משאבים עם AdGroup וגם מקורות מידע של AdGroupAd ועדכוני קריאות לשירותי גרסה 2 הבאים כדי שירות 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, ומשתמשים בשדות ובטיפוסים חדשים (enums).

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

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

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

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

ניתן למצוא תכונות שנוספו ל-v3 לאחר ההשקה הראשונית בגרסה שלנו הערות.

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

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

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

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

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