ملاحظات الإصدار المؤرشفة

تقدّم هذه الصفحة ملاحظات حول إصدارات Display & Video 360 API التي تم إيقافها نهائيًا.

انتقِل إلى صفحة ملاحظات الإصدار الرئيسية للاطّلاع على جميع الإصدارات المتاحة.

‫4 ديسمبر 2024

ميزات جديدة

تمت إضافة إمكانية استخدام القيم Exchange في Core وTubi.

تمت زيادة الحدّ الأقصى المسموح به لحجم الصفحة في firstAndThirdPartyAudiences.list من 200 إلى 5000. عدِّل المَعلمة pageSize في طلبات firstAndThirdPartyAudiences.list لتحسين استخدام الحصة بشكل أكبر.

v3

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_VERSION_8

القيم المتوقّفة نهائيًا

تمت إزالة دعم الإصدار 5.5 من "تنسيق بيانات الخدمة" بسبب إيقافه نهائيًا في 3 أكتوبر 2024.

v3

• تم إيقاف قيم التعداد التالية نهائيًا:

  تعداد	القيم
  SdfVersion	SDF_VERSION_5_5

‫15 أغسطس 2024

ميزات جديدة

تمت إضافة دعم لنوع Exchange من Netflix.

v3

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  Exchange	EXCHANGE_NETFLIX

v2

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  Exchange	EXCHANGE_NETFLIX

‫15 يوليو 2024

ميزات جديدة

تمت إضافة إمكانية تنزيل ملفات البيانات المنظَّمة الخاصة ببنود الحملة والمجموعات الإعلانية بتنسيق QA في الإصدار 3.

v3

• تمت إضافة الحقول التالية:

  المورد	الحقول
  IdFilter	adGroupQaIds lineItemQaIds

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  SdfVersion	SDF_VERSION_7_1

v2

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  SdfVersion	SDF_VERSION_7_1

‫23 أبريل 2024

ميزات جديدة

تمّت إضافة إمكانية استخدام أنواع جديدة من مؤشرات الأداء الرئيسية والبورصات ومنصّات التطبيقات.

v3

• تمت إضافة الحقول التالية:

  المورد	الحقول
  Kpi	kpiAlgorithmId

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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 يتضمّن مساحة عرض إعلاني على Google TV في استهدافه.

تمّت إضافة حقل جديد لنقل وقت آخر تسجيل دخول لمستخدم في "مساحة العرض والفيديو 360".

v3

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  floodlightGroups.floodlightActivities	الحصول على list

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المستخدم	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  floodlightGroups.floodlightActivities	الحصول على list

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المستخدم	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

‏14 تشرين الثاني (نوفمبر) 2023

ميزات جديدة

تمّت إضافة إمكانية تمرير موافقة المستخدِم النهائي عند تحميل أعضاء شرائح جمهور "مطابقة العملاء" في جميع الإصدارات المباشرة.

v3

• تمت إضافة الحقول التالية:

  المورد	الحقول
  ContactInfoList	consent
  MobileDeviceIdList	consent

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  ContactInfoList	consent
  MobileDeviceIdList	consent

‫31 أكتوبر 2023

ميزات جديدة

تم نقل الإصدار 3 من الإصدار التجريبي المتاح للجميع إلى الإصدار المتوفر للجمهور العام.

تمت إعادة تسمية قيمة التعداد AdGroupFormat في الإصدار 3 لتعكس التنسيق ذي الصلة بدقة أكبر.

تمت إضافة دعم لملفات البيانات المنظَّمة الإصدار 7 من خلال إضافة قيمة التعداد SDF_VERSION_7 في الإصدارين 2 و3.

v3

• تمت إزالة قيم التعداد التالية:

  تعداد	القيم
  AdGroupFormat	AD_GROUP_FORMAT_ACTION

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  AdGroupFormat	AD_GROUP_FORMAT_RESPONSIVE
  SdfVersion	SDF_VERSION_7

v2

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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	الحصول على list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions الحصول على list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	الحصول على list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	إنشاء الحصول على list

• تمت إزالة الطرق التالية:

  الخدمة	الطرق
  advertisers.manualTriggers	تفعيل إنشاء إيقاف الحصول على قائمة رمز تصحيح
  advertisers.youtubeAdGroupAds	الحصول على قائمة
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions الحصول على قائمة
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	الحصول على قائمة

