REST Resource: curators.curatedPackages

المورد: CuratedPackage

تمثّل حزمة منتقاة من المساحات الإعلانية التي أنشأها أحد "المنسّقين" ويديرها.

تمثيل JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
الحقول
name

string

المعرّف. اسم المورد الفريد للحزمة المنظَّمة التنسيق: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

الحقل مطلوب. الاسم المعروض الذي حدّده المنسّق للحزمة المنظَّمة يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة curatedPackages.list.

description

string

اختيارية: وصف للحزمة المنظَّمة يقدّمه المنظِّم

createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت إنشاء الحزمة المنظَّمة يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة curatedPackages.list.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل على الحزمة المنظَّمة يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة curatedPackages.list.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

floorPriceCpm

object (Money)

اختيارية: الحدّ الأدنى للتكلفة لكل ألف ظهور الذي يجب أن يقدّمه المشتري للمشاركة في مزادات المساحات الإعلانية المتاحة في هذه الحزمة المنظَّمة. يمكن استخدامها لفلترة استجابة طريقة curatedPackages.list.

state

enum (State)

النتائج فقط. حالة الحزمة المنظَّمة يمكن استخدامها لفلترة استجابة طريقة curatedPackages.list.

accessSettings

object (AccessControlSettings)

الحقل مطلوب. إعدادات للتحكّم في الوصول إلى الحزمة المنظَّمة

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

targeting

object (PackageTargeting)

اختيارية: معايير الاستهداف للحزمة المنظَّمة

curationFeeVisibility

enum (CurationFeeVisibility)

اختيارية: غير قابل للتغيير إمكانية ظهور رسوم حزمة التنسيق المجمّعة ورسوم شرائح البيانات (إجمالي رسوم التنسيق)

الرسوم المدفوعة للمنسّق مقابل هذه الحزمة. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
feeCpm

object (Money)

اختيارية: رسوم التكلفة لكل ألف ظهور التي يفرضها المنظِّم على المشترين الذين يستخدمون هذه الحزمة المنظَّمة. يمكن استخدام هذه المَعلمة لفلترة استجابة طريقة curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

اختيارية: سيتم تحصيل الرسوم كنسبة مئوية من تكلفة الظهور، ويتم تمثيلها بالنسبة المئوية من الألف. على سبيل المثال، يتم تمثيل %1 على النحو التالي: 1000.

نهاية الحقول التي يستبعد كلّ منها الآخر

ولاية

حالة الحزمة المنظَّمة

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية
ACTIVE الحزمة المنظَّمة نشطة.
INACTIVE الحزمة المنظَّمة غير نشطة.

AccessControlSettings

إعدادات للتحكّم في الوصول إلى حزمة منظَّمة

تمثيل JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
الحقول
allowlistedMediaPlanners[]

string

الحقل مطلوب. غير قابل للتغيير قائمة منسّقي وسائط الإعلان الذين تم منحهم صراحةً إذن الوصول إلى الحزمة المنظَّمة يمكن العثور على منسقي وسائط الإعلان المؤهَّلين في طريقة mediaPlanners.list. يمكن إضافة منسّق وسائط إعلان واحد فقط إلى القائمة المسموح بها في الوقت الحالي.

التنسيق: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

معايير الاستهداف للحزم المنظَّمة وحزم المزادات

تمثيل JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
الحقول
includedDeviceTypes[]

enum (DeviceType)

اختيارية: قائمة أنواع الأجهزة المضمّنة التي تريد استهدافها إذا كان الحقل فارغًا، يتم استهداف جميع أنواع الأجهزة.

includedEnvironment

enum (Environment)

اختيارية: البيئة المستهدَفة في حال عدم تحديدها، يتم استهداف جميع البيئات.

includedCreativeFormat

enum (CreativeFormat)

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

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

اختيارية: نوع الصفحة السريعة التحميل والمتوافقة مع الأجهزة الجوّالة المستهدَفة في حال عدم ضبط هذا الإعداد، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حالة AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

اختيارية: قائمة حالات البائعين المعتمَدين المستهدَفين المضمّنة إذا كان الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حالة البائع.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

