נתוני גרסה שהועברו לארכיון

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

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

‫4 בדצמבר 2024

תכונות חדשות

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

הגדלנו את הגודל המקסימלי המותר של דפים ב-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_NETFLIX

v2

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

  Enum	ערכים
  בורסה	EXCHANGE_NETFLIX

‫15 ביולי 2024

תכונות חדשות

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

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

תכונות חדשות

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

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_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_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

‫28 בפברואר 2024

תכונות חדשות

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

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

v3

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

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

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

  Enum	ערכים
  בורסה	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_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 מגרסת בטא ציבורית והיא זמינה לכלל המשתמשים (GA).

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

הוספנו תמיכה בגרסה 7 של קובצי נתונים מובְנים, עם הוספה של ערך ה-enum‏ SDF_VERSION_7 בגרסאות 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	יצירה get list

• ה-methods הבאות הוסרו:

  שירות	שיטות
  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 במשאבי LocationList.TARGETING_LOCATION_TYPE_PROXIMITY
  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

תכונות חדשות

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

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

v2

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

  משאב	שדות
  YoutubeAndPartnersSettings	effectiveContentCategory

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

  משאב	שדות
  InventorySource	subSitePropertyId

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

  Enum	ערכים
  בורסה	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 ל-Structured Data Files (SDF) v6 בגרסאות v1 ו-v2.

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 ושל שותפים.

הוספנו תמיכה ב-4 בורסות נוספות בגרסה 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_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_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

‫6 בדצמבר 2022

תכונות חדשות

העברנו את גרסה 2 מגרסת בטא לציבור הרחב לזמינות לכלל המשתמשים (GA).

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

נוסף שדה חדש billingConfig למשאב Advertiser.

נוספה תמיכה באחזור פריטים של YouTube ושותפים בשיטת over-the-top (OTT), שמזוהים באמצעות שלושה ערכים חדשים של 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 או ערך enum, שמזוהה על ידי השדה החדש assignedTargetingOptionIdAlias במשאב AssignedTargetingOption.
• בבקשה של פריט קו bulkUpdate לא נעשה שימוש נכון בפרמטר הבקשה advertisersId, ולכן הוחזרה שגיאה. בעדכון הזה, ה-method תוקן ושם פרמטר הבקשה שונה מ-advertisersId ל-advertiserId.

27 באוקטובר 2022

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

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

תכונות חדשות

v2

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

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

v1

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

‫20 בספטמבר 2022

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

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

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

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

תכונות חדשות

v2

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

• ה-methods הבאות נוספו בגרסה 2:

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

• ה-methods הבאות הוסרו בגרסה 2:

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

• השמות של ה-methods הבאות השתנו בגרסה 2:

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

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

  סוג מיקוד	סוג הטיפוס בן המנייה (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	בורסה
  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	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_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_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

‫26 במאי 2022

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

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

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

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

תכונות חדשות

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

  שירות	שיטות
  guaranteedOrders	יצירה editGuaranteedOrderReadAccessors get list patch
  inventorySources	יצירה editInventorySourceReadWriteAccessors patch

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

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

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

  Enum	ערך/ערכים
  SdfVersion	SDF_VERSION_5_5

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

  שיטה	שדות
  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 שמזהה אם משאב הוא Tag Guaranteed,‏ Programmatic Guaranteed או לא מובטח.

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

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

תכונות חדשות

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

  שירות	שיטות
  firstAndThirdPartyAudiences	יצירה editCustomerMatchMembers patch

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

  משאב	שדות
  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.scripts לאחזור ויצירה של customBiddingScripts.

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

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

תכונות חדשות

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

  שירות	שיטות
  customBiddingAlgorithms	יצירה patch uploadScript
  customBiddingAlgorithms.scripts	יצירה 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, כי אי אפשר לאחזר אותן באמצעות ה-methods‏ targetingTypes.targetingOptions.get או targetingTypes.targetingOptions.list.

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

הוספנו שני ערכים חדשים ל-enum‏ Exchange.

תכונות חדשות

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

  משאב	שדות
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search Request Body	businessChainSearchTerms poiSearchTerms

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

  Enum	ערך/ערכים
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  בורסה	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

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

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

4 באוגוסט 2021

הוספנו תמיכה בטירגוט מלאי שטחי פרסום עם מדידה פתוחה בקטע 'סוג הטירגוט' 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.

הוספנו תמיכה בערך ה-enum‏ 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 ו-רשימת מילות מפתח שליליות שמחזירים את מספר פריטי הקו שמשתמשים במשאב לטירגוט. הפעלנו מאפיינים חדשים של filter שיטת רשימת פריטים שמאפשרים למשתמש לאחזר רק פריטים שמשתמשים בערוצים ספציפיים או ברשימות של מילות מפתח שליליות בטירגוט שלהם.

תכונות חדשות

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

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

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

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

‫30 במרץ 2021

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

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

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

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

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

תכונות חדשות

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

  שירות	שיטות
  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 הבאים למשאבים חדשים או קיימים:

  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. תמיכה מורחבת בבורסת פרסום, בקהל של Google וב-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

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

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

4 בדצמבר 2020

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

תכונות חדשות

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

  שירות	שיטות
  targetingTypes.targetingOptions	search

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

  Enum	ערכים
  Exchange	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

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

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

‫5 בנובמבר 2020

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

תכונות חדשות

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

  שירות	שיטות
  advertisers.manualTriggers	activate create השבתה get list patch

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

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

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

  Enum	ערך/ערכים
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

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

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

‫12 באוקטובר 2020

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

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

תכונות חדשות

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

  משאב	שדות
  LineItem	warningMessages

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

  Enum	ערך/ערכים
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

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

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

28 באוגוסט 2020

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

תכונות חדשות

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

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

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

  שיטה	שדות
  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
  partners	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create delete get list
  משתמשים	bulkEditAssignedUserRoles create delete get list patch

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

  שירות	שיטות
  מפרסמים	audit

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

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

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

  Enum	ערכים
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

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

  שיטה	שדות
  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

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

  שיטה	שדות
  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	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create delete patch
  inventorySourceGroups	create delete patch
  partners.channels	patch

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

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

‫27 באפריל 2020

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

תכונות חדשות

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

שירות	שיטות
מפרסמים	create delete get list patch
advertisers.assets	upload
advertisers.campaigns	create delete get list patch
advertisers.channels	get list
advertisers.creatives	create delete get list patch
advertisers.insertionOrders	create delete get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create delete get list patch
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 patch
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.

בעיות מוכרות

ללא.