• تم تغيير سلوك الطريقة التالية:

  الطريقة	التغييرات
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إزالة قيم التعداد التالية:

  تعداد	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v2

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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 والشركاء الإعلانية لعرض YoutubeAndPartnersContentCategory الذي يستخدمه البند الإعلاني عند أخذ القيم المحدّدة على مستوى المعلِن ومستوى البند الإعلاني في الاعتبار.

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  YoutubeAndPartnersSettings	effectiveContentCategory

• تمت إزالة الحقول التالية:

  المورد	الحقول
  InventorySource	subSitePropertyId

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  SdfVersion	SDF_VERSION_6

v1

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  SdfVersion	SDF_VERSION_6

‫9 مارس 2023

ميزات جديدة

تمت إضافة قيمة LineItemWarningMessage جديدة سيتم تعيينها إلى حقل warningMessages في عنصر حملة إذا كان الحقل excludeFirstPartyAudience المتوقّف نهائيًا مضبوطًا على true. سيتم إيقاف الحقل excludeFirstPartyAudience نهائيًا وسيتم ضبطه على false بعد 25 مارس 2023.

v2

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  LineItemWarningMessage	DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

‫8 شباط (فبراير) 2023

ميزات جديدة

تمت إضافة إمكانية استرداد موارد YouTubeAdGroup وYouTubeAdGroupAd، بالإضافة إلى استهداف موارد "مجموعة إعلانية على YouTube". بالإضافة إلى ذلك، أضفنا أيضًا أنواع استهداف جديدة يمكن استرجاعها، ويتم استخدامها على مستوى المجموعات الإعلانية على YouTube. يمكنك الاطّلاع على صفحة الدليل الجديدة حول استرداد الموارد الخاصة بـ YouTube والشركاء للحصول على مزيد من المعلومات.

تمّت إضافة إمكانية استخدام أربع بورصات إضافية في الإصدارَين 1 و2.

v2

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  advertisers.youtubeAdGroupAds	الحصول على list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions الحصول على list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	الحصول على list

• تمت إضافة الحقول التالية:

  الخدمة	الطرق
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  Exchange	EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE

‫6 ديسمبر 2022

ميزات جديدة

تم نقل الإصدار 2 من الإصدار التجريبي المتاح للجميع إلى الإصدار المتوفر للجمهور العام.

تمت إضافة حقل assignedTargetingOptionIdAlias جديد إلى مورد AssignedTargetingOption، ويمكن استخدامه بدلاً من assignedTargetingOptionId عند استرداد بيانات الاستهداف وحذفها. لا يتم ضبط هذا الحقل إلا لخيارات الاستهداف المحدّدة لأنواع الاستهداف التي يتم تحديدها من خلال التعداد. قيمة الاسم المستعار هي قيمة التعداد ذات الصلة كسلسلة.

تمت إضافة حقل billingConfig جديد إلى المرجع Advertiser.

تمّت إضافة إمكانية استرداد عناصر YouTube والشركاء التي يتمّ عرضها على أجهزة التلفزيون المتّصلة بالإنترنت، والتي يتمّ تحديدها من خلال ثلاث قيم LineItemType جديدة.

تمت زيادة الحد الأقصى لحجم الصفحة إلى 200 لعدد كبير من طرق list في الإصدارَين 1 و2. يبقى حجم الصفحة التلقائي بدون تغيير.

v2

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المعلِن	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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:

• لم يكن من الممكن إزالة خيارات الاستهداف المعيّنة لأنواع الاستهداف التي يتم تعيينها باستخدام قيم التعداد في الإصدار 2 أو استردادها باستخدام assignedTargetingOptionId، وكان من المتوقّع بدلاً من ذلك أن يستخدم المستخدمون قيمة التعداد. من خلال هذا التعديل، يمكن إزالة خيارات الاستهداف المعيّنة هذه أو استردادها باستخدام assignedTargetingOptionId أو قيمة التعداد، والتي يتم تحديدها من خلال الحقل الجديد assignedTargetingOptionIdAlias في المرجع AssignedTargetingOption.
• لم يستخدم طلب البند الإعلاني bulkUpdate مَعلمة الطلب advertisersId بشكل صحيح، ما أدّى إلى ظهور خطأ. مع هذا التحديث، تم إصلاح الطريقة وإعادة تسمية مَعلمة الطلب من advertisersId إلى advertiserId.

27 تشرين الأول (أكتوبر) 2022

تمت إضافة إمكانية تكرار بند حالي ضمن العنصر الرئيسي InsertionOrder.