اختيارية: أنواع المساحات الإعلانية المدمجة مع المحتوى المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن نوع المساحة الإعلانية المخصّصة للإعلانات المدمجة مع المحتوى.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

اختيارية: قائمة بأنواع القياس المفتوح المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن توافقها مع Open Measurement.

includedRestrictedCategories[]

enum (RestrictedCategory)

اختيارية: قائمة الفئات المستهدَفة الخاضعة لقيود إذا كان الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الفئات الخاضعة لقيود.

includedRewardedType

enum (RewardedType)

اختيارية: نوع الإعلان المستهدَف الذي يضم مكافأة في حال عدم ضبط هذا الإعداد، سيتم استهداف المساحات الإعلانية بغض النظر عن نوع الإعلان الذي يضم مكافأة.

videoTargeting

object (PackageVideoTargeting)

اختيارية: معايير الاستهداف الخاصة بالفيديو

minimumPredictedViewabilityPercentage

string (int64 format)

اختيارية: الحد الأدنى المستهدف للنسبة المئوية المتوقّعة لإمكانية العرض

يجب أن تكون هذه القيمة من مضاعفات العدد 10 بين 10 و90 (بما يشمل هذين الرقمَين). على سبيل المثال، الرقم 10 صالح، ولكن الأرقام 0 و15 و100 غير صالحة. وتعني القيمة 10 أنّ الإعدادات ستطابق فقط الخانات الإعلانية التي نتوقّع أن تبلغ نسبة إمكانية عرضها %10 على الأقل.

تشير القيمة غير المحدّدة إلى أنّه سيتم استهداف المساحة الإعلانية بغض النظر عن إمكانية العرض المتوقّعة.

languageTargeting

object (StringTargetingDimension)

اختيارية: اللغات المطلوب استهدافها في حال عدم ضبطها، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن اللغة. يُرجى الاطّلاع على https://developers.google.com/google-ads/api/data/codes-formats#languages للحصول على قائمة برموز اللغات المتاحة.

includedAdSizes[]

object (AdSize)

اختيارية: قائمة أحجام الإعلانات المطلوب استهدافها في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حجم الإعلان.

تتيح الحزم المنظَّمة استخدام حجمَي الإعلانات PIXEL وINTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

اختيارية: الناشرون المستهدَفون في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الناشر. يتم تحديد الناشرين من خلال الرقم التعريفي للناشر من ملف ads.txt أو app-ads.txt. لمزيد من التفاصيل، يُرجى الاطّلاع على https://iabtechlab.com/ads-txt/ وhttps://iabtechlab.com/app-ads-txt/.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

اختيارية: الحد الأدنى المستهدَف لمعدّل النقر المتوقّع، وتتراوح قيمه بين [10 و10,000] (من %0.01 إلى %10). وتعني القيمة 50 أنّ الإعدادات ستطابق فقط الخانات الإعلانية التي نتوقّع أن تحقّق نسبة نقر إلى ظهور لا تقلّ عن %0.05.

تشير القيمة غير المحدّدة إلى أنّه سيتم استهداف المساحة الإعلانية بغض النظر عن معدّل النقر المتوقّع.

verticalTargeting

object (CriteriaTargeting)

اختيارية: المجالات المضمّنة أو المستبعدة كما هو محدّد في https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن المجال.

geoTargeting

object (CriteriaTargeting)

اختيارية: أرقام تعريف المعايير الجغرافية التي سيتم تضمينها أو استبعادها كما هو محدّد في https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. في حال عدم ضبطها، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الموقع الجغرافي.

includedDataSegments[]

string

اختيارية: شرائح البيانات النشطة المطلوب استهدافها في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن شرائح البيانات. التنسيق: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

اختيارية: معلومات استهداف مواضع الإعلان، مثل عنوان URL وتطبيقات الأجهزة الجوّالة

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

اختيارية: الإشارات المقدَّمة من الناشر التي يجب استهدافها في حال عدم ضبط هذا الخيار، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن الإشارات المقدَّمة من الناشر.

DeviceType

النوع العام للجهاز الذي تريد استهدافه

