REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

المورد: AssignedTargetingOption

خيار استهداف واحد تمّ تعيينه، ويحدّد حالة خيار الاستهداف لعنصر يتضمّن إعدادات الاستهداف.

تمثيل JSON 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
الحقول
name

string

النتائج فقط. اسم المورد لخيار الاستهداف المُعيَّن هذا.
assignedTargetingOptionId

string

النتائج فقط. المعرّف الفريد لخيار الاستهداف المحدّد. يكون المعرّف فريدًا فقط ضمن مورد ونوع استهداف محدّدَين. ويمكن إعادة استخدامه في سياقات أخرى.
assignedTargetingOptionIdAlias

string

للقراءة فقط. اسم مستعار لـ assignedTargetingOptionId. يمكن استخدام هذه القيمة بدلاً من assignedTargetingOptionId عند استرداد الاستهداف الحالي أو حذفه.

لن يتوفّر هذا الحقل إلا لجميع خيارات الاستهداف المحدّدة لأنواع الاستهداف التالية:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

يتوافق هذا الحقل أيضًا مع خيارات الاستهداف المُعيّنة للبند الإعلاني لأنواع الاستهداف التالية:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

النتائج فقط. تحدّد هذه السمة نوع خيار الاستهداف المحدّد.
inheritance

enum (Inheritance)

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

object (ChannelAssignedTargetingOptionDetails)

تفاصيل القناة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

object (AppAssignedTargetingOptionDetails)

تفاصيل التطبيق سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

تفاصيل عنوان URL سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

تفاصيل اليوم والوقت سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

تفاصيل الفئة العمرية سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

تفاصيل قائمة المواقع الجغرافية الإقليمية سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

تفاصيل قائمة المواقع الجغرافية القريبة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

تفاصيل الجنس سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

تفاصيل حجم مشغّل الفيديو سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

تفاصيل المحتوى الذي يقدّم مكافآت للمستخدمين سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

تفاصيل الحالة الأبوية سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

تفاصيل موضع المحتوى داخل الفيديو. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

تفاصيل موضع الإعلان خارج البث سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

تفاصيل نوع الجهاز سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

تفاصيل استهداف الجمهور سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_AUDIENCE_GROUP. يمكنك استهداف خيار واحد فقط من خيارات شريحة الجمهور لكل مرجع.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

تفاصيل المتصفّح سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

تفاصيل دخل الأسرة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

تفاصيل موضع الإعلان على الشاشة، وسيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

تفاصيل مشغّل شبكة الجوّال ومزوّد خدمة الإنترنت سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

يمكن تعيين 5000 كلمة رئيسية سلبية مباشرةً بحدّ أقصى لأحد المراجع، ولا يوجد حدّ لعدد الكلمات الرئيسية الإيجابية التي يمكن تعيينها.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

يمكن تعيين 4 قوائم كلمات رئيسية سلبية كحدّ أقصى لأحد المراجع.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

تفاصيل نظام التشغيل سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

تفاصيل العلامة التجارية للجهاز وطرازه سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

تفاصيل البيئة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

تفاصيل مصدر المستودع سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

تفاصيل الفئة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CATEGORY.

سيؤدي استهداف فئة إلى استهداف فئاتها الفرعية أيضًا. إذا تم استبعاد فئة من الاستهداف وتم تضمين فئة فرعية، ستكون الأولوية للاستبعاد.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

تفاصيل إمكانية العرض سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_VIEWABILITY.

يمكنك استهداف خيار واحد فقط من خيارات مدى الظهور لكلّ مرجع.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

تفاصيل حالة البائع المُعتمَد سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

إذا لم يتضمّن أحد المراجع خيار حالة البائع المعتمَد، سيتم تلقائيًا استهداف جميع البائعين المعتمَدين الذين تمّت الإشارة إليهم على أنّهم DIRECT أو RESELLER في ملف ads.txt.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

تفاصيل اللغة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

تفاصيل المنطقة الجغرافية سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

تفاصيل مجموعة مصدر المستودع. سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

تفاصيل تصنيف المحتوى الرقمي سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

تفاصيل الفئة الإعلانية الحسّاسة. سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

الفئات الحساسة هي استثناءات الاستهداف. يتم دائمًا تطبيق استثناءات الفئات الإعلانية الحسّاسة على مستوى المعلِن في العرض (حتى إذا لم تكن ظاهرة في إعدادات المورد)، وذلك في حال ضبطها. يمكن أن تستبعد إعدادات الموارد الفئات الحسّاسة بالإضافة إلى استبعادات المعلِنين، ولكن لا يمكنها تجاهل هذه الاستبعادات.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

تفاصيل موضوع المحتوى سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

مواضيع المحتوى هي استثناءات الاستهداف. يتم دائمًا تطبيق استثناءات مواضيع المحتوى على مستوى المعلِن، إذا تم ضبطها، في العرض (حتى إذا لم تكن ظاهرة في إعدادات المورد). يمكن أن تستبعد إعدادات المورد مواضيع المحتوى بالإضافة إلى استثناءات المعلِن.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

تفاصيل التبادل: سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

تفاصيل التبادل الفرعي سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

تفاصيل عملية إثبات الملكية من خلال جهة خارجية سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

تفاصيل نقطة الاهتمام: سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

تفاصيل سلسلة الأنشطة التجارية. سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

تفاصيل مدة المحتوى سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

تفاصيل مدة المحتوى سيتم ملء هذا الحقل عندما يكون TargetingType هو TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

تفاصيل موضع المحتوى الأصلي سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

تفاصيل المستودع الإعلاني الذي تم تفعيل Open Measurement فيه سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

تفاصيل نوع المحتوى الصوتي سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

تفاصيل نوع المحتوى سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

تفاصيل فيديو على YouTube، وسيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

تفاصيل قناة على YouTube سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

تفاصيل موضع الجلسة سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_SESSION_POSITION.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

تفاصيل مجموعة قنوات YouTube سيتم ملء هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

الاكتساب

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

عمليات التعداد
INHERITANCE_UNSPECIFIED لم يتم تحديد حالة الوراثة أو أنّها غير معروفة.
NOT_INHERITED لا يتم نقل خيار الاستهداف الذي تم تعيينه من عنصر ذي مستوى أعلى.
INHERITED_FROM_PARTNER يتم اكتساب خيار الاستهداف المحدّد من إعدادات استهداف الشريك.
INHERITED_FROM_ADVERTISER يتمّ استيراد خيار الاستهداف المحدّد من إعدادات استهداف المعلِن.

ChannelAssignedTargetingOptionDetails

تفاصيل خيار استهداف القنوات المعيّنة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_CHANNEL.

تمثيل JSON 
{
  "channelId": string,
  "negative": boolean
}
الحقول
channelId

string (int64 format)

الحقل مطلوب. معرّف القناة يجب أن يشير إلى حقل معرّف القناة في مورد قناة يملكها الشريك أو قناة يملكها المعلِن.
negative

boolean

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

AppCategoryAssignedTargetingOptionDetails

تفاصيل خيار استهداف فئة التطبيقات المحدّدة سيتم ملء هذا الحقل في حقل appCategoryDetails الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_APP_CATEGORY.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

النتائج فقط. الاسم المعروض لفئة التطبيق
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_APP_CATEGORY
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

AppAssignedTargetingOptionDetails

تفاصيل خيار استهداف التطبيقات الذي تمّ تعيينه سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_APP.

تمثيل JSON 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
الحقول
appId

string

الحقل مطلوب. معرّف التطبيق

يستخدم تطبيق "متجر Play" على Android معرّف الحزمة، مثل com.google.android.gm. يستخدم رقم تعريف تطبيق Apple في متجر التطبيقات سلسلة من 9 أرقام، مثل 422689480.
displayName

string

النتائج فقط. الاسم المعروض للتطبيق
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.
appPlatform

enum (AppPlatform)

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

AppPlatform

خيارات استهداف منصات التطبيقات المحتملة

عمليات التعداد
APP_PLATFORM_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد نظام تشغيل التطبيق في هذا الإصدار. هذه القائمة هي عنصر نائب للقيمة التلقائية ولا تمثّل خيارًا حقيقيًا للمنصة.
APP_PLATFORM_IOS نظام تشغيل التطبيق هو iOS.
APP_PLATFORM_ANDROID النظام الأساسي للتطبيق هو Android.
APP_PLATFORM_ROKU نظام تشغيل التطبيق هو Roku.
APP_PLATFORM_AMAZON_FIRETV نظام تشغيل التطبيق هو Amazon FireTV.
APP_PLATFORM_PLAYSTATION منصّة التطبيق هي Playstation.
APP_PLATFORM_APPLE_TV النظام الأساسي للتطبيق هو Apple TV.
APP_PLATFORM_XBOX نظام تشغيل التطبيق هو Xbox.
APP_PLATFORM_SAMSUNG_TV منصّة التطبيق هي Samsung TV.
APP_PLATFORM_ANDROID_TV نظام تشغيل التطبيق هو Android TV.
APP_PLATFORM_GENERIC_CTV منصة التطبيق هي منصة تلفزيون متّصل غير مُدرَجة بشكل صريح في مكان آخر.
APP_PLATFORM_LG_TV منصّة التطبيق هي تلفزيون LG.
APP_PLATFORM_VIZIO_TV منصة التطبيق هي VIZIO TV.
APP_PLATFORM_VIDAA نظام تشغيل التطبيق هو Vidaa.

