הערות מוצר

בדף הזה מפורטות הערות המוצר לגרסה העדכנית של Display & Video 360 API.

גרסת ה-API העדכנית ביותר: v3

4 בדצמבר 2024

תכונות חדשות

הוספנו תמיכה בערכים של Exchange ב-Core וב-Tubi.

הגדלת הגודל המקסימלי המותר לדף ב-firstAndThirdPartyAudiences.list מ-200 ל-5000. כדי לבצע אופטימיזציה נוספת של השימוש במכסה, מעדכנים את הפרמטר pageSize בבקשות firstAndThirdPartyAudiences.list.

v3

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• הגודל המקסימלי של הדף הוגדל בשיטות הרשימה הבאות:

  שיטה	גודל דף מקסימלי חדש
  firstAndThirdPartyAudiences.list	5000

‫22 באוקטובר 2024

תכונות חדשות

הוספנו תמיכה ביעד הביצועים 'עלות לצפייה'.

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

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

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

v3

• נוספו השדות הבאים:

  אובייקט

  שדות

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• נוספו ערכי enum הבאים:

  Enum	ערכים
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

ערכים שהוצאו משימוש

הסרנו את התמיכה ב-SDF בגרסה 5.5 כי היא תוצא משימוש ב-3 באוקטובר 2024.

v3

• ערכי ה-enum הבאים הוצאו משימוש:

  Enum	ערכים
  SdfVersion	SDF_VERSION_5_5

15 באוגוסט 2024

תכונות חדשות

הוספנו תמיכה בסוג Exchange של Netflix.

v3

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_NETFLIX

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_NETFLIX

15 ביולי 2024

תכונות חדשות

נוספה תמיכה בהורדה של קובצי נתונים מובְנים של פריטי שורה וקבוצות של מודעות בפורמט QA בגרסה 3.

v3

• נוספו השדות הבאים:

  משאב	שדות
  IdFilter	adGroupQaIds lineItemQaIds

• נוספו ערכי enum הבאים:

  Enum	ערכים
  FileType	FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA

17 ביוני 2024

תכונות חדשות

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

נוסף שדה חדש optimizationObjective למשאב של הזמנת הקמפיין. optimizationObjective זמין רק ללקוחות שנוספו לרשימת ההיתרים.

v3

• נוספו השדות הבאים:

  משאב	שדות
  InsertionOrder	optimizationObjective

• בשיטות הבאות יש עכשיו תמיכה בסוגי הטירגוט הבאים:

  סוג מיקוד	שיטות
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• בשיטות הבאות יש עכשיו תמיכה בסוגי הטירגוט הבאים:

  סוג מיקוד	שיטות
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

30 במאי 2024

תכונות חדשות

הוספנו תמיכה בקובצי נתונים מובְנים (SDF) בגרסה 7.1.

v3

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_7_1

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_7_1

‫23 באפריל 2024

תכונות חדשות

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

v3

• נוספו השדות הבאים:

  משאב	שדות
  מדדי KPI	kpiAlgorithmId

• נוספו ערכי enum הבאים:

  Enum	ערכים
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  KpiType	KPI_TYPE_CPCL KPI_TYPE_CPCV KPI_TYPE_CPV KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI_TYPE_MAXIMIZE_PACING KPI_TYPE_TOS10
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

‫28 בפברואר 2024

תכונות חדשות

הוספנו את האפשרות להסיר באופן מפורש חברים מקהלים בהתאמה ללקוחות.

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

v3

• נוספו השדות הבאים:

  משאב	שדות
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• נוספו השדות הבאים:

  משאב	שדות
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

29 בינואר 2024

תכונות חדשות

נוספה האפשרות לאחזר פעילויות ב-Floodlight באמצעות שירות חדש בשם floodlightGroups.floodlightActivities.

נוספה שדה חדש שמציין אם הטירגוט של פריט 'YouTube ושותפים' כולל מלאי שטחי פרסום ב-Google TV.

