REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

المرجع: AssignedTargetingOption

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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 mutually exclusive fields.
}
الحقول
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)

النتائج فقط. حالة التوريث لخيار الاستهداف الذي تمّ تعيينه.
معلومات تفصيلية عن خيار الاستهداف الذي يتمّ تعيينه يمكن ملء حقل واحد فقط في التفاصيل، ويجب أن يتطابق مع targeting_type. في ما يلي قائمة بالحقول غير المتداخلة. سيتم ضبط حقل واحد على الأكثر في الرد:
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.
نهاية الحقول التي يستبعد كلّ منها الآخر

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 في App Store سلسلة من 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، ويتم دمج النتيجة مع شرائح الجمهور الأخرى. سيتم تجاهل المجموعات المتكرّرة التي تتضمّن الإعدادات نفسها.
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)

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

يقبل هذا الحقل القيمة CONTENT_RATING_TIER_UNRATED فقط.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

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

يقبل هذا الحقل القيم التالية فقط:

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of mutually exclusive fields.
}
الحقول
يمكن استهداف إحدى جهات التحقّق الخارجية لفرض حدود أمان العلامة التجارية على مرّات الظهور. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

اختيارية: فئات الزيارات غير الصالحة التي يتم إنشاؤها آليًا والتي يجب استبعادها من 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

فئات الاحتيال والزيارات غير الصالحة والمواقع الإلكترونية التي تستخدم محتوى من إنشاء الذكاء الاصطناعي (MFA) المتوفّرة في Scope3 (المعروفة سابقًا باسم Adloox)

عمليات التعداد
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد فئة Scope3 Fraud أو IVT أو MFA أو تكون غير معروفة في هذا الإصدار.
FRAUD_IVT_MFA الاحتيال والزيارات غير الصالحة و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%أو أكثر من الإعلان معروض (معيار إمكانية العرض على الشبكة الإعلانية الصادر عن مكتب 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 Non-Std Content: Non-English.
PARKING_PAGE Non-Std Content: 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 استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لتحقيق نسبة إمكانية عرض تبلغ% 55 أو أكثر وفقًا لمكتب التفاعلية الإعلانية (IAB)
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 استهداف المساحات الإعلانية على الويب والمساحات الإعلانية المتاحة على التطبيقات لتحقيق نسبة إمكانية عرض تبلغ% 55 أو أكثر وفقًا لمكتب التفاعلية الإعلانية (IAB)
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 و1000
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

النتائج فقط. تمثّل هذه السمة الاسم المعروض لسلسلة تجارية، مثل "كنتاكي" أو "بنك تشيس".
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

تمثّل هذه السمة نوع مساحة إعلانية يمكن استهدافه ومفعَّل فيه القياس المفتوح. سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ 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

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

الاكتساب

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

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

الطُرق

create

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

delete

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

get

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

list

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