REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

المورد: AssignTargetOption

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

تمثيل JSON 
{
  "name": string,
  "assignedTargetingOptionId": 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)
  },
  "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)
  }
  // End of list of possible types for union field details.
}
الحقول
name

string

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

string

النتائج فقط. المعرّف الفريد لخيار الاستهداف المعيّن. رقم التعريف فريد فقط ضمن نوع معيّن من الموارد ونوع الاستهداف. وقد يُعاد استخدامه في سياقات أخرى.
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.

يمكن تحديد 5,000 كلمة رئيسية سلبية مباشرة كحدّ أقصى للمورد. لا يوجد حدّ لعدد الكلمات الرئيسية الإيجابية التي يمكن تحديدها.
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.

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

إذا لم يتضمن أحد الموارد خيار حالة البائع المعتمد، سيتم تلقائيًا استهداف جميع البائعين المعتمَدين الذين تمت الإشارة إليهم باعتبارهم "مباشر" أو "بائع" في ملف 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.

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

object (ExchangeAssignedTargetingOptionDetails)

تفاصيل Exchange ستتم تعبئة هذا الحقل عندما تكون قيمة 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)

تفاصيل مدة المحتوى ستتم تعبئة هذا الحقل عندما يكون TargetType (نوع الاستهداف) هو TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

افتح تفاصيل المستودع المفعَّلة للقياس. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

object (ContentGenreAssignedTargetingOptionDetails)

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

الاكتساب

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

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

ChannelAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

AppCategoryAssignedTargetingOptionDetails

تفاصيل الخيار المخصّص لاستهداف فئة التطبيق ستتم تعبئة هذا الحقل في الحقل "appCategoryDetails" في الخيار AssignTargetingOption عندما تكون قيمة "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

تفاصيل الخيار المخصّص لاستهداف التطبيقات ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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 منصة التطبيق هي نظام أساسي للتلفزيون المتّصل (CTV) غير مدرَج بشكل صريح في مكان آخر.

UrlAssignedTargetingOptionDetails

تفاصيل خيار استهداف عناوين URL التي تم تعيينها. ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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

تمثل فئة عمرية قابلة للاستهداف. ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة targetingType TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

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

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
الحقول
proximityLocationListId

string (int64 format)

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

enum (ProximityRadiusRange)

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

يجب أن يكون للاستهداف حسب الموقع الجغرافي القريب All ضمن مورد واحد قيمة نطاق النطاق الجغرافي نفسها. اضبط هذه القيمة لمطابقة أي استهداف حالي. في حال تعديل هذا الحقل، سيؤدي إلى تغيير نطاق النطاق الجغرافي لكل الاستهداف القريب ضمن المورد.

ProximityRadiusRange

نوع نطاق جغرافي محدد للخيارات المحددة حسب الموقع الجغرافي يرتبط نطاق النطاق الجغرافي بالكثافة السكانية. على سبيل المثال، سيختلف PROXIMITY_RADIUS_RANGE_SMALL في منطقة ريفية عن PROXIMITY_RADIUS_RANGE_SMALL في مدينة مكتظة بالسكان.

عمليات التعداد
PROXIMITY_RADIUS_RANGE_UNSPECIFIED نطاق النطاق الجغرافي المستهدف غير محدد أو غير معروف. القيمة التلقائية عند عدم تحديد نطاق النطاق الجغرافي في هذا الإصدار. هذا التعداد هو عنصر نائب للقيمة التلقائية ولا يمثّل خيارًا حقيقيًا لنطاق النطاق الجغرافي.
PROXIMITY_RADIUS_RANGE_SMALL نطاق النطاق الجغرافي المستهدف صغير.
PROXIMITY_RADIUS_RANGE_MEDIUM نطاق النطاق الجغرافي المستهدَف متوسط.
PROXIMITY_RADIUS_RANGE_LARGE نطاق النطاق الجغرافي المستهدَف كبير.

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

جنس الجمهور.

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

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

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

string

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

enum (VideoPlayerSize)

حجم مشغّل الفيديو

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2

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

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

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