عمليات التعداد
DEVICE_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
DEVICE_TYPE_PERSONAL_COMPUTER يستهدف أجهزة الكمبيوتر المكتبية أو أجهزة الكمبيوتر المحمولة.
DEVICE_TYPE_CONNECTED_TV يستهدف أجهزة التلفزيون المتّصلة: الأجهزة التي تبث محتوى التلفزيون، بما في ذلك أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب وأجهزة الاستقبال/أجهزة البث الصغيرة.
DEVICE_TYPE_PHONE يستهدف الهواتف الجوالة المتقدمة.
DEVICE_TYPE_TABLET يستهدف الأجهزة اللوحية.

البيئة

البيئة المستهدَفة

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

CreativeFormat

تنسيق تصميم الإعلان الذي يمكن استهدافه

عمليات التعداد
CREATIVE_FORMAT_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
CREATIVE_FORMAT_DISPLAY يستهدف الخانات الإعلانية المخصّصة لتصاميم الإعلانات الصورية بتنسيق HTML.
CREATIVE_FORMAT_VIDEO يستهدف الخانات الإعلانية المخصّصة لتصاميم إعلانات الفيديو.
CREATIVE_FORMAT_AUDIO يستهدف الخانات الإعلانية المخصّصة للمواد الإبداعية الصوتية.

AcceleratedMobilePageType

نوع تنفيذ Accelerated Mobile Pages (AMP) المطلوب استهدافه

عمليات التعداد
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP يستهدف هذا الخيار المساحات الإعلانية المتاحة على صفحات الويب العادية التي لا تستخدم أي إطار عمل AMP.
ACCELERATED_MOBILE_PAGE_TYPE_AMP يستهدف هذا الخيار المساحات الإعلانية المتاحة على الصفحات التي تم إنشاؤها باستخدام إطار عمل HTML الأساسي لصفحات AMP.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY يستهدف هذا الخيار المساحات الإعلانية المتاحة على الصفحات التي تستخدم تنسيق "سجلّ AMP"‏ (STAMP)، والذي تم تحسينه لسرد القصص المرئية (مثل تجارب ملء الشاشة القابلة للنقر).

AuthorizedSellerStatus

تمثّل العلاقة بين الناشر والبائع كما هو موضّح في ملف ads.txt أو app-ads.txt.

عمليات التعداد
AUTHORIZED_SELLER_STATUS_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
AUTHORIZED_SELLER_STATUS_DIRECT يستهدف المساحات الإعلانية التي تم فيها تحديد البائع على أنّه "مباشر". يشير ذلك إلى أنّ الناشر (مالك المحتوى) يتحكّم مباشرةً في حساب البائع، وأنّه أبرم عقدًا تجاريًا مباشرًا مع النظام الإعلاني لهذا الحساب.
AUTHORIZED_SELLER_STATUS_RESELLER يستهدف هذا الخيار المساحة الإعلانية التي يتم فيها تحديد البائع على أنّه "مورّد". يشير ذلك إلى أنّ الناشر قد فوَّض جهة أخرى لتشغيل حساب البائع المُدرَج وإعادة بيع مساحته الإعلانية.

NativeInventoryType

تمثّل نوع عرض تصميم الإعلان الذي تتيحه خانة إعلانية، وتحديدًا في ما يتعلّق بـ "الإعلانات المدمجة مع المحتوى".

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

OpenMeasurementType

نوع تعريف واجهة القياس المفتوح (OMID) المطلوب استهدافه

عمليات التعداد
OPEN_MEASUREMENT_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
OPEN_MEASUREMENT_TYPE_OMID_V1 يستهدف هذا الخيار المساحات الإعلانية التي تتوافق مع الإصدار 1 من "تعريف واجهة القياس المفتوح" (OMID).

RestrictedCategory

تمثّل فئات الإعلانات المحدّدة التي تحظر السياسة استهدافها.

عمليات التعداد
RESTRICTED_CATEGORY_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
RESTRICTED_CATEGORY_ALCOHOL يستهدف هذا الخيار المساحات الإعلانية التي يسمح فيها الناشر بعرض إعلانات عن المشروبات الكحولية.
RESTRICTED_CATEGORY_GAMBLING يستهدف هذا الإعداد المساحات الإعلانية المتاحة التي يسمح فيها الناشر بعرض إعلانات المقامرة.