UrlAssignedTargetingOptionDetails

تفاصيل خيار استهداف عناوين URL الذي تمّ تعيينه سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_URL.

تمثيل JSON 
{
  "url": string,
  "negative": boolean
}
الحقول
url

string

الحقل مطلوب. تمثّل هذه السمة عنوان URL، مثلاً example.com.

تتيح "مساحة العرض والفيديو 360" مستويَين من استهداف الأدلة الفرعية، مثل www.example.com/one-subdirectory-level/second-level، وخمسة مستويات من استهداف النطاقات الفرعية، مثل five.four.three.two.one.example.com.
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

DayAndTimeAssignedTargetingOptionDetails

تمثّل هذه السمة جزءًا من الوقت محدّدًا في يوم معيّن من الأسبوع مع وقتَي بدء وانتهاء، ويجب أن يسبق الوقت الممثّل بـ startHour الوقت الممثّل بـ endHour.

تمثيل JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
الحقول
dayOfWeek

enum (DayOfWeek)

الحقل مطلوب. يوم الأسبوع لإعداد استهداف اليوم والوقت هذا
startHour

integer

الحقل مطلوب. ساعة البدء لاستهداف الأيام والأوقات يجب أن تتراوح القيمة بين 0 (بداية اليوم) و23 (قبل ساعة واحدة من نهاية اليوم).
endHour

integer

الحقل مطلوب. تمثّل هذه السمة ساعة الانتهاء من استهداف الأيام والأوقات. يجب أن تتراوح القيمة بين 1 (بعد ساعة واحدة من بداية اليوم) و24 (نهاية اليوم).
timeZoneResolution

enum (TimeZoneResolution)

الحقل مطلوب. الآلية المستخدَمة لتحديد المنطقة الزمنية التي سيتم استخدامها في إعداد الاستهداف حسب اليوم والوقت هذا

بالنسبة إلى بنود "حملات زيادة الطلب"، تكون قيمة هذا الحقل دائمًا TIME_ZONE_RESOLUTION_ADVERTISER.

DayOfWeek

تمثّل هذه السمة يومًا من أيام الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED لم يتم تحديد يوم الأسبوع.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

TimeZoneResolution

الأساليب المحتملة لحلّ مشكلة المنطقة الزمنية

عمليات التعداد
TIME_ZONE_RESOLUTION_UNSPECIFIED لا يمكن تحديد المنطقة الزمنية أو أنّها غير معروفة.
TIME_ZONE_RESOLUTION_END_USER يتم تحديد الأوقات في المنطقة الزمنية للمستخدم الذي شاهد الإعلان.
TIME_ZONE_RESOLUTION_ADVERTISER يتم تحديد الأوقات في المنطقة الزمنية للمعلِن الذي عرض الإعلان.

AgeRangeAssignedTargetingOptionDetails

تمثّل هذه السمة فئة عمرية يمكن استهدافها، وسيتم ملؤها في حقل "التفاصيل" الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_AGE_RANGE.

تمثيل JSON 
{
  "ageRange": enum (AgeRange)
}
الحقول
ageRange

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

تفاصيل الاستهداف لقائمة المواقع الجغرافية الإقليمية سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_REGIONAL_LOCATION_LIST.

تمثيل JSON 
{
  "regionalLocationListId": string,
  "negative": boolean
}
الحقول
regionalLocationListId

string (int64 format)

الحقل مطلوب. معرّف قائمة المواقع الجغرافية الإقليمية. يجب أن يشير إلى الحقل locationListId الخاص بمورد LocationList الذي يكون نوعه TARGETING_LOCATION_TYPE_REGIONAL.
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

ProximityLocationListAssignedTargetingOptionDetails

تفاصيل الاستهداف لقائمة المواقع الجغرافية القريبة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

تمثيل JSON 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
الحقول
proximityLocationListId

string (int64 format)

الحقل مطلوب. معرّف قائمة المواقع الجغرافية القريبة. يجب أن يشير إلى الحقل locationListId الخاص بمورد LocationList الذي يكون نوعه TARGETING_LOCATION_TYPE_PROXIMITY.
proximityRadius

number

الحقل مطلوب. النطاق الجغرافي معبّرًا عنه بوحدات المسافة المحدّدة في proximityRadiusUnit. يمثّل ذلك حجم المنطقة المحيطة بموقع جغرافي محدّد سيتم استهدافه. يجب أن يتراوح نصف القطر بين 1 و500 ميل أو 800 كيلومتر.
proximityRadiusUnit

enum (ProximityRadiusUnit)

الحقل مطلوب. وحدات مسافة النطاق الجغرافي

ProximityRadiusUnit

تعداد وحدات المسافة الخاص بـ ProximityRadius.

عمليات التعداد
PROXIMITY_RADIUS_UNIT_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد وحدات المسافة في هذا الإصدار. هذا التعداد هو عنصر نائب للقيمة التلقائية ولا يمثّل وحدة مسافة حقيقية.
PROXIMITY_RADIUS_UNIT_MILES وحدة مسافة النطاق الجغرافي بالأميال
PROXIMITY_RADIUS_UNIT_KILOMETERS وحدة مسافة النطاق الجغرافي بالكيلومترات

GenderAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب الجنس المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_GENDER.

تمثيل JSON 
{
  "gender": enum (Gender)
}
الحقول
gender

enum (Gender)

الحقل مطلوب. جنس الجمهور

VideoPlayerSizeAssignedTargetingOptionDetails

تفاصيل خيار استهداف حجم مشغّل الفيديو سيتم ملء هذا الحقل في الحقل videoPlayerSizeDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_VIDEO_PLAYER_SIZE. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق هذا التأثير، عليك إزالة جميع خيارات استهداف حجم مشغّل الفيديو.

تمثيل JSON 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
الحقول
videoPlayerSize

enum (VideoPlayerSize)

الحقل مطلوب. حجم مشغّل الفيديو

UserRewardedContentAssignedTargetingOptionDetails

تفاصيل خيار استهداف المحتوى الذي يقدّم مكافآت للمستخدمين سيتم ملء هذا الحقل في الحقل userRewardedContentDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_USER_REWARDED_CONTENT.

تمثيل JSON 
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
الحقول
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_USER_REWARDED_CONTENT
userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب الحالة الأبوية المحدّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_PARENTAL_STATUS.

تمثيل JSON 
{
  "parentalStatus": enum (ParentalStatus)
}
الحقول
parentalStatus

enum (ParentalStatus)

الحقل مطلوب. الحالة الأبوية للجمهور

ContentInstreamPositionAssignedTargetingOptionDetails

تفاصيل خيار استهداف موضع الإعلان داخل الفيديو للمحتوى المعيّن. سيتم ملء هذا الحقل في الحقل contentInstreamPositionDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

تمثيل JSON 
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
الحقول
contentInstreamPosition

enum (ContentInstreamPosition)

الحقل مطلوب. موضع الإعلان ضمن بث الفيديو أو الصوت
adType

enum (AdType)

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

  • AD_TYPE_VIDEO، سيتم توريث الإعداد إلى عنصر السطر الجديد عندما تكون قيمة lineItemType هي LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO، سيتم توريث الإعداد إلى عنصر السطر الجديد عندما تكون قيمة lineItemType هي LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

تمثّل هذه السمة نوع تصميم الإعلان المرتبط بالإعلانات.

عمليات التعداد
AD_TYPE_UNSPECIFIED لم يتم تحديد نوع الإعلان أو أنّه غير معروف في هذا الإصدار.
AD_TYPE_DISPLAY تصاميم الإعلانات الصورية، مثل الصور وHTML5
AD_TYPE_VIDEO تصاميم إعلانات الفيديو، مثل إعلانات الفيديو التي يتم تشغيلها أثناء بث المحتوى في مشغّلات الفيديو
AD_TYPE_AUDIO تصاميم الإعلانات الصوتية، مثل الإعلانات الصوتية التي يتم تشغيلها أثناء المحتوى الصوتي

ContentOutstreamPositionAssignedTargetingOptionDetails

تفاصيل خيار استهداف موضع الإعلان خارج البث للمحتوى المعيّن. سيتم ملء هذا الحقل في الحقل contentOutstreamPositionDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

تمثيل JSON 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
الحقول
contentOutstreamPosition

enum (ContentOutstreamPosition)

الحقل مطلوب. موضع "الإعلان خارج مشغّل الفيديو" ضمن المحتوى
adType

enum (AdType)

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

  • AD_TYPE_DISPLAY، سيتم توريث الإعداد إلى عنصر السطر الجديد عندما تكون قيمة lineItemType هي LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO، سيتم توريث الإعداد إلى عنصر السطر الجديد عندما تكون قيمة lineItemType هي LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

تفاصيل الاستهداف لنوع الجهاز سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_TYPE.

تمثيل JSON 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
الحقول
deviceType

enum (DeviceType)

الحقل مطلوب. الاسم المعروض لنوع الجهاز.
youtubeAndPartnersBidMultiplier

number

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

