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.

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)

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

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 
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
الحقول
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

تفاصيل إعداد استهداف الجمهور التابع للطرف الأوّل والتابع لجهات خارجية

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

string (int64 format)

مطلوب. معرّف الجمهور التابع للطرف الأول والتابع لجهة خارجية لإعداد استهداف الجمهور التابع للطرف الأول والتابع لجهة خارجية رقم التعريف هذا هو firstAndThirdPartyAudienceId.
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 يومًا.

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.

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
}
الحقول
keyword

string

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

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

boolean

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

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 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 استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎80% أو أكثر وفقًا لمكتب IAB
IAB_VIEWED_RATE_75_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة نسبة الظهور التي حدّدها مكتب IAB إلى% 75 أو أكثر
IAB_VIEWED_RATE_70_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎70% أو أكثر وفقًا لمكتب IAB
IAB_VIEWED_RATE_65_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎65% أو أكثر وفقًا لمكتب IAB
IAB_VIEWED_RATE_60_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎60% أو أكثر وفقًا لمكتب IAB
IAB_VIEWED_RATE_55_PERCENT_HIGHER استهداف مستودع الويب والتطبيقات لزيادة معدّل الظهور بنسبة ‎55% أو أكثر وفقًا لمكتب التفاعلية الإعلانية (IAB)
IAB_VIEWED_RATE_50_PERCENT_HIGHER استهدِف مستودع الإعلانات على الويب وفي التطبيقات لزيادة معدّل الظهور المرئي وفقًا لمكتب التفاعلية الإعلانية (IAB) بنسبة% 50 أو أكثر.
IAB_VIEWED_RATE_40_PERCENT_HIGHER استهداف مستودع الويب والتطبيقات لزيادة معدّل الظهور بنسبة ‏40% أو أكثر وفقًا لمكتب التفاعلية الإعلانية (IAB)
IAB_VIEWED_RATE_30_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة% 30 أو أكثر وفقًا لمعيار IAB

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 استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎80% أو أكثر وفقًا لمكتب IAB
IAB_VIEWABILITY_75_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة نسبة الظهور التي حدّدها مكتب IAB إلى% 75 أو أكثر
IAB_VIEWABILITY_70_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎70% أو أكثر وفقًا لمكتب IAB
IAB_VIEWABILITY_65_PERCENT_HIHGER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎65% أو أكثر وفقًا لمكتب IAB
IAB_VIEWABILITY_60_PERCENT_HIGHER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة ‎60% أو أكثر وفقًا لمكتب IAB
IAB_VIEWABILITY_55_PERCENT_HIHGER استهداف مستودع الويب والتطبيقات لزيادة معدّل الظهور بنسبة ‎55% أو أكثر وفقًا لمكتب التفاعلية الإعلانية (IAB)
IAB_VIEWABILITY_50_PERCENT_HIGHER استهدِف مستودع الإعلانات على الويب وفي التطبيقات لزيادة معدّل الظهور المرئي وفقًا لمكتب التفاعلية الإعلانية (IAB) بنسبة% 50 أو أكثر.
IAB_VIEWABILITY_40_PERCENT_HIHGER استهداف مستودع الويب والتطبيقات لزيادة معدّل الظهور بنسبة ‏40% أو أكثر وفقًا لمكتب التفاعلية الإعلانية (IAB)
IAB_VIEWABILITY_30_PERCENT_HIHGER استهداف مستودع المواقع الإلكترونية والتطبيقات لزيادة معدّل الظهور بنسبة% 30 أو أكثر وفقًا لمعيار IAB

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 الاحتيال الإعلاني - استبعاد المخاطر العالية والمتوسطة

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

الطُرق

get

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

list

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