עדכון אחרון: 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.
עדכון שיחות לאחזור משאבי YouTube והטירגוט הקשור אליהם
- המשאבים
YoutubeAdGroup
ו-YoutubeAdGroupAd
הוחלפו במשאביםAdGroup
ו-AdGroupAd
. המשאבים החדשים מספקים מידע כמעט זהה לזה של משאבי הגרסה ב-v2, אבל יכול להיות שנעשה בהם שימוש בשמות של שדות או בטיפוסים בני מנייה מעודכנים. בשילוב, צריך להחליף את השימוש במשאביםYoutubeAdGroup
אוYoutubeAdGroupAd
במשאביםAdGroup
ו-AdGroupAd
ולעדכן את הקריאות לשירותי v2 הבאים לשירות v3 המתאים:advertisers.youtubeAdGroupAds
עדadvertisers.adGroupAds
advertisers.youtubeAdGroups
עדadvertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
עדadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- הפניות ל-
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 כדי להתאים ליצאו משימוש של תכונות קודמות:
- השירות
advertisers.manualTriggers
הוסר, כי טריגרים ידניים הוצאו משימוש. - השדה
billableOutcome
הוסר מהמשאבInsertionOrder
כי הוצאנו משימוש קנייה המבוססת על הכנסות.
שינויים נוספים
בנוסף לשינויי התוכנה שפירטנו למעלה, v3 כולל גם תכונות חדשות.
תכונות שנוספו לגרסה 3 אחרי ההשקה הראשונית מופיעות בנתוני הגרסה.
ניהול רשימת מיקומים קרובים
בגרסה 3 אפשר לנהל רשימות של מיקומים קרובים, וכך להשתמש בשירות advertisers.locationLists.assignedLocations
כדי ליצור ולמחוק מיקומים שהוקצו למשאבי TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. אפשר לזהות מיקומים באמצעות המזהה של משאבי TARGETING_TYPE_POI
TargetingOption
. אפשר לאחזר אותם באמצעות targetingTypes.targetingOptions.search
.
יכולת ליצור אלגוריתמים של בידינג בהתאמה אישית המבוססים על כללים
בגרסה 3 תוכלו ליצור ולאחזר אלגוריתמים של בידינג בהתאמה אישית המבוססים על כללים באמצעות השירותים customBiddingAlgorithms
, media
ו-customBiddingAlgorithms.rules
.
התכונה הזו נמצאת בגרסת בטא וזמינה רק לשותפים ברשימת ההיתרים. אם השותף שלכם לא נמצא ברשימת ההיתרים, הבקשה תחזיר הודעת שגיאה.