RewardedType

يحدّد معايير الاستهداف استنادًا إلى ما إذا كانت المساحات الإعلانية المتاحة تقدّم مكافأة للمستخدم مقابل مشاهدة إعلان.

عمليات التعداد
REWARDED_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
REWARDED_TYPE_NON_REWARDED يستهدف هذا الخيار المساحات الإعلانية التي لا تقدّم مكافأة صريحة للمستخدم مقابل مشاهدة الإعلان أو التفاعل معه.
REWARDED_TYPE_REWARDED يستهدف هذا الخيار المساحات الإعلانية التي تقدّم مكافأة للمستخدم مقابل مشاهدة الإعلان أو التفاعل معه.

PackageVideoTargeting

معايير الاستهداف الخاصة بالفيديو

تمثيل JSON
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
الحقول
includedMimeTypes[]

enum (VideoMimeType)

اختيارية: قائمة أنواع MIME المستهدَفة للفيديوهات باستخدام سلاسل أنواع MIME المنشورة من قِبل هيئة IANA‏ (https://www.iana.org/assignments/media-types/media-types.xhtml). إذا كان الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن نوع MIME للفيديو.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

اختيارية: الحد الأقصى المستهدف لمدة إعلان الفيديو في حال عدم ضبط هذه القيمة، سيتم استهداف المساحة الإعلانية بغض النظر عن الحد الأقصى لمدة إعلان الفيديو.

includedPositionTypes[]

enum (PositionType)

اختيارية: أنواع مواضع عرض إعلانات الفيديو المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن نوع موضع عرض إعلان الفيديو.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

اختيارية: طريقة عرض الفيديو المستهدَفة وفي حال عدم ضبط هذا الإعداد، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن طريقة عرض الفيديو.

plcmtTargeting

object (VideoPlcmtTargeting)

اختيارية: أنواع مواضع إعلانات الفيديو المستهدَفة في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن نوع موضع إعلان الفيديو.

includedPlaybackMethods[]

enum (PlaybackMethod)

اختيارية: قائمة طرق تشغيل الفيديو المستهدَفة إذا كان هذا الحقل فارغًا، سيتم استهداف المساحة الإعلانية بغض النظر عن طريقة تشغيل الفيديو.

minimumPredictedCompletionRatePercentage

string (int64 format)

اختيارية: النسبة المئوية المستهدَفة للحدّ الأدنى لمعدّل الإكمال المتوقّع

يجب أن تكون هذه القيمة من مضاعفات العدد 10 بين 10 و90 (بما يشمل هذين الرقمَين). على سبيل المثال، الرقم 10 صالح، ولكن الأرقام 0 و15 و100 غير صالحة. وتعني القيمة 10 أنّ الإعدادات ستتطابق فقط مع الخانات الإعلانية التي نتوقّع أن تبلغ نسبة إكمالها %10 على الأقل.

تشير القيمة غير المحدّدة إلى أنّه سيتم استهداف المساحة الإعلانية بغض النظر عن معدّل الإكمال المتوقّع.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

اختيارية: حجم مشغّل الفيديو المستهدَف في حال عدم ضبط هذه السياسة، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن حجم مشغّل الفيديو.

VideoMimeType

أنواع MIME للفيديو المطلوب استهدافها

عمليات التعداد
VIDEO_MIME_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
VIDEO_MIME_TYPE_THREEGPP تنسيق حاوية 3GPP يُستخدَم على هواتف الجيل الثالث (3G).
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 حاوية MPEG-4 مع برنامج ترميز H.264 عادةً
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT ‫JavaScript (تُستخدَم لإعلانات VPAID)
VIDEO_MIME_TYPE_WEBM حاوية WebM تستخدم برنامج ترميز VP9

MaximumVideoAdDuration

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

عمليات التعداد
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 15 ثانية (0 < المدة <= 15 ثانية).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 20 ثانية (0 < المدة <= 20 ثانية).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 30 ثانية (0 < المدة <= 30 ثانية).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 60 ثانية (0 < المدة <= 60 ثانية).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 90 ثانية (0 < المدة <= 90 ثانية).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS ينطبق ذلك على إعلانات الفيديو التي تصل مدتها إلى 120 ثانية (0 < المدة <= 120 ثانية).

PositionType

الموضع القابل للاستهداف للإعلان ضمن فيديو معيّن

عمليات التعداد
POSITION_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
POSITION_TYPE_MIDROLL يتم تشغيل الإعلان في منتصف محتوى الفيديو.
POSITION_TYPE_POSTROLL يتم تشغيل الإعلان بعد محتوى الفيديو.
POSITION_TYPE_PREROLL يتم تشغيل الإعلان قبل محتوى الفيديو.

ContentDeliveryMethod

معايير الاستهداف المستندة إلى طريقة عرض محتوى الفيديو

عمليات التعداد
CONTENT_DELIVERY_METHOD_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
CONTENT_DELIVERY_METHOD_STREAMING يستهدف محتوى الفيديو الذي يتم بثه مباشرةً.
CONTENT_DELIVERY_METHOD_PROGRESSIVE يستهدف محتوى الفيديو الذي يتم نقله بشكل تدريجي حسب متطلبات تشغيل العميل.

VideoPlcmtTargeting

يحدّد معايير الاستهداف استنادًا إلى نوع موضع إعلان الفيديو، وغالبًا ما يتوافق مع حقل "plcmt" في OpenRTB من IAB.

تمثيل JSON
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
الحقول
selectionType

enum (SelectionType)

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

videoPlcmtTypes[]

enum (VideoPlcmtType)

الحقل مطلوب. قائمة بأنواع مواضع إعلانات الفيديو المستهدَفة إذا كان الحقل فارغًا، سيتم استهداف المساحات الإعلانية المتاحة بغض النظر عن نوع موضع إعلان الفيديو.

SelectionType

قائمة تعداد لأنواع الاختيار المحتملة التي تستخدمها سمات الاستهداف

عمليات التعداد
SELECTION_TYPE_UNSPECIFIED نوع الاختيار غير محدّد. يجب عدم استخدامها.
SELECTION_TYPE_INCLUDE يتم تضمين القيم في سمة الاستهداف.
SELECTION_TYPE_EXCLUDE يتم استبعاد القيم في سمة الاستهداف.

VideoPlcmtType

يمثّل نوع موضع إعلان الفيديو، بما يتوافق مع معايير OpenRTB.

عمليات التعداد
VIDEO_PLCMT_TYPE_UNSPECIFIED القيمة التلقائية ولا يجب استخدامها في مواصفات الاستهداف.
INSTREAM "الإعلانات ما قبل التشغيل" و"الإعلانات أثناء التشغيل" و"الإعلانات ما بعد التشغيل" التي يتم تشغيلها قبل محتوى الفيديو الذي طلبه المستهلك أو أثناء بثه أو بعده يجب ضبط "إعلانات الفيديو أثناء عرض الفيديو" على "تفعيل الصوت" تلقائيًا عند بدء تشغيل المشغّل، أو أن تكون نية المستخدم واضحة وصريحة لمشاهدة محتوى الفيديو. على الرغم من احتمال وجود محتوى آخر يحيط بالمشغّل، يجب أن يكون محتوى الفيديو هو السبب الرئيسي لزيارة المستخدم. ويجب أن يظلّ المحتوى الأساسي على الصفحة ومشغّل الفيديو الوحيد المعروض الذي يمكنه تشغيل الصوت. إذا تم تحويل المشغّل إلى عائم/ثابت، يجب أن تنقل طلبات عرض الإعلانات اللاحقة حجم المشغّل المعدَّل بدقة.
ACCOMPANYING_CONTENT "الإعلانات ما قبل التشغيل" و"الإعلانات أثناء التشغيل" و"الإعلانات ما بعد التشغيل" التي يتم تشغيلها قبل بث محتوى الفيديو أو أثناء بثه أو بعده يتم تحميل مشغّل الفيديو وتشغيله قبل فقرات النص أو المحتوى الرسومي أو بينها أو بعدها، ويبدأ تشغيله فقط عندما يدخل إلى إطار العرض. يجب ألا يبدأ تشغيل المحتوى المصاحب إلا عند دخوله إلى إطار العرض. وقد يتحوّل إلى مشغّل عائم/ثابت أثناء الانتقال إلى أسفل الصفحة.
INTERSTITIAL إعلانات الفيديو التي يتم تشغيلها بدون محتوى فيديو أثناء التشغيل، يجب أن يكون الفيديو هو المحتوى الرئيسي للصفحة وأن يشغل معظم إطار العرض وألّا يتم إخفاؤه من خلال الانتقال إلى أسفل الصفحة. ويمكن أن يكون ذلك في مواضع مثل الفيديو داخل التطبيق أو عروض الشرائح.
NO_CONTENT إعلانات الفيديو التي يتم تشغيلها بدون بث محتوى الفيديو ويمكن أن يكون ذلك في مواضع مثل عروض الشرائح أو الخلاصات المدمجة مع المحتوى أو الإعلانات المضمّنة في المحتوى أو الإعلانات الثابتة/العائمة.

PlaybackMethod

طريقة التشغيل المطلوب استهدافها

عمليات التعداد
PLAYBACK_METHOD_UNSPECIFIED طريقة تشغيل الفيديو غير محدّدة يجب عدم استخدامها.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON يبدأ التشغيل تلقائيًا عند تحميل الصفحة أو المحتوى.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF يبدأ التشغيل تلقائيًا عند تحميل الصفحة أو المحتوى، ولكن بدون صوت.
PLAYBACK_METHOD_CLICK_TO_PLAY يبدأ التشغيل من خلال إجراء يتّخذه المستخدم (مثل النقر على زر التشغيل).

VideoPlayerSizeTargeting

تمثّل حجم مشغّل الفيديو الذي يمكن استهدافه. يجب ضبط كل من العرض والارتفاع على قيم غير صفرية.

تمثيل JSON
{
  "minimumWidth": string,
  "minimumHeight": string
}
الحقول
minimumWidth

string (int64 format)

الحقل مطلوب. الحد الأدنى لعرض مشغّل الفيديو بالبكسل

minimumHeight

string (int64 format)

الحقل مطلوب. الحد الأدنى لارتفاع مشغّل الفيديو بالبكسل

StringTargetingDimension

استهداف عام باستخدام قيم سلاسل

تمثيل JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
الحقول
selectionType

enum (SelectionType)

الحقل مطلوب. كيفية استهداف العناصر في هذه القائمة

values[]

string

الحقل مطلوب. القيم المحدّدة

AdSize

تمثّل هذه السمة حجم خانة إعلانية واحدة أو تصميم إعلان واحد.

تمثيل JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
الحقول
width

string (int64 format)

عرض الخانة الإعلانية بالبكسل لن يظهر هذا الحقل إلا عندما يكون نوع المقاس PIXEL.

height

string (int64 format)

ارتفاع الخانة الإعلانية بالبكسل لن يظهر هذا الحقل إلا عندما يكون نوع المقاس PIXEL.

type

enum (Type)

نوع حجم الخانة الإعلانية

النوع

تمثّل هذه السمة أنواعًا مختلفة من أحجام الخانات الإعلانية أو أحجام التصاميم.

عمليات التعداد
TYPE_UNSPECIFIED عنصر نائب لنوع حجم غير محدّد
PIXEL خانة إعلانية بحجم محدّد حسب الارتفاع والعرض بالبكسل
INTERSTITIAL حجم خاص لوصف خانة إعلانية بينية
NATIVE الإعلانات المدمجة مع المحتوى (على الأجهزة الجوّالة) التي يعرضها الناشر
FLUID يمكن تغيير الحجم المرن (الحجم المتجاوب) تلقائيًا مع تغيُّر البيئة الخارجية.

CriteriaTargeting

الاستهداف العام المستخدَم لاستهداف السمات التي تحتوي على قائمة بمعرّفات رقمية مضمّنة ومستبعَدة لا يمكن فلترة هذه القائمة باستخدام بنية فلتر القائمة.

تمثيل JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
الحقول
targetedCriteriaIds[]

string (int64 format)

قائمة بأرقام التعريف الرقمية التي سيتم تضمينها

excludedCriteriaIds[]

string (int64 format)

قائمة بالمعرّفات الرقمية التي سيتم استبعادها

PackagePlacementTargeting

تمثّل الاستهداف المتعلّق بأماكن ظهور الإعلانات، مثل مواقع إلكترونية أو تطبيقات معيّنة للأجهزة الجوّالة. سيتم دمج أنواع استهداف مواضع الإعلان المختلفة منطقيًا باستخدام عامل التشغيل OR.

تمثيل JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
الحقول
uriTargeting

object (StringTargetingDimension)

اختيارية: قائمة عناوين URL المستهدَفة أو المستبعَدة. يجب إزالة http/https من النطاقات (على سبيل المثال، google.com)، ويمكن أن تحتوي على 5 مسارات كحدّ أقصى لكل عنوان URL.

mobileAppTargeting

object (StringTargetingDimension)

اختيارية: قائمة بمعرّفات التطبيقات المتوافقة مع الأجهزة الجوّالة المستهدَفة أو المستبعَدة التي يملكها الناشرون في الوقت الحالي، تتوفّر تطبيقات Android وApple فقط.

يمكن العثور على معرّف تطبيق Android، مثل com.google.android.apps.maps، في عنوان URL لمتجر Google Play. ويمكن العثور على معرّف تطبيق iOS (وهو رقم) في نهاية عنوان URL لمتجر iTunes. يتم تضمين تطبيقات الأجهزة الجوّالة التابعة للطرف الأول أو استبعادها.

includedMobileAppCategoryTargeting[]

string (int64 format)

اختيارية: قائمة فئات التطبيقات المتوافقة مع الأجهزة الجوّالة المستهدَفة

PackagePublisherProvidedSignalsTargeting

تمثّل الاستهداف المتعلّق بالإشارات المقدَّمة من الناشر. سيتم دمج الأنواع المختلفة من الإشارات المقدَّمة من الناشر باستخدام عامل التشغيل المنطقي OR.

تمثيل JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
الحقول
audienceTargeting

object (TaxonomyTargeting)

اختيارية: قائمة بأرقام تعريف الجمهور المستهدَف أو المستبعَد استنادًا إلى الإصدار 1.1 من تصنيف IAB للجمهور (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

اختيارية: قائمة معرّفات Content ID المستهدَفة أو المستبعَدة يستند إلى الإصدار 2.2 من تصنيف المحتوى لدى IAB‏ (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

اختيارية: قائمة بمعرّفات إشارات الفيديو والصوت المستهدَفة والمستبعَدة هذه إشارات إضافية متوافقة مع الإشارات المقدَّمة من الناشر.

TaxonomyTargeting

تحدّد معايير الاستهداف للتعامل مع مساحة معرّف تصنيف المحتوى والجمهور في IAB.

تمثيل JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
الحقول
targetedTaxonomyIds[]

string

اختيارية: قائمة أرقام تعريف تصنيف المحتوى المستهدَف

excludedTaxonomyIds[]

string

اختيارية: قائمة أرقام تعريف تصنيفات المحتوى المستبعَدة

CurationFeeVisibility

مستوى ظهور رسوم حزمة التنسيق المجمّعة ورسوم شرائح البيانات (إجمالي رسوم التنسيق) تظهر الرسوم دائمًا لمنشئ الحزمة.

عمليات التعداد
CURATION_FEE_VISIBILITY_UNSPECIFIED لم يتم تحديد إمكانية رؤية إجمالي رسوم التنظيم.
DISCLOSED تظهر رسوم التنظيم الإجمالية لجميع المشترين. هذه هي القيمة التلقائية في حال عدم ضبطها.
NON_DISCLOSED لا يظهر إجمالي رسوم التنظيم لجميع المشترين.

الطُرق

activate

يؤدي هذا الإجراء إلى تفعيل حزمة منظَّمة حالية.

create

يؤدي هذا الإجراء إلى إنشاء حزمة منظَّمة جديدة.

deactivate

لإيقاف حزمة منظَّمة حالية

get

للحصول على حزمة منظَّمة استنادًا إلى اسم المورد

list

تعرض هذه الطريقة الحِزم المنظَّمة التي يملكها القيّم المحدّد.

patch

تعديل حزمة منظَّمة حالية