على سبيل المثال، إذا كان سعر عرض السعر بدون مضاعِف هو 10.0 دولار أمريكي وكان المضاعِف 1.5 للجهاز اللوحي، سيكون سعر عرض السعر الناتج للجهاز اللوحي هو 15.0 دولار أمريكي.

لا ينطبق هذا الإعداد إلا على البنود الإعلانية في YouTube والمنصات الشريكة.

AudienceGroupAssignedTargetingOptionDetails

تفاصيل خيار استهداف شريحة الجمهور المعيّنة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_AUDIENCE_GROUP. العلاقة بين كل مجموعة هي UNION، باستثناء excludedFirstAndThirdPartyAudienceGroup وexcludedGoogleAudienceGroup، حيث يتم استخدام COMPLEMENT كـ INTERSECTION مع المجموعات الأخرى.

تمثيل JSON 
{
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedFirstPartyAndPartnerAudienceGroups": [
    {
      object (FirstPartyAndPartnerAudienceGroup)
    }
  ],
  "excludedFirstPartyAndPartnerAudienceGroup": {
    object (FirstPartyAndPartnerAudienceGroup)
  }
}
الحقول
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

اختياريّ. أرقام تعريف شرائح جمهور Google لمجموعة جمهور Google المُدرَجة. تحتوي على أرقام تعريف شرائح جمهور Google فقط.
includedCustomListGroup

object (CustomListGroup)

اختياريّ. معرّفات القوائم المخصّصة لمجموعة القوائم المخصّصة المُدرَجة يحتوي على معرّفات القوائم المخصّصة فقط.
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

اختياريّ. معرّفات شرائح الجمهور المُجمَّعة التي تتضمّنها مجموعة شرائح الجمهور المُجمَّعة. يحتوي على أرقام تعريف الجمهور المُجمَّع فقط.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

اختياريّ. معرّفات جمهور Google لمجموعة جمهور Google المستبعَدة. تُستخدَم للاستهداف السلبي. يتم استخدام مكمل اتحاد هذه المجموعة ومجموعات الجمهور المستبعَد الأخرى كتقاطع مع أي استهداف إيجابي للجمهور. تحتوي فقط على شرائح جمهور Google من النوع "الاهتمامات المشتركة" و"في السوق" و"التطبيقات المثبّتة". جميع العناصر هي منطقيًا "أو" لبعضها البعض.
includedFirstPartyAndPartnerAudienceGroups[]

object (FirstPartyAndPartnerAudienceGroup)

اختياريّ. أرقام تعريف شرائح جمهور الطرف الأول والشركاء، وتواريخ آخر ظهور لمجموعات شرائح جمهور الطرف الأول والشركاء المُدرَجة تحتوي كل مجموعة من شرائح جمهور الطرف الأول وشرائح جمهور الشركاء على أرقام تعريف شرائح جمهور الطرف الأول وشرائح جمهور الشركاء فقط. العلاقة بين كل شريحة جمهور تابعة للطرف الأول وشريحة جمهور شريك هي INTERSECTION، ويتم دمج النتيجة مع شرائح الجمهور الأخرى باستخدام UNION. سيتم تجاهل المجموعات المتكرّرة التي تتضمّن الإعدادات نفسها.
excludedFirstPartyAndPartnerAudienceGroup

object (FirstPartyAndPartnerAudienceGroup)

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

GoogleAudienceGroup

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

تمثيل JSON 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
الحقول
settings[]

object (GoogleAudienceTargetingSetting)

الحقل مطلوب. جميع إعدادات استهداف الجمهور من Google في شريحة الجمهور من Google سيتم تجاهل الإعدادات المتكرّرة التي تحمل رقم التعريف نفسه.

GoogleAudienceTargetingSetting

تفاصيل إعداد استهداف الجمهور في Google

تمثيل JSON 
{
  "googleAudienceId": string
}
الحقول
googleAudienceId

string (int64 format)

الحقل مطلوب. رقم تعريف جمهور Google لإعداد استهداف جمهور Google رقم التعريف هذا هو googleAudienceId.

CustomListGroup

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

تمثيل JSON 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
الحقول
settings[]

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

تفاصيل إعداد استهداف القائمة المخصّصة

تمثيل JSON 
{
  "customListId": string
}
الحقول
customListId

string (int64 format)

الحقل مطلوب. المعرّف المخصّص لإعداد استهداف القائمة المخصّصة. رقم التعريف هذا هو customListId.

CombinedAudienceGroup

تفاصيل مجموعة شرائح الجمهور المدمَجة، حيث تكون جميع إعدادات استهداف شرائح الجمهور المدمَجة مرتبطة منطقيًا بـ "أو".

تمثيل JSON 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
الحقول
settings[]

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

تفاصيل إعداد استهداف الجمهور المُجمّع

تمثيل JSON 
{
  "combinedAudienceId": string
}
الحقول
combinedAudienceId

string (int64 format)

الحقل مطلوب. معرّف الجمهور المُجمَّع لإعداد استهداف الجمهور المُجمَّع رقم التعريف هذا هو combinedAudienceId.

FirstPartyAndPartnerAudienceGroup

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

تمثيل JSON 
{
  "settings": [
    {
      object (FirstPartyAndPartnerAudienceTargetingSetting)
    }
  ]
}
الحقول
settings[]

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

FirstPartyAndPartnerAudienceTargetingSetting

تفاصيل إعداد استهداف شرائح جمهور الطرف الأول وشركاء الإعلانات

تمثيل JSON 
{
  "firstPartyAndPartnerAudienceId": string,
  "recency": enum (Recency)
}
الحقول
firstPartyAndPartnerAudienceId

string (int64 format)

الحقل مطلوب. رقم تعريف جمهور الطرف الأول والشركاء في إعداد استهداف جمهور الطرف الأول والشركاء رقم التعريف هذا هو firstPartyAndPartnerAudienceId.
recency

enum (Recency)

الحقل مطلوب. مدى حداثة إعداد استهداف شرائح الجمهور التابعة للطرف الأول والشركاء لا ينطبق هذا الخيار إلا على شرائح جمهور الطرف الأول، وإلا سيتم تجاهله. لمزيد من المعلومات، يُرجى الرجوع إلى https://support.google.com/displayvideo/answer/2949947#recency. وفي حال عدم تحديدها، لن يتم استخدام أي حدّ للأحداث الأخيرة.

مدى الحداثة

جميع قيم مدى الحداثة المتوافقة لشرائح جمهور الطرف الأول وشرائح جمهور الشركاء

عمليات التعداد
RECENCY_NO_LIMIT ما مِن حدّ أقصى لمدّة الحداثة.
RECENCY_1_MINUTE مدى الحداثة هو دقيقة واحدة.
RECENCY_5_MINUTES مدى الحداثة هو 5 دقائق.
RECENCY_10_MINUTES مدى الحداثة هو 10 دقائق.
RECENCY_15_MINUTES مدى الحداثة هو 15 دقيقة.
RECENCY_30_MINUTES مدى الحداثة هو 30 دقيقة.
RECENCY_1_HOUR المدة الزمنية هي ساعة واحدة.
RECENCY_2_HOURS مدى الحداثة هو ساعتان.
RECENCY_3_HOURS مدى الحداثة هو 3 ساعات.
RECENCY_6_HOURS مدى الحداثة هو 6 ساعات.
RECENCY_12_HOURS مدى الحداثة هو 12 ساعة.
RECENCY_1_DAY المدة الزمنية هي يوم واحد.
RECENCY_2_DAYS مدى الحداثة هو يومان.
RECENCY_3_DAYS مدى الحداثة هو 3 أيام.
RECENCY_5_DAYS مدى الحداثة هو 5 أيام.
RECENCY_7_DAYS مدى الحداثة هو 7 أيام.
RECENCY_10_DAYS مدى الحداثة هو 10 أيام.
RECENCY_14_DAYS المدة الأخيرة هي 14 يومًا.
RECENCY_15_DAYS المدة الزمنية هي 15 يومًا.
RECENCY_21_DAYS مدى الحداثة هو 21 يومًا.
RECENCY_28_DAYS تكون مدة الحداثة 28 يومًا.
RECENCY_30_DAYS مدى الحداثة هو 30 يومًا.
RECENCY_40_DAYS مدى الحداثة هو 40 يومًا.
RECENCY_45_DAYS مدى الحداثة هو 45 يومًا.
RECENCY_60_DAYS تكون مدة الحداثة 60 يومًا.
RECENCY_90_DAYS تبلغ مدة الحداثة 90 يومًا.
RECENCY_120_DAYS مدى الحداثة هو 120 يومًا.
RECENCY_180_DAYS مدى الحداثة هو 180 يومًا.
RECENCY_270_DAYS مدى الحداثة هو 270 يومًا.
RECENCY_365_DAYS مدى الحداثة هو 365 يومًا.

BrowserAssignedTargetingOptionDetails

تفاصيل خيار استهداف المتصفّح الذي تمّ تعيينه. سيتمّ ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_BROWSER.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

النتائج فقط. يشير هذا الحقل إلى الاسم المعروض للمتصفّح.
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_BROWSER.
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

تفاصيل خيار استهداف دخل الأسرة المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_HOUSEHOLD_INCOME.