enum (ParentalStatus)

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

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

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

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

string

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

enum (ContentInstreamPosition)

موضع الإعلانات أثناء عرض المحتوى لإعلانات الفيديو أو الإعلانات الصوتية

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
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 
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
الحقول
targetingOptionId

string

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

enum (ContentOutstreamPosition)

موضع المحتوى خارج البث

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
adType

enum (AdType)

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

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

DeviceTypeAssignedTargetingOptionDetails

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

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

string

مطلوب. رقم تعريف نوع الجهاز.
deviceType

enum (DeviceType)

الاسم المعروض لنوع الجهاز.

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2

AudienceGroupAssignedTargetingOptionDetails

تفاصيل خيارات استهداف مجموعة المستخدمين المخصّصة ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة targetingType TARGETING_TYPE_AUDIENCE_GROUP. إنّ العلاقة بين كل مجموعة هي UNION، باستثناء ما يتم استبعاده من المجموعة بطريقة استبدادية واستبعاد GoogleGoogleالجمهور، والتي يتم استخدام الجزء COMPLEMENT منها كعنصر أساسي مع المجموعات الأخرى.

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

أرقام تعريف القوائم المخصّصة لمجموعة القوائم المخصّصة المضمّنة يحتوي على أرقام تعريف قوائم مخصصة فقط.
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

أرقام تعريف جمهور الطرف الأول والطرف الثالث وأوقات استقباله لمجموعة جمهور الطرف الأول والطرف الثالث المستبعدة. تُستخدَم في الاستهداف السلبي. يتم استخدام تكملة UNION لهذه المجموعة ومجموعات الجمهور المستبعدة الأخرى كنقطة بداية لأي استهداف إيجابي للجمهور. جميع العناصر تعتبر "أو" لبعضها البعض منطقيًا.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

أرقام تعريف جمهور Google لمجموعة جمهور Google المستبعدة. تُستخدَم في الاستهداف السلبي. يتم استخدام تكملة UNION لهذه المجموعة ومجموعات الجمهور المستبعدة الأخرى كنقطة بداية لأي استهداف إيجابي للجمهور. لا يحتوي إلا على شرائح جمهور 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

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

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

string

النتائج فقط. الاسم المعروض للمتصفّح.
targetingOptionId

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

دخل الأسرة للجمهور.

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

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

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

تفاصيل خيار الاستهداف المعين لشركة الجوّال ومزوّد خدمة الإنترنت. ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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

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

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

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

تفاصيل الاستهداف لقائمة الكلمات الرئيسية السلبية ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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

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

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

enum (Environment)

بيئة الخدمة

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

مطلوب. targetingOptionId من TargetingOption من النوع TARGETING_TYPE_ENVIRONMENT (مثل، "508010" لاستهداف الخيار ENVIRONMENT_WEB_OPTIMIZED).

InventorySourceAssignedTargetingOptionDetails

تفاصيل الاستهداف لمصدر المستودع الإعلاني ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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" في الخيار AssignTargetingOption عندما تكون قيمة "targetingType" TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

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

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

مطلوب. targetingOptionId من TargetingOption من النوع TARGETING_TYPE_VIEWABILITY (مثل، "509010" لاستهداف الخيار VIEWABILITY_10_PERCENT_OR_MORE).

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

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

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

string

النتائج فقط. الاسم المعروض للغة (مثل، "الفرنسية").
targetingOptionId

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

تفاصيل خيار استهداف المنطقة الجغرافية المعيّن ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

string

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

string

مطلوب. رقم تعريف الفئة الحساسة المراد استبعادها.
sensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

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

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

string

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

SubExchangeAssignedTargetingOptionDetails

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

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

تفاصيل خيارات الاستهداف المخصّصة لأداة التحقّق التابعة لجهة خارجية ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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)

أداة التحقق من العلامة التجارية من جهة خارجية -- Adloox
doubleVerify

object (DoubleVerify)

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

object (IntegralAdScience)

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

Adloox

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

تمثيل JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
الحقول
excludedAdlooxCategories[]

enum (AdlooxCategory)