הוספנו שדה חדש להעברת זמן ההתחברות האחרון של משתמש ב-Display & Video 360.

v3

• נוספו השיטות הבאות:

  שירות	שיטות
  floodlightGroups.floodlightActivities	get list

• נוספו השדות הבאים:

  משאב	שדות
  משתמש	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• נוספו השיטות הבאות:

  שירות	שיטות
  floodlightGroups.floodlightActivities	get list

• נוספו השדות הבאים:

  משאב	שדות
  משתמש	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

‫14 בנובמבר 2023

תכונות חדשות

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

v3

• נוספו השדות הבאים:

  משאב	שדות
  ContactInfoList	consent
  MobileDeviceIdList	consent

v2

• נוספו השדות הבאים:

  משאב	שדות
  ContactInfoList	consent
  MobileDeviceIdList	consent

31 באוקטובר 2023

תכונות חדשות

גרסה 3 הוצאה מגרסת הבטא הציבורית והפכה לזמינה לכולם.

שינוי השם של ערך enum מסוג AdGroupFormat בגרסה 3 כדי לשקף בצורה מדויקת יותר את הפורמט הרלוונטי.

הוספנו תמיכה בקובצי נתונים מובְנים בגרסה 7, עם הערך SDF_VERSION_7 של enum בגרסה 2 ובגרסה 3.

v3

• הערכים הבאים של enum הוסרו:

  Enum	ערכים
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• נוספו ערכי enum הבאים:

  Enum	ערכים
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_7

2 באוקטובר 2023

תכונות חדשות

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

• היכולת לנהל באופן מלא רשימות של מיקומים בסביבה הקרובה, שמאפשרת להשתמש בשירות advertisers.locationLists.assignedLocations כדי ליצור ולמחוק מיקומים שהוקצתה למשאבים של TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• שדה בוליאני חדש enableOptimizedTargeting, שמחליף את השדה targetingExpansionLevel באובייקט TargetingExpansionConfig.
• הדרישה של השדה billingConfig במשאב Advertiser, שצריך לכלול בבקשות advertisers.create, ושדה חדש billingConfig במשאב Partner.
• משאבים חדשים מסוג AdGroup ו-AdGroupAd שמחליפים את המשאבים מסוג YoutubeAdGroup ו-YoutubeAdGroupAd בגרסה 2.

כדי לעבור מגרסה 2 לגרסה 3, פועלים לפי השלבים שמפורטים במדריך להעברה.

הוספנו תמיכה ב-3 ערכים חדשים של LineItemType, ערך חדש של YoutubeAndPartnersBiddingStrategyType וערך חדש של PartnerCostType בגרסה 2 ובגרסה 3.

v3

• נוספו השיטות הבאות:

  שירות	שיטות
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• השיטות הבאות הוסרו:

  שירות	שיטות
  advertisers.manualTriggers	הפעלה create בטל הפעלה get list patch
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• התנהגות השיטה הבאה השתנתה:

  שיטה	שינויים
  advertisers.locationLists.create	יש עכשיו תמיכה ביצירה של משאבי TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.patch	יש עכשיו תמיכה בעדכון משאבי TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.bulkEdit	עכשיו יש תמיכה בעריכה בכמות גדולה של משאבי AssignedLocation במשאבי TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	עכשיו יש תמיכה ביצירת משאבים מסוג AssignedLocation במשאבים מסוג TARGETING_LOCATION_TYPE_PROXIMITY LocationList.

• נוספו הפרמטרים הבאים של השאילתה:

  שיטה	פרמטרים
  inventorySources.get	advertiserId

• השדות הבאים הפכו לשדות חובה:

  משאב	שדות
  מפרסם	billingConfig

