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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

עדכון השילוב של הזמנת קמפיין כדי להשתמש בשדה החדש של מדדי ה-KPI

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

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

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

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

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

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

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

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

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

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

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