تمثيل JSON 
{
  "householdIncome": enum (HouseholdIncome)
}
الحقول
householdIncome

enum (HouseholdIncome)

الحقل مطلوب. دخل الأسرة لشريحة الجمهور

OnScreenPositionAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب موضع الظهور على الشاشة. سيتم ملء هذا الحقل في الحقل onScreenPositionDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_ON_SCREEN_POSITION.

تمثيل JSON 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
الحقول
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_ON_SCREEN_POSITION
onScreenPosition

enum (OnScreenPosition)

النتائج فقط. تمثّل هذه السمة موضع العنصر على الشاشة.
adType

enum (AdType)

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

  • AD_TYPE_DISPLAY، سيتم توريث الإعداد إلى عنصر السطر الجديد عندما تكون قيمة lineItemType هي LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO، سيتم توريث الإعداد إلى عنصر السطر الجديد عندما تكون قيمة lineItemType هي LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

تفاصيل خيار استهداف مشغّل شبكة الجوّال ومقدّم خدمة الإنترنت المعيّنَين. سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_CARRIER_AND_ISP.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

النتائج فقط: الاسم المعروض لشركة الاتصالات أو مقدّم خدمة الإنترنت
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_CARRIER_AND_ISP.
negative

boolean

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

KeywordAssignedTargetingOptionDetails

تفاصيل خيار استهداف الكلمات الرئيسية الذي تمّ تعيينه سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_KEYWORD.

تمثيل JSON 
{
  "keyword": string,
  "negative": boolean,
  "exemptedPolicyNames": [
    string
  ]
}
الحقول
keyword

string

الحقل مطلوب. الكلمة الرئيسية، مثل car insurance

لا يمكن أن تكون الكلمة الرئيسية الإيجابية كلمة مسيئة، ويجب أن تكون بترميز UTF-8 وبحجم 255 بايت كحد أقصى، وأن يتألف من 80 حرفًا كحد أقصى و10 كلمات كحد أقصى.
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.
exemptedPolicyNames[]

string

اختياريّ. أسماء السياسات التي سيتم استثناء الكلمة الرئيسية منها.

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

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

NegativeKeywordListAssignedTargetingOptionDetails

تفاصيل الاستهداف لقائمة الكلمات الرئيسية السلبية سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

تمثيل JSON 
{
  "negativeKeywordListId": string
}
الحقول
negativeKeywordListId

string (int64 format)

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

OperatingSystemAssignedTargetingOptionDetails

تفاصيل خيار استهداف نظام التشغيل الذي تمّ تعيينه سيتم ملء هذا الحقل في الحقل operatingSystemDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_OPERATING_SYSTEM.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

النتائج فقط: الاسم المعروض لنظام التشغيل.
targetingOptionId

string

الحقل مطلوب. رقم تعريف خيار الاستهداف الذي تم ملؤه في الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_OPERATING_SYSTEM
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

DeviceMakeModelAssignedTargetingOptionDetails

تفاصيل خيار استهداف ماركات وطُرز الأجهزة المعيّنة سيتم ملء هذا الحقل في الحقل deviceMakeModelDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_MAKE_MODEL.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

نتائج فقط. الاسم المعروض للعلامة التجارية للجهاز وطرازه.
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_MAKE_MODEL
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

EnvironmentAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف في البيئة المحدّدة، وسيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_ENVIRONMENT.

تمثيل JSON 
{
  "environment": enum (Environment)
}
الحقول
environment

enum (Environment)

الحقل مطلوب. بيئة العرض

InventorySourceAssignedTargetingOptionDetails

تفاصيل الاستهداف لمصدر المستودع سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_INVENTORY_SOURCE.

تمثيل JSON 
{
  "inventorySourceId": string
}
الحقول
inventorySourceId

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

تفاصيل خيار استهداف الفئة المحدّدة سيتم ملء هذا الحقل في الحقل categoryDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CATEGORY.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

النتائج فقط: الاسم المعروض للفئة.
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CATEGORY
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

ViewabilityAssignedTargetingOptionDetails

تفاصيل خيار استهداف مدى توفّر إمكانية المشاهدة الذي تمّ تعيينه سيتم ملء هذا الحقل في حقل viewabilityDetails الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_VIEWABILITY.

تمثيل JSON 
{
  "viewability": enum (Viewability)
}
الحقول
viewability

enum (Viewability)

الحقل مطلوب. النسبة المئوية المتوقّعة لإمكانية العرض

AuthorizedSellerStatusAssignedTargetingOptionDetails

تمثّل هذه السمة حالة بائع معتمَد تم تعيينها، وسيتم ملؤها في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

إذا لم يكن لأحد المراجع خيار استهداف TARGETING_TYPE_AUTHORIZED_SELLER_STATUS محدّد، يعني ذلك أنّه يستخدم الخيار "المورّدون والمورّدون المعتمدون المباشرون".

تمثيل JSON 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
الحقول
authorizedSellerStatus

enum (AuthorizedSellerStatus)

نتائج فقط: حالة البائع المعتمَد المطلوب استهدافه.
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

تفاصيل خيار استهداف اللغة الذي تمّ تعيينه. سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_LANGUAGE.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
الحقول
displayName

string

للعرض فقط: اسم اللغة (مثلاً، "الفرنسية").
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_LANGUAGE.
negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

تفاصيل خيار استهداف المناطق الجغرافية المحدّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_GEO_REGION.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
الحقول
displayName

string

هذه السمة مخصّصة للناتج فقط، وهي تمثّل الاسم المعروض للمنطقة الجغرافية (مثل "أونتاريو، كندا").
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_GEO_REGION.
geoRegionType

enum (GeoRegionType)

النتائج فقط. نوع استهداف المنطقة الجغرافية.
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

InventorySourceGroupAssignedTargetingOptionDetails

تفاصيل الاستهداف لمجموعة مصدر المستودع سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

تمثيل JSON 
{
  "inventorySourceGroupId": string
}
الحقول
inventorySourceGroupId

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

تفاصيل الاستهداف لتصنيف المحتوى الرقمي سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

تمثيل JSON 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
الحقول
excludedContentRatingTier

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

تفاصيل الاستهداف للفئة الإعلانية الحساسة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

تمثيل JSON 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
الحقول
excludedSensitiveCategory

enum (SensitiveCategory)

الحقل مطلوب. تعداد لفئة المحتوى الحسّاس في "مساحة العرض والفيديو 360" المصنّف على أنّه مستبعَد.

ContentThemeAssignedTargetingOptionDetails

تفاصيل الاستهداف لموضوع المحتوى سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

تمثيل JSON 
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
الحقول
excludedTargetingOptionId

string

الحقل مطلوب. معرّف موضوع المحتوى المطلوب استبعاده
contentTheme

enum (ContentTheme)

النتائج فقط. تعداد لمصنّف مواضيع المحتوى في "مساحة العرض والفيديو 360".
excludedContentTheme

enum (ContentTheme)

الحقل مطلوب. تعداد لموضوع المحتوى المستبعَد في "مساحة العرض والفيديو 360".

ExchangeAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف في Exchange الذي تمّ تعيينه سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_EXCHANGE.

تمثيل JSON 
{
  "exchange": enum (Exchange)
}
الحقول
exchange

enum (Exchange)

الحقل مطلوب. قيمة التعداد المحدّد للبورصة.

SubExchangeAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف في البورصة الفرعية المعيّنة. سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_SUB_EXCHANGE.

تمثيل JSON 
{
  "targetingOptionId": string
}
الحقول
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المخصّص لأداة التحقّق التابعة لجهة خارجية سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_THIRD_PARTY_VERIFIER.

تمثيل JSON 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
الحقول
حقل الربط verifier يمكن استهداف إحدى جهات التحقّق الخارجية لفرض حدود أمان العلامة التجارية على مرّات الظهور. يمكن أن يكون التعليق verifier إحدى القيم التالية فقط:
adloox

object (Adloox)

جهة التحقّق من العلامة التجارية التابعة لجهة خارجية: Scope3 (المعروفة سابقًا باسم Adloox)
doubleVerify

object (DoubleVerify)

أداة التحقّق من العلامة التجارية التابعة لجهة خارجية: DoubleVerify
integralAdScience

object (IntegralAdScience)

أداة التحقّق من العلامة التجارية التابعة لجهة خارجية: Integral Ad Science

Adloox

تفاصيل إعدادات أمان العلامة التجارية في Scope3 (المعروفة سابقًا باسم Adloox)

تمثيل JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
الحقول
excludedAdlooxCategories[]

enum (AdlooxCategory)

فئات Scope3 التي يجب استبعادها.
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