• נוספו השדות הבאים:

  משאב	שדות
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	kpi
  שותף/ה	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• השדות הבאים הוסרו:

  משאב	שדות
  InsertionOrder	performanceGoal billableOutcome
  TargetingExpansionConfig	excludeFirstPartyAudience targetingExpansionLevel
  YoutubeAndPartnersSettings	biddingStrategy thirdPartyMeasurementSettings
  YoutubeAndPartnersInventorySourceConfig	includeYoutubeSearch includeYoutubeVideos

• נוספו ערכי enum הבאים:

  Enum	ערכים
  CustomBiddingAlgorithmType	RULE_BASED
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  ReadinessState	READINESS_STATE_EVALUATION_FAILURE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

• הערכים הבאים של enum הוסרו:

  Enum	ערכים
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  LineItemType	LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
  PartnerCostType	PARTNER_COST_TYPE_SCIBIDS_FEE
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 באוגוסט 2023

תכונות חדשות

הוספנו תמיכה בשני זירות מסחר ובשני סוגי שיטות בידינג חדשים של YouTube ושותפים.

הוספנו שדה חדש, effectiveContentCategory, לפריטים של YouTube ושותפי הווידאו של Google כדי להציג את הערך של YoutubeAndPartnersContentCategory שמשמש את הפריט, בהתאם לערכים שהוקצו ברמת המפרסם וברמת הפריט.

v2

• נוספו השדות הבאים:

  משאב	שדות
  YoutubeAndPartnersSettings	effectiveContentCategory

• השדות הבאים הוסרו:

  משאב	שדות
  InventorySource	subSitePropertyId

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS

‫5 ביוני 2023

תכונות חדשות

נוספ ערך חדש SdfVersion לקבצי נתונים מובְנים (SDF) בגרסה 6 בגרסה 1 ובגרסה 2.

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_6

v1

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_6

9 במרץ 2023

תכונות חדשות

נוסף ערך חדש LineItemWarningMessage שיוקצה לשדה warningMessages של פריט שורה, אם השדה excludeFirstPartyAudience שהוצא משימוש מוגדר לערך true. השדה excludeFirstPartyAudience יוסר משימוש ויוגדר ל-false אחרי 25 במרץ 2023.

v2

• נוספו ערכי enum הבאים:

  Enum	ערכים
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• נוספו ערכי enum הבאים:

  Enum	ערכים
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 בפברואר 2023

תכונות חדשות

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

הוספנו תמיכה בעוד ארבע בורסות בגרסה 1 ובגרסה 2.

v2

• נוספו השיטות הבאות:

  שירות	שיטות
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• נוספו השדות הבאים:

  שירות	שיטות
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
  TargetingType	TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO

v1

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

6 בדצמבר 2022

תכונות חדשות

גרסה 2 הוצאה מגרסת הבטא הציבורית והפכה לזמינה לכולם.

נוספה שדה assignedTargetingOptionIdAlias חדש למשאב AssignedTargetingOption, שאפשר להשתמש בו במקום בשדה assignedTargetingOptionId כשמאתרים ומוחקים טירגוט. השדה הזה מוגדר רק לאפשרויות טירגוט שהוקצו לסוגים של טירגוט שהוקצו באמצעות enum. ערך החלופה הוא ערך ה-enum הרלוונטי כמחרוזת.

הוספת שדה billingConfig חדש למשאב Advertiser.

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

הגדלת גודל הדף המקסימלי ל-200 עבור שיטות רבות של list בגרסה 1 ובגרסה 2. גודל הדף שמוגדר כברירת מחדל לא ישתנה.

v2

• נוספו השדות הבאים:

  משאב	שדות
  מפרסם	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• נוספו ערכי enum הבאים:

  Enum	ערכים
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

• הגודל המקסימלי של הדף הוגדל בשיטות הרשימה הבאות:

  שיטה	גודל דף מקסימלי חדש
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• הגודל המקסימלי של הדף הוגדל בשיטות הרשימה הבאות:

  שיטה	גודל דף מקסימלי חדש
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

בעיות מוכרות

