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)
  }
  // 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.

الاكتساب

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

عمليات التعداد
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 لجهاز Tablet، سيكون سعر عرض السعر الناتج لجهاز Tablet هو 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، ويتم دمج النتيجة مع شرائح الجمهور الأخرى. سيتم تجاهل المجموعات المتكرّرة التي تتضمّن الإعدادات نفسها.
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 هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيار لاستبعاد المخاطر المتعلّقة بالسلامة والملاءمة للعلامة التجارية على مستوى العالم (GARMs).
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%أو أكثر من الإعلان معروض (معيار إمكانية العرض الذي وضعه مكتب IAB).

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 استهداف المستودع الإعلاني على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 75 أو أكثر
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 استهداف المستودع الإعلاني على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمكتب IAB إلى% 75 أو أكثر
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 Fraud & Invalid Traffic

تمثيل 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".
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)

الحقل مطلوب. نوع المساحة المتوفّرة للإعلانات التي تم تفعيل Open Measurement فيها

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 أول مرة ظهور للجلسة.

الطُرق

create

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

delete

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

get

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

list

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