تم توفير إمكانية كتابة استهداف جزئي لأوامر طلب الإدراج لمجموعة فرعية من أنواع الاستهداف من خلال إضافة الطريقتَين create وdelete إلى خدمة advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

ميزات جديدة

v2

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	إنشاء حذف
  advertisers.lineItems	مكرّرة

v1

لم تتم إضافة أي ميزات جديدة إلى الإصدار 1.

20 أيلول (سبتمبر) 2022

تم إطلاق الإصدار 2 في الإصدار التجريبي العلني، ويتضمّن التغييرات التالية:

• إمكانية استرداد البنود الإعلانية على YouTube ومنصات الشركاء وإعدادات استهدافها باستخدام الطريقتَين get وlist في خدمتَي advertisers.lineItems وadvertisers.lineItems.targetingTypes.assignedTargetingOptions
• طريقتان جديدتان للاستهداف المجمّع في خدمة advertisers.lineItems تتيحان تعديل واسترداد الاستهداف المعيّن على مستوى عدّة عناصر في طلب واحد.
• طريقة bulkUpdate جديدة تتيح للمستخدمين تعديل entityStatus لعدة عناصر في طلب واحد.
• منطق استهداف جديد يتطلّب تعيين واسترداد AssignedTargetingOption موارد مجموعة فرعية من أنواع الاستهداف باستخدام قيم التعداد بدلاً من معرّفات خيارات الاستهداف التي يتم استردادها باستخدام خدمة 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 أنواع الاستهداف التالية تعدادات لتحديد الاستهداف في الإصدار 2. تم أيضًا تعديل الحقل assignedTargetingOptionId لموارد AssignedTargetingOption من أنواع الاستهداف هذه في الإصدار 2 لاستخدام إصدارات السلسلة من قيم التعداد:

  نوع الاستهداف	نوع التعداد
  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	البيئة
  ExchangeAssignedTargetingOptionDetails	exchange
  GenderAssignedTargetingOptionDetails	الجنس
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	إمكانية العرض

• تمت إضافة قيم التعداد التالي في الإصدار 2:

  تعداد	القيمة(القيم)
  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

• تمت إزالة قيم التعداد التالية في الإصدار 2:

  تعداد	القيم
  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:

  تعداد	القيم
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

‫26 مايو 2022

تمت إضافة إمكانية إنشاء موارد InventorySource وإدارة موارد GuaranteedOrder من خلال طرق كتابة جديدة في خدمة inventorySources وخدمة guaranteedOrders جديدة.

تمت إضافة الحقل modelReadiness إلى مورد CustomBiddingAlgorithm. يسرد هذا الحقل مدى جاهزية نموذج الخوارزمية لكل معلِن يمكنه الوصول إليه.

تم تفعيل وظيفة مَعلمة طلب البحث الجديدة filter للطريقة advertisers.creatives.list التي تتيح للمستخدم استرداد تصميمات الإعلانات التي تتضمّن updateTime قبل أو بعد طابع زمني معيّن فقط.

تمت إضافة إمكانية استخدام أحدث إصدار من SDF، وهو v5.5، من خلال إضافة قيمة التعداد SdfVersion.

ميزات جديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  guaranteedOrders	إنشاء editGuaranteedOrderReadAccessors الحصول على list patch
  inventorySources	إنشاء editInventorySourceReadWriteAccessors patch

• تمت إضافة الحقول التالية:

  المورد	الحقول
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 شباط (فبراير) 2022

تمّت إضافة إمكانية إنشاء وتعديل وتعديل أعضاء موارد معيّنة في ميزة "مطابقة العملاء" FirstAndThirdPartyAudience. توضّح صفحة تحميل شرائح جمهور "مطابقة العملاء" في دليلنا الجديد استخدام شرائح الجمهور كيفية استخدام هذه الميزات الجديدة.

أضفنا حقل reservationType جديدًا في موارد InsertionOrder وLineItem يحدّد ما إذا كان المورد "مضمونًا بالعلامة" أو "مضمونًا آليًا" أو غير مضمون.

تمّت إضافة إمكانية استرداد وتحديد ما إذا كان عنصر الحملة يستهدف تلقائيًا بورصات جديدة من خلال حقل excludeNewExchanges جديد.

بالإضافة إلى الميزات الجديدة، تمت مضاعفة حدود الحصة التلقائية.

ميزات جديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  firstAndThirdPartyAudiences	إنشاء editCustomerMatchMembers patch