העדכון הזה מתקן את הבעיות המוכרות הבאות בגרסה 2:

• לא ניתן היה להסיר או לאחזר אפשרויות טירגוט שהוקצו לסוגים של טירגוט שהוקצו באמצעות ערכים של enum בגרסה 2 באמצעות assignedTargetingOptionId שלהם, ובמקום זאת המשתמשים היו אמורים להשתמש בערך ה-enum. בעקבות העדכון הזה, אפשר להסיר או לאחזר את אפשרויות הטירגוט שהוקצו באמצעות הערך assignedTargetingOptionId או באמצעות ערך המניין, שמזוהה באמצעות השדה החדש assignedTargetingOptionIdAlias במשאב AssignedTargetingOption.
• בבקשה של פריט ה-Line bulkUpdate לא נעשה שימוש נכון בפרמטר הבקשה advertisersId, וכתוצאה מכך הוחזרה שגיאה. בעדכון הזה, השיטה תוקנה ושם הפרמטר של הבקשה השתנה מ-advertisersId ל-advertiserId.

27 באוקטובר 2022

הוספנו את היכולת לשכפל פריט קיים ברמת ההורה InsertionOrder.

הוספנו תמיכה בכתיבת טירגוט חלקי של הזמנות להצגת מודעות, עבור קבוצת משנה של סוגי טירגוט. לשם כך הוספנו את השיטות create ו-delete לשירות advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

תכונות חדשות

v2

• נוספו השיטות הבאות:

  שירות	שיטות
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	create מחיקה
  advertisers.lineItems	duplicate

v1

לא נוספו תכונות חדשות לגרסה 1.

20 בספטמבר 2022

השקנו את הגרסה השנייה בגרסת בטא ציבורית, שכוללת את השינויים הבאים:

• היכולת לאחזר את הפריטים של YouTube ושותפים ואת הגדרות הטירגוט שלהם באמצעות השיטות get ו-list בשירותים advertisers.lineItems ו-advertisers.lineItems.targetingTypes.assignedTargetingOptions .
• שתי שיטות חדשות לטירגוט בכמות גדולה בשירות advertisers.lineItems שמאפשרות לערוך ולאחזר טירגוט שהוקצה לכמה פריטים בבקשה אחת.
• שיטה חדשה של bulkUpdate שמאפשרת למשתמשים לעדכן את entityStatus של כמה פריטים בבקשה אחת.
• לוגיקה חדשה של טירגוט שמחייבת להקצות ולשלוף משאבים של AssignedTargetingOption מקבוצת משנה של סוגי טירגוט באמצעות ערכי enum במקום מזהי אפשרויות טירגוט שאוחזרים באמצעות השירות targetingTypes.targetingOptions.

כדי לעבור מגרסה 1 לגרסה 2, פועלים לפי השלבים שמפורטים במדריך להעברה.

הוספנו תמיכה בשלושה זירת מסחר חדשים בגרסה 1.

תכונות חדשות

v2

בהמשך מופיעה רשימת השינויים בין גרסה 1 לגרסה 2:

• השיטות הבאות נוספו בגרסה 2:

  שירות	שיטות
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• השיטות הבאות הוסרו בגרסה 2:

  שירות	שיטות
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• השמות של השיטות הבאות השתנו בגרסה 2:

  שירות	השם הקודם של השיטה	השם החדש של השיטה
  מפרסמים	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• במשאבים מסוג AssignedTargetingOption עם סוגי הטירגוט הבאים נעשה שימוש ב-enums להקצאת טירגוט בגרסה 2. השדה assignedTargetingOptionId למשאבי AssignedTargetingOption מסוגים אלה של טירגוט עודכן גם בגרסה 2, כך שייעשה בו שימוש בגרסאות מחרוזות של ערכי המניין:

  סוג מיקוד	סוג טיפוס בן מנייה (enum)
  TARGETING_TYPE_AGE_RANGE	AgeRange
  TARGETING_TYPE_CONTENT_INSTREAM_POSITION	ContentInstreamPosition
  TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION	ContentOutstreamPosition
  TARGETING_TYPE_DEVICE_TYPE	DeviceType
  TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION	ContentRatingTier
  TARGETING_TYPE_ENVIRONMENT	סביבה
  TARGETING_TYPE_EXCHANGE	Exchange
  TARGETING_TYPE_GENDER	מגדר
  TARGETING_TYPE_HOUSEHOLD_INCOME	HouseholdIncome
  TARGETING_TYPE_NATIVE_CONTENT_POSITION	NativeContentPosition
  TARGETING_TYPE_OMID	Omid
  TARGETING_TYPE_PARENTAL_STATUS	ParentalStatus
  TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION	SensitiveCategory
  TARGETING_TYPE_VIDEO_PLAYER_SIZE	VideoPlayerSize
  TARGETING_TYPE_VIEWABILITY	חשיפות גלויות

• השדות הבאים נוספו בגרסה 2:

  משאב	שדות
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	exchange
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• השדות הבאים הוסרו בגרסה 2:

  משאב	שדות
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• השדות הבאים הפכו לשדות חובה בגרסה 2:

  משאב	שדות
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	environment
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	gender
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	viewability

• ערכי ה-enum הבאים נוספו בגרסה 2:

  Enum	ערכים
  AgeRange	AGE_RANGE_18_20 AGE_RANGE_21_24 AGE_RANGE_25_29 AGE_RANGE_30_34 AGE_RANGE_35_39 AGE_RANGE_40_44 AGE_RANGE_45_49 AGE_RANGE_50_54 AGE_RANGE_55_59 AGE_RANGE_60_64
  ContentRatingTier	CONTENT_RATING_TIER_FAMILIES
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR
  LineItemType	LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
  ReservationType	RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL
  SensitiveCategory	SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

• הערכים הבאים של enum הוסרו בגרסה 2:

  Enum	ערכים
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
  LineItemWarningMessage	APP_INSTALL_NO_CONVERSION_PIXEL APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS NO_CREATIVE_FOR_TARGETED_DEALS NO_POSITIVE_AUDIENCE_LIST_TARGETED TARGETING_DEPRECATED_GEO_TARGET TARGETING_REVOKED_OR_CLOSED_USER_LIST

v1

• ערכי enum הבאים נוספו בגרסה 1:

  Enum	ערכים
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 במאי 2022

נוספה היכולת ליצור משאבים מסוג InventorySource ולנהל משאבים מסוג GuaranteedOrder באמצעות שיטות כתיבה חדשות של שירות inventorySources ושירות חדש guaranteedOrders.

הוספנו את השדה modelReadiness למשאב CustomBiddingAlgorithm. בשדה הזה מוצגת רמת הנכונות של מודל האלגוריתמים לכל מפרסם שיש לו גישה אליו.

הפעלנו פונקציונליות חדשה של פרמטר השאילתה filter בשיטה advertisers.creatives.list, שמאפשרת למשתמשים לאחזר רק נכסי קריאייטיב עם updateTime לפני או אחרי חותמת זמן נתונה.

נוספה תמיכה בגרסה החדשה ביותר של SDF, v5.5, באמצעות הוספת ערך enum‏ SdfVersion.

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list תיקון
  inventorySources	create editInventorySourceReadWriteAccessors תיקון

• נוספו השדות הבאים:

  משאב	שדות
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_5_5

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי המאפיינים הבאים:

  שיטה	שדות
  advertisers.creatives.list	updateTime

31 במרץ 2022

הוספנו תמיכה באחזור ובהגדרה של טירגוט לפי משך התוכן, סוג הסטרימינג וז'אנר.

הוספת השדה billableOutcome לאובייקט InsertionOrder.

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

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• נוספו ערכי enum הבאים:

  Enum	ערכים
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 בפברואר 2022

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