إعدادات أمان العلامة التجارية في Adloox

AdlooxCategory

خيارات Adloox المحتملة

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

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)

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

enum (AgeRating)

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

object (AppStarRating)

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

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

تجنُّب استخدام "مواقع Google" والتطبيقات من خلال عمليات الاحتيال والاحتيال السابق أسعار الزيارات غير الصالحة
customSegmentId

string (int64 format)

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

BrandSafetyCategories

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

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

boolean

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

enum (HighSeverityCategory)

فئات تجنب المخاطر العالية لأمان العلامة التجارية
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

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

HighSeverityCategory

الخيارات الممكنة للفئات العالية الخطورة.

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

MediumSeverityCategory

الخيارات الممكنة للفئات المتوسطة الخطورة.

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

AgeRating

الخيارات الممكنة للتصنيفات العمرية.

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

AppStarRating

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

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

enum (StarRating)

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

boolean

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

StarRating

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

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

DisplayViewability

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

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

enum (IAB)

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

enum (ViewableDuring)

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

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

الخيارات الممكنة لمعدل إمكانية العرض الصادر عن مكتب IAB

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

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

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 استهداف مستودع الويب والتطبيقات لزيادة نسبة العرض إلى 50% أو أعلى لمكتب الإعلانات التفاعلية (IAB)
IAB_VIEWABILITY_40_PERCENT_HIHGER استهداف مستودع الويب والتطبيقات لزيادة نسبة العرض إلى 40% أو أعلى لمكتب الإعلانات التفاعلية (IAB)
IAB_VIEWABILITY_30_PERCENT_HIHGER يمكنك استهداف مستودع الويب والتطبيقات لزيادة نسبة العرض إلى أقصى حد من مكتب الإعلانات التفاعلية (IAB) بنسبة 30% أو أعلى.

VideoViewableRate

الخيارات الممكنة لنسبة العرض الكامل.

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

PlayerImpressionRate

الخيارات المحتملة لمرات الظهور.

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

FraudInvalidTraffic

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

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

enum (FraudOption)

تجنُّب استخدام "مواقع Google" والتطبيقات من خلال عمليات الاحتيال والاحتيال السابق الزيارات غير الصالحة
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
  ]
}
الحقول
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 بشكل شامل.

TRAQScore

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

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

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

تفاصيل خيار استهداف نقاط الاهتمام التي تم تعيينها. ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة 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.

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

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

number

النتائج فقط. خط عرض نقطة الاهتمام التي يتم تقريبها إلى المنزل العشري السادس.
longitude

number

النتائج فقط. خط طول نقطة الاهتمام مع تقريبها إلى المنزل العشري السادس.
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

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

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

string

النتائج فقط. الاسم المعروض لسلسلة أنشطة تجارية، مثل: "KFC"، "Chase Bank".
targetingOptionId

string

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

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

number

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

enum (DistanceUnit)

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

ContentDurationAssignedTargetingOptionDetails

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

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

string

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

enum (ContentDuration)

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

ContentStreamTypeAssignedTargetingOptionDetails

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

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

string

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

enum (ContentStreamType)

النتائج فقط. نوع بث المحتوى.

NativeContentPositionAssignedTargetingOptionDetails

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

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

string

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

enum (NativeContentPosition)

موضع المحتوى:

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2

OmidAssignedTargetingOptionDetails

يُمثِّل هذا النوع نوع مستودع مستودع قابل للاستهداف تم تفعيل القياس المفتوح به. ستتم تعبئة هذا الحقل في حقل التفاصيل في خيار AssignTargetOption عندما تكون قيمة targetingType TARGETING_TYPE_OMID.

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

enum (Omid)

نوع المستودع الإعلاني الذي تم تفعيل القياس المفتوح به

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2
targetingOptionId

string

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

string

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

enum (AudioContentType)

نوع المحتوى الصوتي

المخرجات فقط في الإصدار 1. مطلوبة في الإصدار 2

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

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

الطُرق

get

 تحصل على خيار استهداف واحد تم تعيينه لإحدى الحملات.

list

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