• تمت إضافة الحقول التالية:

  المورد	الحقول
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

‫8 ديسمبر 2021

تمت إضافة إمكانية استهداف نوع المحتوى الصوتي ضمن نوع الاستهداف TARGETING_TYPE_AUDIO_CONTENT_TYPE.

ميزات جديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

‫8 نوفمبر 2021

تمت إضافة دعم كامل لإدارة خوارزميات عروض الأسعار المخصّصة وبرامجها النصية. يشمل ذلك ما يلي:

• دوال لإنشاء customBiddingAlgorithms جديدة وتعديل customBiddingAlgorithms حالية
• إمكانية تحميل النصوص البرمجية من خلال عملية استرداد موقع جغرافي متاح للموارد ثم تحميل الملف إلى هذا الموقع الجغرافي
• خدمة customBiddingAlgorithms.scripts جديدة لاسترداد وإنشاء customBiddingScripts

تمت إضافة صفحة جديدة بعنوان تنفيذ عروض الأسعار المخصّصة إلى دليل إدارة البنود الإعلانية الذي يوضّح عملية إنشاء خوارزمية عروض أسعار مخصّصة وتحميل نص برمجي وتحديد خوارزمية عروض الأسعار المخصّصة لتكون استراتيجية عروض أسعار لبند إعلاني.

تمت إضافة إمكانية استخدام أحدث إصدار من SDF، وهو v5.4، من خلال إضافة قيمة التعداد SdfVersion.

ميزات جديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  customBiddingAlgorithms	إنشاء patch uploadScript
  customBiddingAlgorithms.scripts	إنشاء الحصول على list
  media	upload

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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.

تمت إضافة قيمتين جديدتين إلى تعداد Exchange.

ميزات جديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  TargetingOptions.search نص الطلب	businessChainSearchTerms poiSearchTerms

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Exchange	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• أصبحت قيم التعداد التالية صالحة للحقول التالية:

  المورد	الحقل	القيم
  المعلِن	entityStatus	ENTITY_STATUS_PAUSED

29 نيسان (أبريل) 2021

تمّت إضافة حقول جديدة إلى الموردَين القناة وقائمة الكلمات الرئيسية السلبية اللذين يعرضان عدد عناصر الحملة التي تستخدم المورد للاستهداف. تم تفعيل خصائص 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	الحصول على list
  advertisers.channels.sites	استبدال
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	استبدال
  partners.channels.sites	استبدال

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• تمت زيادة الحدّ الأقصى لحجم الصفحة لطُرق القائمة التالية:

  الطريقة	Old Max Page Size	الحدّ الأقصى الجديد لحجم الصفحة
  advertisers.channels.sites.list	100	10000
  advertisers.negativeKeywordLists.negativeKeywords.list	100	1000
  partners.channels.sites.list	100	10000

الميزات التي سيتم إيقافها نهائيًا

• لم يعُد من الممكن تعيين قيم التعداد التالي للموارد الجديدة أو الحالية:

  تعداد	القيم
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

‫24 شباط (فبراير) 2021

أطلقنا خدمة استهداف جديدة لطلبات الإدراج وطريقة إضافية للقائمة المجمّعة تتيح استرداد الاستهدافات المخصّصة لطلبات الإدراج. تم توسيع مرجع المواد الإبداعية، مع إضافة حقول مواد إبداعية مخصّصة للناتج فقط ليتم استخدامها من قِبل المواد الإبداعية الصوتية التابعة لجهات خارجية. تمت إضافة أنواع جديدة من أهداف الأداء لاستخدامها من خلال موارد طلب إدراج والحملة.

ميزات جديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get list

• تمت إضافة الحقول التالية:

  المورد	الحقول
  تصميم الإعلان	mp3Audio oggAudio

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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 جديدة. تمت إضافة إمكانية استخدام بنود إعلانية خاصة بالتطبيقات على الأجهزة الجوّالة من خلال حقل البند الإعلاني mobileApp. إتاحة بورصة موسّعة وجمهور Google وSDF من خلال قيم تعداد إضافية أضفنا إمكانية فلترة قيم advertisers.list وترتيبها حسب وقت آخر تعديل.

ميزات جديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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

تمت إضافة إمكانية البحث عن خيارات استهداف المنطقة الجغرافية وفلترة نتائج طرق قوائم الموارد المتعددة حسب وقت آخر تعديل لها. تم طرح LineItemWarningMessage جديد لإعلام المستخدمين عندما يستخدم عنصر حملة استهدافًا جغرافيًا متوقفًا نهائيًا.