הוספנו את השדה reservationType למשאבים מסוג InsertionOrder ו-LineItem, שמזהה אם המשאב הוא עם התחייבות להצגת מודעות באמצעות תג, עם התחייבות להצגת מודעות פרוגרמטית או ללא התחייבות.

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

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

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  firstAndThirdPartyAudiences	create editCustomerMatchMembers תיקון

• נוספו השדות הבאים:

  משאב	שדות
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

8 בדצמבר 2021

הוספנו תמיכה בטירגוט לפי סוג תוכן אודיו, בסוג הטירגוט TARGETING_TYPE_AUDIO_CONTENT_TYPE.

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• נוספו ערכי enum הבאים:

  Enum	ערכים
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 בנובמבר 2021

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

• פונקציות ליצירה של customBiddingAlgorithms חדשים ולעדכון של customBiddingAlgorithms קיימים.
• היכולת להעלות סקריפטים באמצעות התהליך של אחזור מיקום משאב זמין ואז העלאת הקובץ למיקום הזה.
• שירות customBiddingAlgorithms.scripts חדש לאחזור וליצירה של customBiddingScripts.

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

נוספה תמיכה בגרסה החדשה ביותר של SDF, v5.4, באמצעות הוספת ערך enum‏ SdfVersion.

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  customBiddingAlgorithms	create תיקון uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• נוספו ערכי enum הבאים:

  Enum	ערכים
  SdfVersion	SDF_VERSION_5_4

14 בספטמבר 2021

הוספנו תמיכה בטירגוט לפי קרבה בסוגים הבאים של טירגוט: TARGETING_TYPE_BUSINESS_CHAIN ו-TARGETING_TYPE_POI.

הוספנו את היכולת לחפש אפשרויות טירגוט זמינות של TARGETING_TYPE_BUSINESS_CHAIN ושל TARGETING_TYPE_POI באמצעות targetingTypes.targetingOptions.search, כי אי אפשר לאחזר אותן באמצעות השיטות targetingTypes.targetingOptions.get או targetingTypes.targetingOptions.list.

הוספנו את השדות החדשים sharedAdvertiserIds ו-customBiddingAlgorithmState למשאב 'אלגוריתם בידינג בהתאמה אישית', והוספנו תמיכה בסוג GOAL_BUILDER_BASED של אלגוריתם בידינג בהתאמה אישית.

הוספנו שני ערכים חדשים למערך הערכים (enum) Exchange.

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  גוף הבקשה של TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• נוספו ערכי enum הבאים:

  Enum	ערכים
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי המאפיינים הבאים:

  שיטה	שדות
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 באוגוסט 2021

הוספנו תמיכה בטירגוט מלאי שטחי פרסום שפועל באמצעות Open Measurement בסוג הטירגוט TARGETING_TYPE_OMID.

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

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• נוספו ערכי enum הבאים:

  Enum	ערכים
  TargetingType	TARGETING_TYPE_OMID

• הגודל המקסימלי של הדף הוגדל בשיטות הרשימה הבאות:

  שיטה	גודל דף מקסימלי חדש
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

26 במאי 2021

השקנו את השירות advertisers.invoices, שמאפשר למשתמשים:

• אחזור חשבוניות שהונפקו למפרסם במהלך חודש נתון.
• לחפש את קוד המטבע שבו המפרסם השתמש במהלך חודש נתון.

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

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

הוספנו שדה חדש prismaEnabled למשאב של המפרסם, שמאפשר למשתמשים להפעיל שילוב עם הכלי Prisma של Mediaocean.

הפעלנו תמיכה בערך המנוון ENTITY_STATUS_PAUSED בשדה entityStatus של המפרסם.

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  advertisers.invoices	list lookupInvoiceCurrency