اختياريّ. فئات النشاط غير الصالح الذي يتم قياسه آليًا (IVT) والمصادقة المتعدّدة العوامل (MFA) التي يجب استبعادها في Scope3
adultExplicitSexualContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM التي يجب استبعادها من المحتوى الجنسي الفاضح والمخصّص للبالغين
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر التي يجب استبعادها في GARM للمحتوى الذي يتضمّن جرائم وأفعالاً ضارّة
armsAmmunitionContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر في GARM التي يجب استبعادها في المحتوى المتعلّق بالأسلحة والذخيرة
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM التي يجب استبعادها من المحتوى الذي يتناول قضايا اجتماعية حسّاسة مثيرة للجدل
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM التي يجب استبعادها في ما يتعلّق بالمحتوى الذي يتضمّن أدوية محظورة أو كحول
onlinePiracyContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM لاستبعاد محتوى القرصنة على الإنترنت
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر في GARM التي يجب استبعادها من المحتوى الذي يتضمّن كلامًا يحض على الكراهية وأعمالًا عدوانية
obscenityProfanityContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM التي يجب استبعادها في ما يتعلّق بالمحتوى البذيء واللغة النابية
spamHarmfulContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM التي يجب استبعادها بسبب المحتوى غير المرغوب فيه أو الضارّ
terrorismContent

enum (GarmRiskExclusion)

اختياريّ. نطاقات المخاطر GARM التي يجب استبعادها
misinformationContent

enum (GarmRiskExclusion)

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

enum (DisplayIabViewability)

اختياريّ. حدّ إمكانية العرض الأدنى للإعلانات الصورية وفقًا لمكتب IAB
videoIabViewability

enum (VideoIabViewability)

اختياريّ. الحدّ الأدنى لإمكانية العرض وفقًا لمكتب IAB لإعلانات الفيديو

AdlooxCategory

فئات Scope3 المتاحة (المعروفة سابقًا باسم Adloox)

عمليات التعداد
ADLOOX_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد فئة Scope3 أو تكون غير معروفة في هذا الإصدار.
ADULT_CONTENT_HARD المحتوى المخصّص للبالغين (المحتوى الفاضح)
ADULT_CONTENT_SOFT المحتوى المخصّص للبالغين (غير فاضح)
ILLEGAL_CONTENT محتوى غير قانوني
BORDERLINE_CONTENT المحتوى القريب من مخالفة السياسات
DISCRIMINATORY_CONTENT محتوى تمييزي
VIOLENT_CONTENT_WEAPONS المحتوى العنيف والأسلحة
LOW_VIEWABILITY_DOMAINS النطاقات التي تسجّل معدلات إمكانية عرض منخفضة
FRAUD الاحتيال

FraudIvtMfaCategory

فئات الاحتيال وحركة المرور غير الصالحة (IVT) والمواقع الإلكترونية المتعدّدة العوامل (MFA) المتاحة في Scope3 (المعروفة سابقًا باسم Adloox)

عمليات التعداد
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد فئة Scope3 Fraud أو IVT أو MFA أو تكون غير معروفة في هذا الإصدار.
FRAUD_IVT_MFA الاحتيال، الزيارات غير الصالحة، المصادقة المتعددة العوامل

GarmRiskExclusion

خيارات استبعاد مستوى خطورة GARM المتاحة

عمليات التعداد
GARM_RISK_EXCLUSION_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيار استبعاد للمحتوى المعرّض لخطر عدم ملاءمته لإرشادات GARM.
GARM_RISK_EXCLUSION_FLOOR استبعاد مخاطر الفيضانات
GARM_RISK_EXCLUSION_HIGH استبعاد المخاطر العالية والمخاطر الدنيا
GARM_RISK_EXCLUSION_MEDIUM استبعاد المخاطر المتوسطة والعالية والمنخفضة
GARM_RISK_EXCLUSION_LOW استبعاد جميع مستويات المخاطر (منخفضة ومتوسطة وعالية والحد الأدنى).

DisplayIabViewability

حدود إمكانية العرض في IAB التي توفّرها Scope3 (المعروفة سابقًا باسم Adloox)

عمليات التعداد
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديدها أو تكون غير معروفة في هذا الإصدار
DISPLAY_IAB_VIEWABILITY_10 %10 أو أكثر من مساحة الإعلان مرئية (معيار إمكانية العرض الصوري الصادر عن مكتب IAB).
DISPLAY_IAB_VIEWABILITY_20 أن تكون نسبة الإعلان الظاهر على الشاشة%20 أو أكثر (معيار إمكانية العرض الصوري الصادر عن مكتب IAB).
DISPLAY_IAB_VIEWABILITY_35 ‫35%أو أكثر في طريقة العرض (معيار إمكانية عرض الإعلانات الصورية الصادر عن مكتب IAB).
DISPLAY_IAB_VIEWABILITY_50 أن يكون%50 أو أكثر من الإعلان مرئيًا (معيار إمكانية عرض الإعلانات الصورية الصادر عن مكتب IAB).
DISPLAY_IAB_VIEWABILITY_75 ‫75%أو أكثر من الإعلان مرئي (معيار مكتب الإعلانات التفاعلية لإمكانية العرض على الشبكة الإعلانية).

VideoIabViewability

حدود إمكانية عرض الفيديو وفقًا لمعايير IAB المتوفّرة في Scope3 (المعروفة سابقًا باسم Adloox)

عمليات التعداد
VIDEO_IAB_VIEWABILITY_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديدها أو تكون غير معروفة في هذا الإصدار
VIDEO_IAB_VIEWABILITY_10 %10 أو أكثر في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB)
VIDEO_IAB_VIEWABILITY_20 ‫20%أو أكثر من الفيديو معروض (معيار IAB لإمكانية عرض الفيديو).
VIDEO_IAB_VIEWABILITY_35 ‫35%أو أكثر من الفيديو معروض (معيار إمكانية العرض لمكتب IAB).
VIDEO_IAB_VIEWABILITY_50 %50 أو أكثر من الفيديو معروض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB).
VIDEO_IAB_VIEWABILITY_75 ‫75%أو أكثر من الفيديو معروض (معيار IAB لإمكانية عرض الفيديو).

DoubleVerify

تفاصيل إعدادات DoubleVerify

تمثيل JSON 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
الحقول
brandSafetyCategories

object (BrandSafetyCategories)

عناصر التحكّم في أمان العلامة التجارية في DoubleVerify
avoidedAgeRatings[]

enum (AgeRating)

تجنَّب تقديم عروض أسعار على التطبيقات التي تتضمّن تقييمًا حسب الفئة العمرية.
appStarRating

object (AppStarRating)

تجنَّب تقديم عروض أسعار على التطبيقات التي تتضمّن تقييمات بالنجوم.
displayViewability

object (DisplayViewability)

إعدادات إمكانية العرض للإعلانات الصورية (تنطبق على البنود الإعلانية للإعلانات الصورية فقط)
videoViewability

object (VideoViewability)

إعدادات إمكانية عرض الفيديو (تنطبق على بنود إعلانات الفيديو فقط)
fraudInvalidTraffic

object (FraudInvalidTraffic)

تجنُّب المواقع الإلكترونية والتطبيقات التي سجّلت معدّلات احتيال ونشاط غير صالح مرتفعة في السابق
customSegmentId

string (int64 format)

معرّف شريحة الجمهور المخصّصة المقدَّم من DoubleVerify. يجب أن يبدأ المعرّف بالرقم "51" وأن يتألف من ثمانية أرقام. لا يمكن تحديد معرّف شريحة الجمهور المخصّصة مع أيّ من الحقول التالية:

BrandSafetyCategories

إعدادات عناصر التحكّم في أمان العلامة التجارية

تمثيل JSON 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
الحقول
avoidUnknownBrandSafetyCategory

boolean

غير معروف أو لا يمكن تقييمه
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

فئات تجنُّب المحتوى الشديد الخطورة المرتبط بأمان العلامة التجارية
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

فئات تجنُّب المحتوى ذي الخطورة المتوسطة المتعلّقة بأمان العلامة التجارية

HighSeverityCategory

الخيارات المتاحة لفئات الخطورة العالية

عمليات التعداد
HIGHER_SEVERITY_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي فئات ذات خطورة عالية.
ADULT_CONTENT_PORNOGRAPHY المحتوى المخصّص للبالغين: المواد الإباحية والمواضيع المخصّصة للكبار ومشاهد العُري
COPYRIGHT_INFRINGEMENT انتهاك حقوق الطبع والنشر
SUBSTANCE_ABUSE المخدرات/الكحول/المواد الخاضعة للرقابة: إساءة استخدام المواد
GRAPHIC_VIOLENCE_WEAPONS العنف المفرط/المشاهد القاسية/الأسلحة
HATE_PROFANITY الكراهية/اللغة النابية
CRIMINAL_SKILLS الأنشطة غير القانونية: المهارات الإجرامية
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER محتوى مُحفَّز/برامج ضارّة/محتوى غير مرغوب فيه

MediumSeverityCategory

الخيارات المتاحة لفئات الخطورة المتوسطة

