ملاحظات الإصدار

توفر هذه الصفحة ملاحظات الإصدار لشاشة العرض Video 360 API:

أحدث إصدار من واجهة برمجة التطبيقات: v3

15 يوليو 2024

ميزات جديدة

تمت إضافة إمكانية تنزيل ملفات البيانات المنظَّمة الخاصة بالعناصر والمجموعات الإعلانية بتنسيق تنسيق تأكيد الجودة في الإصدار 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

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

  المورد	الحقول
  مؤشر الأداء الرئيسي	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 TV في استهدافه

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

v3

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

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

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

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

v2

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

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

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

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

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

ميزات جديدة

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

v3

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

  المورد	الحقول
  ContactInfoList	الموافقة
  MobileDeviceIdList	الموافقة

v2

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

  المورد	الحقول
  ContactInfoList	الموافقة
  MobileDeviceIdList	الموافقة

31 تشرين الأول (أكتوبر) 2023

ميزات جديدة

تم نقل الإصدار الثالث من الإصدار التجريبي المتاح للجميع إلى "إتاحة الإصدار العام".

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

ميزات جديدة

تم إصدار الإصدار v3 في إصداره التجريبي المتاح للجميع، والذي يتضمّن التغييرات التالية:

• يمكن إدارة قوائم المواقع القريبة بشكلٍ كامل، ما يتيح استخدام 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	يتيح الآن إنشاء موارد LocationList عددها TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.patch	يتيح الآن تعديل موارد LocationList عددها TARGETING_LOCATION_TYPE_PROXIMITY.
  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

ميزات جديدة

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

تمت إضافة حقل 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:

• خيارات الاستهداف المحدّدة لأنواع الاستهداف التي تمّ تعيينها باستخدام enum تعذّرت إزالة أو استرداد القيم في الإصدار 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
  الشركاء	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	الأوميد
  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	التبادل
  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	التبادل
  GenderAssignedTargetingOptionDetails	gender
  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

• تمت إضافة قيم التعداد التالية في الإصدار 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 التصحيح
  inventorySources	إنشاء editInventorySourceReadWriteAccessors التصحيح

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

  المورد	الحقول
  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 التصحيح

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

  المورد	الحقول
  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.scripts جديدة في استرداد البيانات والإنشاء customBiddingScripts.

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

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

ميزات جديدة

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

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

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

  التعداد	القيم
  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
  نص طلب TargetOptions.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

تمت إضافة دعم بشأن تفعيل القياس المفتوح. استهداف المستودع الإعلاني ضمن نوع الاستهداف 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

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

  الطريقة	الحد الأقصى لحجم الصفحة القديم	الحد الأقصى الجديد لحجم الصفحة
  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	الحصول على القائمة

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

  المورد	الحقول
  تصميم الإعلان	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

تمت إضافة إمكانية البحث عن خيارات استهداف المنطقة الجغرافية وفلترة الموارد المتعددة قائمة نتائج طرق البحث حسب وقت آخر تحديث لها. تم تقديم new 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	تفعيل إنشاء إيقاف الحصول على القائمة رمز التصحيح

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

  المورد	الحقول
  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

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

ميزات جديدة

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

  المورد	الحقول
  المعلِنون.نص استجابة التدقيق	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	الحصول على القائمة
  الشركاء	bulkEditPartnerAssignedTargetingOptions الحصول على القائمة
  partners.targetingTypes.assignedTargetingOptions	إنشاء حذف الحصول على القائمة
  المستخدمون	bulkEditAssignedUserRoles إنشاء حذف الحصول على القائمة رمز التصحيح

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

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

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

  المورد	الحقول
  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	إنشاء
  partners.channels	إنشاء

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

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

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

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

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

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

2 حزيران (يونيو) 2020

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

ميزات جديدة

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

  الخدمة	الطُرق
  advertisers.channels.sites	bulkEdit إنشاء حذف القائمة
  advertisers.locationLists.assignedLocations	bulkEdit إنشاء حذف القائمة
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit إنشاء حذف القائمة
  advertisers.targetingTypes.assignedTargetingOptions	إنشاء حذف الحصول على القائمة
  inventorySourceGroups.assignedInventorySources	bulkEdit إنشاء حذف القائمة
  partners.channels.sites	bulkEdit إنشاء حذف القائمة

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

  الخدمة	الطُرق
  المعلنون	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	رمز التصحيح
  advertisers.locationLists	إنشاء رمز التصحيح
  advertisers.negativeKeywordLists	إنشاء حذف رمز التصحيح
  inventorySourceGroups	إنشاء حذف رمز التصحيح
  partners.channels	رمز التصحيح

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

  المورد	الحقول
  المعلِن	servingConfig
  المواد الإبداعية	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

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

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

ميزات جديدة

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

الخدمة	الطُرق
المعلنون	إنشاء حذف الحصول على القائمة رمز التصحيح
advertisers.assets	تحميل
advertisers.campaigns	إنشاء حذف الحصول على القائمة رمز التصحيح
advertisers.channels	الحصول على القائمة
advertisers.creatives	إنشاء حذف الحصول على القائمة رمز التصحيح
advertisers.insertionOrders	إنشاء حذف الحصول على القائمة رمز التصحيح
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions إنشاء حذف الحصول على القائمة رمز التصحيح
advertisers.lineItems.targetingTypes.assignedTargetingOptions	إنشاء حذف الحصول على القائمة
advertisers.locationLists	الحصول على القائمة
advertisers.negativeKeywordLists	الحصول على القائمة
combinedAudiences	الحصول على القائمة
customLists	الحصول على القائمة
firstAndThirdPartyAudiences	الحصول على القائمة
floodlightGroups	الحصول على رمز التصحيح
googleAudiences	الحصول على القائمة
inventorySourceGroups	الحصول على القائمة
inventorySources	الحصول على القائمة
partners.channels	الحصول على القائمة
partners.channels	الحصول على القائمة

9 آذار (مارس) 2020

تم إطلاق الشبكة الإعلانية الإصدار الأول من واجهة برمجة التطبيقات Video 360 API هذا هو الإصدار الأولي من واجهة برمجة التطبيقات.

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

بلا عُري