• נוספו השדות הבאים:

  משאב	שדות
  מפרסם	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  קמפיין	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• נוספו ערכי enum הבאים:

  Enum	ערכים
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• ערכי ה-enum הבאים חוקיים עכשיו בשדות הבאים:

  משאב	שדה	ערכים
  מפרסם	entityStatus	ENTITY_STATUS_PAUSED

29 באפריל 2021

נוספו שדות חדשים למשאבים Channel ו-Negative Keyword List שמחזירים את מספר הפריטים בשורה באמצעות המשאב לטירגוט. הפעלנו מאפייני filter חדשים לשיטה של רשימת פריטים שמאפשרים למשתמש לאחזר רק פריטים שמשתמשים בטירגוט שלהם בערוצים ספציפיים או ברשימות של מילות מפתח שליליות.

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  ערוץ	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי המאפיינים הבאים:

  שיטה	שדות
  advertisers.lineItems.list	targetedChannelId targetedNegativeKeywordListId

30 במרץ 2021

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

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

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

ביצענו כמה שינויים בשירותים advertisers.channels.sites,‏ partners.channels.sites ו-advertisers.negativeKeywordLists.negativeKeywords כדי לאפשר ניהול קל יותר של התוכן של ערוצים ורשימות של מילות מפתח שליליות. השינויים האלה כוללים:

• הוספת שיטות replace, שמאפשרות למשתמש לשכתב באופן מלא את התוכן הקיים של ערוץ או של רשימת מילות מפתח שליליות.
• הסרת הדרישה שלא לכלול פריטים קיימים בשדות createdSites או createdNegativeKeywords של בקשות לעריכת פריטים בכמות גדולה.
• הגדלת המספר המקסימלי של פריטים שאפשר להחזיר בדף אחד בתגובה של רשימת אתרים או של רשימת מילות מפתח שליליות.

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• נוספו השדות הבאים:

  משאב	שדות
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• הגודל המקסימלי של הדף הוגדל בשיטות הרשימה הבאות:

  שיטה	גודל הדף המקסימלי הקודם	גודל דף מקסימלי חדש
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

תכונות שיצאו משימוש

• אי אפשר יותר להקצות את ערכי המניין הבאים למשאבים חדשים או קיימים:

  Enum	ערכים
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 בפברואר 2021

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

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• נוספו השדות הבאים:

  משאב	שדות
  קריאייטיב	mp3Audio oggAudio

• נוספו ערכי enum הבאים:

  Enum	ערכים
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

27 בינואר 2021

הוספנו את השדה החדש InsertionOrderType ואת הערך החדש של LineItemType כדי לאפשר אחזור וניהול של הזמנות להצגת מודעות בטלוויזיה ופריטי שורה של שירותי Over-the-top. נוספה תמיכה בפריטים של אפליקציות לנייד באמצעות שדה פריט mobileApp. תמיכה מורחבת ב-exchange, ב-google audience וב-SDF באמצעות ערכים נוספים של enum. הוספנו את היכולת לסנן ולסדר ערכים של advertisers.list לפי מועד העדכון האחרון.

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• מעכשיו אפשר למיין ולסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  מפרסמים	updateTime

4 בדצמבר 2020

נוספה היכולת לחפש אפשרויות טירגוט לפי Geo Region ולסנן כמה תוצאות של שיטות לרישום משאבים לפי מועד העדכון האחרון שלהן. הוספנו את השדה LineItemWarningMessage כדי להודיע למשתמשים מתי יש בפריט שגיאה בטירגוט הגיאוגרפי.

תכונות חדשות

• נוספו השיטות הבאות:

  שירות	שיטות
  targetingTypes.targetingOptions	חיפוש

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• מעכשיו אפשר למיין ולסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

‫5 בנובמבר 2020

הוספנו את היכולת ליצור, להקצות ולהפעיל טריגרים ידניים שמפעילים את ההוצאות של הפריטים המשויכים. הוספנו אפשרויות להרחבת הטירגוט. כשמגדירים אותן, אפשר להרחיב את הטירגוט של פריט שורה כך שיכלול משתמשים שדומים לאלה שבקהלים המטורגטים. הוספת שדות של מזהי פלחים מותאמים אישית לאובייקטים של DoubleVerify ו-Integral Ad Science שמשמשים לטירגוט של אימות צד שלישי.