عمليات التعداد
MEDIUM_SEVERITY_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي فئات ذات خطورة متوسطة.
AD_SERVERS خوادم الإعلانات
ADULT_CONTENT_SWIMSUIT محتوى للبالغين: ملابس السباحة
ALTERNATIVE_LIFESTYLES المواضيع المثيرة للجدل: أنماط الحياة البديلة
CELEBRITY_GOSSIP المواضيع المثيرة للجدل: شائعات المشاهير
GAMBLING المواضيع المثيرة للجدل: المقامرة
OCCULT المواضيع المثيرة للجدل: السحر
SEX_EDUCATION المواضيع المثيرة للجدل: التربية الجنسية
DISASTER_AVIATION الكوارث: الطيران
DISASTER_MAN_MADE الكارثة: من صنع الإنسان.
DISASTER_NATURAL الكارثة: طبيعية
DISASTER_TERRORIST_EVENTS الكوارث: الأحداث الإرهابية
DISASTER_VEHICLE كارثة: مركبة.
ALCOHOL المخدرات/الكحول/المواد الخاضعة للرقابة: الكحول
SMOKING المخدّرات/الكحول/المواد الخاضعة للرقابة: التدخين
NEGATIVE_NEWS_FINANCIAL أخبار سلبية: مالية
NON_ENGLISH محتوى غير عادي: بلغة غير الإنجليزية
PARKING_PAGE محتوى غير عادي: صفحة انتظار
UNMODERATED_UGC المحتوى من إنشاء المستخدمين غير الخاضع للإشراف: المنتديات والصور والفيديوهات
INFLAMMATORY_POLITICS_AND_NEWS المواضيع المثيرة للجدل: السياسة والأخبار المحرّضة
NEGATIVE_NEWS_PHARMACEUTICAL أخبار سلبية: مستحضرات صيدلانية

AgeRating

الخيارات المتاحة للتقييمات حسب الفئة العمرية

عمليات التعداد
AGE_RATING_UNSPECIFIED هذه القائمة المُعدّدة هي عنصر نائب فقط ولا تحدّد أي خيارات لتقييم المحتوى حسب الفئة العمرية.
APP_AGE_RATE_UNKNOWN التطبيقات التي لا يتوفّر لها تقييم حسب الفئة العمرية
APP_AGE_RATE_4_PLUS التطبيقات التي تم تقييمها بأنّها مناسبة للجميع (4 أعوام فأكثر)
APP_AGE_RATE_9_PLUS التطبيقات التي تم تقييمها بأنّها مناسبة للجميع (9 أعوام فأكثر)
APP_AGE_RATE_12_PLUS التطبيقات المصنَّفة بأنّها مناسبة للمراهقين (12 عامًا فأكثر)
APP_AGE_RATE_17_PLUS التطبيقات المصنَّفة على أنّها مناسبة للبالغين (17 عامًا فأكثر)
APP_AGE_RATE_18_PLUS التطبيقات المصنّفة "للبالغين فقط" (18 عامًا فأكثر)

AppStarRating

تفاصيل إعدادات التقييم بالنجوم في DoubleVerify

تمثيل JSON 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
الحقول
avoidedStarRating

enum (StarRating)

تجنَّب تقديم عروض أسعار على التطبيقات التي تتضمّن تقييمات بالنجوم.
avoidInsufficientStarRating

boolean

تجنَّب تقديم عروض أسعار على التطبيقات التي تتضمّن تقييمات غير كافية بالنجوم.

StarRating

الخيارات المتاحة للتقييمات بالنجوم

عمليات التعداد
APP_STAR_RATE_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لتقييم التطبيق بالنجوم.
APP_STAR_RATE_1_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 1.5 نجمة
APP_STAR_RATE_2_LESS التطبيقات الرسمية التي يقل تقييمها عن نجمتين
APP_STAR_RATE_2_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 2.5 نجمة
APP_STAR_RATE_3_LESS التطبيقات الرسمية التي يقل تقييمها عن 3 نجوم
APP_STAR_RATE_3_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 3.5 نجمة
APP_STAR_RATE_4_LESS التطبيقات الرسمية التي يقل تقييمها عن 4 نجوم
APP_STAR_RATE_4_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 4.5 نجوم

DisplayViewability

تفاصيل إعدادات إمكانية عرض الإعلانات الصورية في DoubleVerify

تمثيل JSON 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
الحقول
iab

enum (IAB)

استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB).
viewableDuring

enum (ViewableDuring)

استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة مدة الظهور بنسبة% 100 إلى أقصى حد

مكتب الإعلانات التفاعلية (IAB)

الخيارات المتاحة لنسبة إمكانية العرض وفقًا لمكتب IAB

عمليات التعداد
IAB_VIEWED_RATE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لمعدّل المشاهدة وفقًا لمكتب IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لتحقيق الحدّ الأقصى من نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) البالغة% 80 أو أكثر
IAB_VIEWED_RATE_75_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لتحقيق نسبة إمكانية عرض تبلغ% 75 أو أكثر وفقًا لمكتب IAB
IAB_VIEWED_RATE_70_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 70 أو أكثر
IAB_VIEWED_RATE_65_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) إلى% 65 أو أكثر
IAB_VIEWED_RATE_60_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 60 أو أكثر
IAB_VIEWED_RATE_55_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) إلى% 55 أو أكثر
IAB_VIEWED_RATE_50_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) إلى% 50 أو أكثر
IAB_VIEWED_RATE_40_PERCENT_HIGHER استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 40 أو أكثر
IAB_VIEWED_RATE_30_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 30 أو أكثر

ViewableDuring

الخيارات المتاحة للمدة القابلة للعرض

عمليات التعداد
AVERAGE_VIEW_DURATION_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لمتوسّط مدة المشاهدة.
AVERAGE_VIEW_DURATION_5_SEC استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة مدة إمكانية العرض بنسبة% 100 لمدة 5 ثوانٍ أو أكثر
AVERAGE_VIEW_DURATION_10_SEC استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة مدة العرض بنسبة% 100 إلى 10 ثوانٍ أو أكثر
AVERAGE_VIEW_DURATION_15_SEC استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة مدة العرض بنسبة% 100 إلى 15 ثانية أو أكثر

VideoViewability

تفاصيل إعدادات إمكانية عرض الفيديو في DoubleVerify

تمثيل JSON 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
الحقول
videoIab

enum (VideoIAB)

استهداف فهرس روابط الويب لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB
videoViewableRate

enum (VideoViewableRate)

استهداف المساحات الإعلانية على الويب لتحقيق الحدّ الأقصى من نسبة الإعلانات التي يمكن رؤيتها بالكامل
playerImpressionRate

enum (PlayerImpressionRate)

استهداف المستودع الإعلاني لتحقيق الحدّ الأقصى من مرّات الظهور باستخدام مشغّل بحجم 400x300 أو أكبر

VideoIAB

الخيارات المتاحة لنسبة إمكانية العرض وفقًا لمكتب IAB

عمليات التعداد
VIDEO_IAB_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لمعدّل الظهور القابل للعرض وفقًا لمكتب IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لتحقيق الحدّ الأقصى من نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) البالغة% 80 أو أكثر
IAB_VIEWABILITY_75_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لتحقيق نسبة إمكانية عرض تبلغ% 75 أو أكثر وفقًا لمكتب IAB
IAB_VIEWABILITY_70_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 70 أو أكثر
IAB_VIEWABILITY_65_PERCENT_HIHGER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) إلى% 65 أو أكثر
IAB_VIEWABILITY_60_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 60 أو أكثر
IAB_VIEWABILITY_55_PERCENT_HIHGER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) إلى% 55 أو أكثر
IAB_VIEWABILITY_50_PERCENT_HIGHER استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب التفاعلية الإعلانية (IAB) إلى% 50 أو أكثر
IAB_VIEWABILITY_40_PERCENT_HIHGER استهداف مستودع الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 40 أو أكثر
IAB_VIEWABILITY_30_PERCENT_HIHGER استهداف مستودع المواقع الإلكترونية والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 30 أو أكثر

VideoViewableRate

الخيارات الممكنة لمعدّل المشاهدة الكاملة

عمليات التعداد
VIDEO_VIEWABLE_RATE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لمعدّل مشاهدة الفيديو.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER استهداف مستودع الويب الإعلاني لزيادة نسبة الظهور الكامل إلى% 40 أو أكثر
VIEWED_PERFORMANCE_35_PERCENT_HIGHER استهداف مستودع إعلاني على الويب لزيادة نسبة الإعلانات التي يمكن مشاهدتها بالكامل إلى% 35 أو أكثر
VIEWED_PERFORMANCE_30_PERCENT_HIGHER استهداف مستودع الويب لزيادة نسبة الظهور الكامل إلى% 30 أو أكثر
VIEWED_PERFORMANCE_25_PERCENT_HIGHER استهداف فهرس روابط الويب لزيادة نسبة الإعلانات القابلة للمشاهدة بالكامل بنسبة% 25 أو أكثر
VIEWED_PERFORMANCE_20_PERCENT_HIGHER استهداف مستودع الويب لزيادة نسبة الظهور الكامل إلى% 20 أو أكثر
VIEWED_PERFORMANCE_10_PERCENT_HIGHER استهداف فهرس روابط الويب لزيادة نسبة الإعلانات التي يمكن مشاهدتها بالكامل بنسبة% 10 أو أكثر

PlayerImpressionRate

الخيارات الممكنة لمرّات الظهور

عمليات التعداد
PLAYER_SIZE_400X300_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات مرات ظهور.
PLAYER_SIZE_400X300_95 المواقع الإلكترونية التي سجّلت%95 أو أكثر من مرّات الظهور
PLAYER_SIZE_400X300_70 المواقع الإلكترونية التي سجّلت%70 أو أكثر من مرّات الظهور
PLAYER_SIZE_400X300_25 المواقع الإلكترونية التي سجّلت%25 أو أكثر من مرّات الظهور
PLAYER_SIZE_400X300_5 المواقع الإلكترونية التي سجّلت%5 أو أكثر من مرّات الظهور