ميزات جديدة

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  targetingTypes.targetingOptions	بحث

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  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	activate create إيقاف get list patch

• تمت إضافة الحقول التالية:

  المورد	الحقول
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• يمكن الآن فلترة طرق القائمة التالية حسب الحقول التالية:

  الطريقة	الحقول
  advertisers.lineItems.list	filter.triggerId

‫12 أكتوبر 2020

تمّت إضافة رسائل تحذير قابلة للاسترداد إلى مصدر البند الإعلاني، بالإضافة إلى نوع هدف الأداء الخاص بنسبة النقر إلى الظهور. تمت إضافة warningMessages كحقل قابل للفلترة عند عرض بنود إعلانية.

بالإضافة إلى الميزات الجديدة، أصبحت حدود الحصة الجديدة سارية، ويتوفّر مستند جديد حول استخدام طلبات الدفعات.

ميزات جديدة

• تمت إضافة الحقول التالية:

  المورد	الحقول
  LineItem	warningMessages

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  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
  partners	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	create حذف get list
  المستخدمون	bulkEditAssignedUserRoles create حذف get list patch

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  المعلِنين	التدقيق

• تمت إضافة الحقول التالية:

  المورد	الحقول
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• تمت إضافة قيم التعداد التالية:

  تعداد	القيمة(القيم)
  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 جديدة، وقيم تعدادية إضافية لتبادل الإعلانات.

ميزات جديدة

• تمت إضافة الخدمات التالية:

  الخدمة	الطرق
  advertisers.channels	create
  partners.channels	create

• تمت إضافة الحقول التالية:

  المورد	الحقول
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType description displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• تمت إضافة قيم التعداد التالية:

  تعداد	القيم
  Exchange	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• يمكن الآن فلترة طرق القائمة التالية حسب الحقول التالية:

  الطريقة	الحقول
  advertisers.creatives.list	creativeId

‫02 يونيو 2020

أتحنا إمكانية إنشاء مجموعة فرعية من الكيانات القابلة للاستهداف وتعديلها وتعبئتها، وأضفنا إمكانية تعديل الاستهداف على مستوى المعلِن لثلاثة أنواع استهداف: القناة واستبعاد تصنيف المحتوى الرقمي واستبعاد الفئة الإعلانية الحسّاسة.

ميزات جديدة

• تمت إضافة الخدمات التالية:

  الخدمة	الطرق
  advertisers.channels.sites	bulkEdit create حذف list
  advertisers.locationLists.assignedLocations	bulkEdit create حذف list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit create حذف list
  advertisers.targetingTypes.assignedTargetingOptions	create حذف get list
  inventorySourceGroups.assignedInventorySources	bulkEdit create حذف list
  partners.channels.sites	bulkEdit create حذف list

• تمت إضافة الطرق التالية:

  الخدمة	الطرق
  المعلِنين	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	create patch
  advertisers.negativeKeywordLists	create حذف patch
  inventorySourceGroups	create حذف patch
  partners.channels	patch

• تمت إضافة الحقول التالية:

  المورد	الحقول
  المعلِن	servingConfig
  creative	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

‫27 نيسان (أبريل) 2020

تم إطلاق مجموعة كبيرة من الميزات، ما أدّى إلى توسيع نطاق واجهة برمجة التطبيقات ليشمل أكثر من SDF. تمت إضافة إدارة الموارد الأساسية التي تتيح لك إنشاء كيانات مثل المعلِنين والحملات وأوامر الإدراج والبنود الإعلانية وتصاميم الإعلانات واستردادها وتعديلها وحذفها. تتيح الإمكانات الجديدة أيضًا تعديل الاستهداف على مستوى البند الإعلاني.

ميزات جديدة

تمت إضافة الخدمات التالية:

الخدمة	الطرق
المعلِنين	create حذف get list patch
advertisers.assets	upload
advertisers.campaigns	create حذف get list patch
advertisers.channels	get list
advertisers.creatives	create حذف get list patch
advertisers.insertionOrders	create حذف get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions create حذف get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	create حذف 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

‫09 مارس 2020

تم إطلاق الإصدار 1 من واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360". هذا هو الإصدار الأوّلي من واجهة برمجة التطبيقات.

المشاكل المعروفة

بلا عُري