תכונות חדשות

• נוספו השירותים הבאים:

  שירות	שיטות
  advertisers.manualTriggers	הפעלה create השבתה get list תיקון

• נוספו השדות הבאים:

  משאב	שדות
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• נוספו ערכי enum הבאים:

  Enum	ערכים
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  advertisers.lineItems.list	filter.triggerId

12 באוקטובר 2020

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

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

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  LineItem	warningMessages

• נוספו ערכי enum הבאים:

  Enum	ערכים
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  advertisers.lineItems.list	warningMessages

28 באוגוסט 2020

נוספו שדות חדשים לתגובה של שיטת הביקורת של המפרסם ושדות חדשים שאפשר לסנן בשיטות שונות של רשימות.

תכונות חדשות

• נוספו השדות הבאים:

  משאב	שדות
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

‫4 באוגוסט 2020

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

תכונות חדשות

• נוספו השירותים הבאים:

  שירות	שיטות
  customBiddingAlgorithms	get list
  שותפים	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  משתמשים	bulkEditAssignedUserRoles create delete get list תיקון

• נוספו השיטות הבאות:

  שירות	שיטות
  מפרסמים	ביקורת

• נוספו השדות הבאים:

  משאב	שדות
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• נוספו ערכי enum הבאים:

  Enum	ערכים
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• מעכשיו אפשר למיין ולסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  advertisers.lineItems.list	flight.dateRange.endDate

• ההיקפים הבאים נוספו לשימוש בשירותים הבאים:

  היקף	שירותים
  https://www.googleapis.com/auth/display-video-user-management	משתמשים

24 ביוני 2020

השקנו עדכון קטן שנוספה לו שיטת יצירה לערוצי שותפים ולערוצים של מפרסמים, שדות חדשים של FirstAndThirdPartyAudience וערכים נוספים של enum ל-exchange.

תכונות חדשות

• נוספו השירותים הבאים:

  שירות	שיטות
  advertisers.channels	create
  partners.channels	create

• נוספו השדות הבאים:

  משאב	שדות
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• נוספו ערכי enum הבאים:

  Enum	ערכים
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• עכשיו אפשר לסנן את שיטות הרשימות הבאות לפי השדות הבאים:

  שיטה	שדות
  advertisers.creatives.list	creativeId

2 ביוני 2020

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

תכונות חדשות

• נוספו השירותים הבאים:

  שירות	שיטות
  advertisers.channels.sites	bulkEdit create delete list
  advertisers.locationLists.assignedLocations	bulkEdit create delete list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create delete list
  advertisers.targetingTypes.assignedTargetingOptions	create delete get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create delete list
  partners.channels.sites	bulkEdit create delete list

• נוספו השיטות הבאות:

  שירות	שיטות
  מפרסמים	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	תיקון
  advertisers.locationLists	create תיקון
  advertisers.negativeKeywordLists	create delete תיקון
  inventorySourceGroups	create delete תיקון
  partners.channels	תיקון

• נוספו השדות הבאים:

  משאב	שדות
  מפרסם	servingConfig
  קריאייטיב	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 באפריל 2020

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

תכונות חדשות

נוספו השירותים הבאים:

שירות	שיטות
מפרסמים	create delete get list תיקון
advertisers.assets	העלאה
advertisers.campaigns	create delete get list תיקון
advertisers.channels	get list
advertisers.creatives	create delete get list תיקון
advertisers.insertionOrders	create delete get list תיקון
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list תיקון
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create delete get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get תיקון
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9 במרץ 2020

השקנו את Display & Video 360 API v1. זו הגרסה הראשונית של ה-API.

בעיות מוכרות

ללא.