FraudInvalidTraffic

إعدادات "الزيارات غير الصالحة" و"الاحتيال" في DoubleVerify

تمثيل JSON 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
الحقول
avoidedFraudOption

enum (FraudOption)

تجنُّب المواقع الإلكترونية والتطبيقات التي سبق أن تم رصد عمليات احتيال أو زيارات غير صالحة فيها
avoidInsufficientOption

boolean

إحصاءات غير كافية حول الاحتيال والزيارات غير الصالحة السابقة

FraudOption

الخيارات المحتملة لمعدّل الاحتيال وحركة المرور غير الصالحة السابقة

عمليات التعداد
FRAUD_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للزيارات غير الصالحة والاحتيال.
AD_IMPRESSION_FRAUD_100 ‫100% زيارات غير صالحة واحتيالية
AD_IMPRESSION_FRAUD_50 ‫50% أو أكثر من الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_25 %25 أو أكثر من الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_10 نسبة الاحتيال والزيارات غير الصالحة تبلغ% 10 أو أكثر
AD_IMPRESSION_FRAUD_8 ‫8% أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_6 معدّل الاحتيال والزيارات غير الصالحة يبلغ% 6 أو أكثر
AD_IMPRESSION_FRAUD_4 نسبة الاحتيال والزيارات غير الصالحة تبلغ% 4 أو أكثر
AD_IMPRESSION_FRAUD_2 نسبة الاحتيال والزيارات غير الصالحة تبلغ% 2 أو أكثر

IntegralAdScience

تفاصيل إعدادات Integral Ad Science

تمثيل JSON 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
الحقول
traqScoreOption

enum (TRAQScore)

جودة الإعلان الصحيح (ينطبق ذلك على عناصر العرض فقط)
excludeUnrateable

boolean

أمان العلامة التجارية - غير مصنّف
excludedAdultRisk

enum (Adult)

أمان العلامة التجارية - المحتوى المخصّص للبالغين
excludedAlcoholRisk

enum (Alcohol)

أمان العلامة التجارية - الكحول
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

أمان العلامة التجارية - عمليات التنزيل غير القانونية
excludedDrugsRisk

enum (Drugs)

أمان العلامة التجارية - المخدرات
excludedHateSpeechRisk

enum (HateSpeech)

أمان العلامة التجارية - الكلام الذي يحض على الكراهية
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

أمان العلامة التجارية - اللغة المسيئة
excludedViolenceRisk

enum (Violence)

أمان العلامة التجارية - العنف
excludedGamblingRisk

enum (Gambling)

أمان العلامة التجارية - المقامرة
excludedAdFraudRisk

enum (AdFraudPrevention)

إعدادات الإعلانات الاحتيالية
displayViewability

enum (DisplayViewability)

قسم "إمكانية العرض" للإعلانات الصورية (ينطبق على البنود الإعلانية للإعلانات الصورية فقط)
videoViewability

enum (VideoViewability)

قسم "إمكانية عرض الفيديو" (ينطبق على بنود إعلانات الفيديو فقط)
customSegmentId[]

string (int64 format)

رقم تعريف شريحة الجمهور المخصّصة الذي تقدّمه شركة Integral Ad Science. يجب أن يتراوح رقم التعريف بين 1000001 و1999999 أو بين 3000001 و3999999، بما في ذلك الرقمان.
qualitySyncCustomSegmentId[]

string (int64 format)

اختياريّ. معرّف شريحة الجمهور المخصّصة لمزامنة الجودة الذي توفّره Integral Ad Science. يجب أن يتراوح رقم التعريف بين 3000000 و4999999، بما في ذلك الرقمان.

TRAQScore

نطاقات نتائج TRAQ (جودة الإعلان الصحيح) المحتملة في Integral Ad Science

عمليات التعداد
TRAQ_UNSPECIFIED هذه القائمة هي عنصر نائب فقط ولا تحدّد أي نقاط جودة إعلانية حقيقية.
TRAQ_250 نتيجة TRAQ تتراوح بين 250 و1,000.
TRAQ_500 نتيجة TRAQ تتراوح بين 500 و1000.
TRAQ_600 نتيجة TRAQ تتراوح بين 600 و1000
TRAQ_700 نتيجة TRAQ تتراوح بين 700 و1000.
TRAQ_750 نتيجة TRAQ تتراوح بين 750 و1000
TRAQ_875 نتيجة TRAQ من 875 إلى 1000
TRAQ_1000 نتيجة TRAQ‏ 1000

للبالغين

خيارات المحتوى للبالغين المحتملة في Integral Ad Science

عمليات التعداد
ADULT_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للبالغين.
ADULT_HR محتوى للبالغين - استبعاد المحتوى العالي الخطورة
ADULT_HMR محتوى للبالغين - استبعاد المحتوى العالي والمتوسط الخطورة

الكحول

خيارات Integral Ad Science المتاحة للمشروبات الكحولية

عمليات التعداد
ALCOHOL_UNSPECIFIED هذه القائمة تعدادية هي عنصر نائب فقط ولا تحدّد أي خيارات للكحول.
ALCOHOL_HR الكحول - استبعاد المخاطر العالية
ALCOHOL_HMR الكحول: استبعاد المحتوى العالي والمتوسط الخطورة

IllegalDownloads

خيارات التنزيلات غير القانونية المحتملة في Integral Ad Science

عمليات التعداد
ILLEGAL_DOWNLOADS_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للتنزيلات غير القانونية.
ILLEGAL_DOWNLOADS_HR عمليات التنزيل غير القانونية - استبعاد المخاطر العالية
ILLEGAL_DOWNLOADS_HMR عمليات التنزيل غير القانونية - استبعاد المخاطر العالية والمتوسطة

مخدّرات

خيارات "المخدرات" المحتملة في Integral Ad Science

عمليات التعداد
DRUGS_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للأدوية.
DRUGS_HR المخدرات - استبعاد المخاطر العالية
DRUGS_HMR الأدوية - استبعاد الأدوية العالية والمتوسطة الخطورة

HateSpeech

خيارات محتملة للكلام الذي يحض على الكراهية في Integral Ad Science

عمليات التعداد
HATE_SPEECH_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات متعلقة بكلام يحض على الكراهية.
HATE_SPEECH_HR كلام يحضّ على الكراهية - استبعاد المحتوى العالي الخطورة
HATE_SPEECH_HMR الكلام الذي يحض على الكراهية - استبعاد المحتوى العالي والمتوسط الخطورة

OffensiveLanguage

خيارات اللغة المسيئة المحتملة في Integral Ad Science

عمليات التعداد
OFFENSIVE_LANGUAGE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لغة.
OFFENSIVE_LANGUAGE_HR لغة مسيئة - استبعاد المحتوى العالي الخطورة
OFFENSIVE_LANGUAGE_HMR اللغة المسيئة - استبعاد المحتوى العالي والمتوسط الخطورة

عنف

خيارات العنف المحتملة في Integral Ad Science

عمليات التعداد
VIOLENCE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات عنف.
VIOLENCE_HR العنف - استبعاد المحتوى العالي الخطورة
VIOLENCE_HMR العنف - استبعاد المحتوى العالي والمتوسط الخطورة

المقامرة

خيارات المقامرة المحتملة في Integral Ad Science

عمليات التعداد
GAMBLING_UNSPECIFIED هذا النوع من التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للمقامرة.
GAMBLING_HR المقامرة - استبعاد المخاطر العالية
GAMBLING_HMR المقامرة: استبعاد المخاطر العالية والمتوسطة

AdFraudPrevention

خيارات محتملة لمنع الاحتيال الإعلاني في Integral Ad Science

عمليات التعداد
SUSPICIOUS_ACTIVITY_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لمنع الاحتيال الإعلاني.
SUSPICIOUS_ACTIVITY_HR الاحتيال الإعلاني - استبعاد المخاطر العالية
SUSPICIOUS_ACTIVITY_HMR الاحتيال الإعلاني - استبعاد المخاطر العالية والمتوسطة
SUSPICIOUS_ACTIVITY_FD الاحتيال الإعلاني - استبعاد الأجهزة الاحتيالية

DisplayViewability

خيارات إمكانية عرض الإعلانات الصورية من Integral Ad Science

عمليات التعداد
PERFORMANCE_VIEWABILITY_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لإمكانية عرض الإعلان على الشاشة.
PERFORMANCE_VIEWABILITY_40 استهدِف إمكانية عرض بنسبة% 40 أو أعلى.
PERFORMANCE_VIEWABILITY_50 استهدِف نسبة إمكانية عرض تبلغ% 50 أو أكثر.
PERFORMANCE_VIEWABILITY_60 استهدِف إمكانية عرض بنسبة% 60 أو أعلى.
PERFORMANCE_VIEWABILITY_70 استهدِف نسبة إمكانية عرض تبلغ% 70 أو أكثر.

VideoViewability

خيارات إمكانية عرض الفيديو من Integral Ad Science

عمليات التعداد
VIDEO_VIEWABILITY_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لإمكانية عرض الفيديو.
VIDEO_VIEWABILITY_40 ‫40%أو أكثر من الإعلان معروض (معيار IAB لإمكانية عرض الفيديو).
VIDEO_VIEWABILITY_50 %50 أو أكثر من الفيديو معروض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB).
VIDEO_VIEWABILITY_60 أن يكون%60 أو أكثر من الفيديو معروضًا (معيار IAB لإمكانية عرض الفيديو)
VIDEO_VIEWABILITY_70 ‫70%أو أكثر في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB)

PoiAssignedTargetingOptionDetails

تفاصيل خيار استهداف نقاط الاهتمام المعيّنة. سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_POI.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
الحقول
displayName

string

هذا الحقل مخصّص للناتج فقط. وهو يعرض الاسم الظاهر لنقطة الاهتمام، مثل "تايمز سكوير" أو "سبيس نيدل"، متبوعًا بالعنوان الكامل إذا كان متاحًا.
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_POI.

يمكن استرداد أرقام تعريف خيار استهداف نقاط الاهتمام المقبولة باستخدام targetingTypes.targetingOptions.search.

إذا كنت تستهدف إحداثيات خطوط الطول والعرض معيّنة تمت إزالتها من عنوان أو اسم نقطة اهتمام، يمكنك إنشاء معرّف خيار الاستهداف اللازم عن طريق تقريب قيم الإحداثيات المطلوبة إلى 6 منازل عشرية، وإزالة المنازل العشرية، وربط قيم السلسلة مفصولة بفواصل منقوطة. على سبيل المثال، يمكنك استهداف زوج خطوط الطول والعرض 40.7414691 و74.003387- باستخدام معرّف خيار الاستهداف "40741469;-74003387". عند الإنشاء، سيتم تعديل قيمة هذا الحقل لإضافة فاصلة منقوطة وقيمة تجزئة أبجدية رقمية إذا تم تقديم إحداثيات خطوط الطول والعرض فقط.
latitude

number

نتائج فقط. تمثّل هذه السمة خط العرض لنقطة الاهتمام، ويتم تقريبه إلى 6 منازل عشرية.
longitude

number

النتائج فقط: خط طول نقطة الاهتمام مقربًا إلى 6 منازل عشرية
proximityRadiusAmount

number

الحقل مطلوب. نصف قطر المنطقة المحيطة بنقطة الاهتمام التي سيتم استهدافها يتم تحديد وحدات نصف القطر من خلال proximityRadiusUnit. يجب أن تتراوح القيمة بين 1 و800 إذا كانت الوحدة DISTANCE_UNIT_KILOMETERS وبين 1 و500 إذا كانت الوحدة DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

الحقل مطلوب. وحدة قياس المسافة التي يتم بها قياس نطاق الاستهداف.

DistanceUnit

خيارات وحدات المسافة المحتملة.

عمليات التعداد
DISTANCE_UNIT_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنّها غير معروفة في هذا الإصدار.
DISTANCE_UNIT_MILES أميال
DISTANCE_UNIT_KILOMETERS كيلومترات.

BusinessChainAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لسلسلة الأنشطة التجارية سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_BUSINESS_CHAIN.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
الحقول
displayName

string

هذه السمة مخصّصة للإخراج فقط، وهي تمثّل الاسم المعروض لسلسلة تجارية، مثل "KFC" أو "Chase Bank".
targetingOptionId

string

الحقل مطلوب. تمثّل هذه السمة targetingOptionId TargetingOption من النوع TARGETING_TYPE_BUSINESS_CHAIN.

يمكن استرداد معرّفات خيار استهداف السلاسل التجارية المقبولة باستخدام SearchTargetingOptions.
proximityRadiusAmount

number

الحقل مطلوب. تمثّل هذه السمة نصف قطر المنطقة المحيطة بسلسلة المتاجر التي سيتم استهدافها. يتم تحديد وحدات نصف القطر من خلال proximityRadiusUnit. يجب أن تتراوح القيمة بين 1 و800 إذا كانت الوحدة DISTANCE_UNIT_KILOMETERS وبين 1 و500 إذا كانت الوحدة DISTANCE_UNIT_MILES. الحد الأدنى للزيادة في كلتا الحالتين هو 0.1. سيتم تقريب المدخلات إلى أقرب قيمة مقبولة إذا كانت دقيقة جدًا، مثلاً سيتم تحويل 15.57 إلى 15.6.
proximityRadiusUnit

enum (DistanceUnit)

الحقل مطلوب. وحدة قياس المسافة التي يتم بها قياس نطاق الاستهداف.

ContentDurationAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب مدة المحتوى سيتم ملء هذا الحقل في الحقل contentDurationDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_DURATION. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق ذلك، عليك إزالة جميع خيارات استهداف مدة المحتوى.

تمثيل JSON 
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
الحقول
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_DURATION
contentDuration

enum (ContentDuration)

النتائج فقط: مدة المحتوى

ContentStreamTypeAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
الحقول
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_STREAM_TYPE
contentStreamType

enum (ContentStreamType)

النتائج فقط. تمثّل هذه السمة نوع مجموعة بث المحتوى.

NativeContentPositionAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب موضع المحتوى الأصلي الذي تمّ تحديده. سيتمّ ملء هذا الحقل في الحقل nativeContentPositionDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_NATIVE_CONTENT_POSITION. لا تتوفّر إمكانية استهداف جميع الخيارات بشكلٍ صريح. أزِل جميع خيارات الاستهداف حسب موضع المحتوى الأصلي لتحقيق هذا التأثير.

تمثيل JSON 
{
  "contentPosition": enum (NativeContentPosition)
}
الحقول
contentPosition

enum (NativeContentPosition)

الحقل مطلوب. موضع المحتوى

OmidAssignedTargetingOptionDetails

تمثّل هذه السمة نوع مستودع إعلاني يمكن استهدافه ومفعّل فيه ميزة Open Measurement. سيتم ملء هذه السمة في حقل "التفاصيل" الخاص بـ AssignedTargetingOption عندما تكون قيمة targetingType هي TARGETING_TYPE_OMID.

تمثيل JSON 
{
  "omid": enum (Omid)
}
الحقول
omid

enum (Omid)

الحقل مطلوب. نوع المساحة الإعلانية التي تم تفعيل ميزة "القياس المفتوح" فيها

AudioContentTypeAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "audioContentType": enum (AudioContentType)
}
الحقول
audioContentType

enum (AudioContentType)

الحقل مطلوب. نوع المحتوى الصوتي

ContentGenreAssignedTargetingOptionDetails

تفاصيل عن خيار الاستهداف حسب نوع المحتوى سيتم ملء هذا الحقل في الحقل contentGenreDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_GENRE. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق ذلك، عليك إزالة جميع خيارات استهداف أنواع المحتوى.

تمثيل JSON 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
الحقول
targetingOptionId

string

الحقل مطلوب. الحقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_GENRE
displayName

string

للقراءة فقط. الاسم المعروض لنوع المحتوى.
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

YoutubeVideoAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لفيديو على YouTube سيتم ملء هذا الحقل في الحقل youtubeVideoDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_VIDEO.

تمثيل JSON 
{
  "videoId": string,
  "negative": boolean
}
الحقول
videoId

string

هذه السمة هي معرّف فيديو على YouTube كما يظهر على صفحة المشاهدة في YouTube.
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

YoutubeChannelAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لقناة على YouTube سيتم ملء هذا الحقل في الحقل youtubeChannelDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL.

تمثيل JSON 
{
  "channelId": string,
  "negative": boolean
}
الحقول
channelId

string

معرّف قناة القائم بالتحميل على YouTube أو رمز قناة على YouTube
negative

boolean

تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

SessionPositionAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب موضع الجلسة. سيتم ملء هذا الحقل في الحقل sessionPositionDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_SESSION_POSITION.

تمثيل JSON 
{
  "sessionPosition": enum (SessionPosition)
}
الحقول
sessionPosition

enum (SessionPosition)

موضع ظهور الإعلان في إحدى الجلسات.

SessionPosition

المواضع المحتملة في الجلسة

عمليات التعداد
SESSION_POSITION_UNSPECIFIED هذا عنصر نائب، ولا يشير إلى أي مواضع.
SESSION_POSITION_FIRST_IMPRESSION الانطباع الأول عن الجلسة.

YoutubeChannelPackAssignedTargetingOptionDetails

تفاصيل عن خيار الاستهداف المحدّد لحزمة قنوات على YouTube سيتم ملء هذا الحقل في الحقل youtubeChannelPackDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

تمثيل JSON 
{
  "channelPackId": string,
  "negative": boolean
}
الحقول
channelPackId

string (int64 format)

الحقل مطلوب. معرّف مجموعة قنوات YouTube
negative

boolean

اختياريّ. تشير إلى ما إذا كان يتم استهداف هذا الخيار بشكل سلبي.

الطُرق

create

 تُستخدَم لتعيين خيار استهداف لمجموعة إعلانية.

delete

 تحذف هذه الطريقة خيار استهداف تمّ تعيينه من مجموعة إعلانية.

get

 تعرض هذه السمة خيار استهداف واحدًا تمّ تعيينه لمجموعة إعلانية.

list

 تعرض هذه السمة خيارات الاستهداف التي تمّ تعيينها لمجموعة إعلانية.