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.

يمكن إضافة 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.

الفئات الإعلانية الحسّاسة هي استثناءات استهداف. يتم دائمًا تطبيق استبعادات الفئات الحسّاسة على مستوى المعلِن، في حال ضبطها، في عرض الإعلانات (حتى لو لم تكن مرئية في إعدادات الموارد). يمكن أن تستبعد إعدادات الموارد الفئات الحسّاسة بالإضافة إلى استبعادات المعلِنين، ولكن لا يمكنها إلغاء هذه الاستبعادات.
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)

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

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

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

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

string

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

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

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

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

UrlAssignedTargetingOptionDetails

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

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

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

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

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

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

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

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

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

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

GoogleAudienceGroup

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

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

object (GoogleAudienceTargetingSetting)

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

GoogleAudienceTargetingSetting

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

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

string (int64 format)

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

CustomListGroup

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

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

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

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

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

string (int64 format)

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

CombinedAudienceGroup

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

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

FirstPartyAndPartnerAudienceGroup

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

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

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

FirstPartyAndPartnerAudienceTargetingSetting

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

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

string (int64 format)

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

enum (Recency)

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

مدى الحداثة

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

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

مطلوب. targetingOptionId من TargetingOption من النوع TARGETING_TYPE_BROWSER.
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

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

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

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

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

enum (Environment)

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

InventorySourceAssignedTargetingOptionDetails

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

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

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

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

string

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

string

مطلوب. targetingOptionId من TargetingOption من النوع TARGETING_TYPE_LANGUAGE.
negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

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

ContentThemeAssignedTargetingOptionDetails

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

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

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

enum (Exchange)

مطلوب. قيمة التعداد للتبادل.

SubExchangeAssignedTargetingOptionDetails

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

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

string

مطلوب. targetingOptionId من TargetingOption من النوع TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

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

فئات النطاق 3 المطلوب استبعادها
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

اختياريّ. فئات المصادقة المتعددة العوامل (MFA) لمنع الاحتيال في الفيديوهات المتجاوبة على الإنترنت (IVT) من 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

فئات الاحتيال وعمليات التزوير على الإنترنت وعمليات التصيُّد الاحتيالي المتاحة في Scope3 (المعروفة سابقًا باسم Adloox)

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

GarmRiskExclusion

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

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

DisplayIabViewability

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

عمليات التعداد
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديدها أو تكون غير معروفة في هذا الإصدار
DISPLAY_IAB_VIEWABILITY_10 %10 أو أكثر في العرض (معيار إمكانية عرض الإعلانات الصورية في مكتب IAB)
DISPLAY_IAB_VIEWABILITY_20 %20 أو أكثر في العرض (معيار إمكانية عرض الإعلانات الصورية في مكتب IAB)
DISPLAY_IAB_VIEWABILITY_35 نسبة عرض تزيد عن%35 (معيار إمكانية عرض الإعلانات الصورية في مكتب IAB)
DISPLAY_IAB_VIEWABILITY_50 %50 أو أكثر في العرض (معيار إمكانية عرض الإعلانات الصورية في مكتب IAB)
DISPLAY_IAB_VIEWABILITY_75 %75 أو أكثر في العرض (معيار إمكانية عرض الإعلانات على الشبكة الإعلانية التابع لـ 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)

عناصر التحكّم في أمان العلامة التجارية في الفيديوهات المباشرة
avoidedAgeRatings[]

enum (AgeRating)

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

object (AppStarRating)

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

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

تجنَّب المواقع الإلكترونية والتطبيقات التي سجّلت معدلات احتيال وعمليات تزييف زيارات سابقة.
customSegmentId

string (int64 format)

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

BrandSafetyCategories

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

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

boolean

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

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

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

HighSeverityCategory

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

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

MediumSeverityCategory

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

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

AgeRating

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

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

AppStarRating

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

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

enum (StarRating)

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

boolean

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

StarRating

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

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

DisplayViewability

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

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

enum (IAB)

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

enum (ViewableDuring)

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

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

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

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

ViewableDuring

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

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

VideoViewability

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

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

enum (VideoIAB)

استهدِف المستودع الإعلاني على الويب لزيادة معدّل العرض وفقًا لمعيار IAB إلى أقصى حدّ.
videoViewableRate

enum (VideoViewableRate)

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

enum (PlayerImpressionRate)

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

VideoIAB

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

عمليات التعداد
VIDEO_IAB_UNSPECIFIED هذه القائمة المُدرَجة هي عنصر نائب فقط ولا تحدّد أي خيارات لنسبة المشاهدة وفقًا لمعيار IAB للفيديو.
IAB_VIEWABILITY_80_PERCENT_HIGHER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎80% أو أعلى.
IAB_VIEWABILITY_75_PERCENT_HIGHER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎75% أو أعلى.
IAB_VIEWABILITY_70_PERCENT_HIGHER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎70% أو أعلى.
IAB_VIEWABILITY_65_PERCENT_HIHGER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎65% أو أعلى.
IAB_VIEWABILITY_60_PERCENT_HIGHER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎60% أو أعلى.
IAB_VIEWABILITY_55_PERCENT_HIHGER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎55% أو أعلى.
IAB_VIEWABILITY_50_PERCENT_HIGHER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎50% أو أعلى.
IAB_VIEWABILITY_40_PERCENT_HIHGER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎40% أو أعلى.
IAB_VIEWABILITY_30_PERCENT_HIHGER استهدِف مستودع المساحات الإعلانية على الويب والتطبيقات لزيادة معدّل المشاهدة وفقًا لمعيار IAB إلى ‎30% أو أعلى.

VideoViewableRate

الخيارات المحتملة لنسبة المشاهدة الكاملة

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

PlayerImpressionRate

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

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

FraudInvalidTraffic

إعدادات DoubleVerify Fraud & Invalid Traffic

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

enum (FraudOption)

تجنَّب المواقع الإلكترونية والتطبيقات التي سجّلت عمليات احتيال أو عروض ترويجيّة غير مرغوب فيها في السابق.
avoidInsufficientOption

boolean

عدم توفّر إحصاءات كافية عن الاحتيال وعدد الزيارات غير الصالحة في الفترة السابقة

FraudOption

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

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

IntegralAdScience

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

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

enum (TRAQScore)

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

boolean

أمان العلامة التجارية: لا يمكن تقييمه
excludedAdultRisk

enum (Adult)

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

enum (Alcohol)

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

enum (IllegalDownloads)

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

enum (Drugs)

أمان العلامة التجارية: الأدوية
excludedHateSpeechRisk

enum (HateSpeech)

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

enum (OffensiveLanguage)

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

enum (Violence)

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

enum (Gambling)

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

enum (AdFraudPrevention)

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

enum (DisplayViewability)

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

enum (VideoViewability)

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

string (int64 format)

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

string (int64 format)

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

TRAQScore

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

عمليات التعداد
TRAQ_UNSPECIFIED هذا التصنيف مجرد عنصر نائب ولا يحدّد أيّ نقاط جودة حقيقية للإعلانات.
TRAQ_250 تتراوح نتيجة TRAQ بين 250 و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

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

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

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

يمثّل نوع مستودع إعلاني قابل للاستهداف ومفعّل فيه قياس الأداء المفتوح. سيتمّ ملء هذا الحقل في حقل التفاصيل الخاص بخيار الاستهداف المحدّد عندما يكون targetingType هو TARGETING_TYPE_OMID.

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

enum (Omid)

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

AudioContentTypeAssignedTargetingOptionDetails

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

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

enum (AudioContentType)

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

ContentGenreAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

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

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

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

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

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

enum (SessionPosition)

موضع ظهور الإعلان في الجلسة

SessionPosition

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

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

الطُرق

get

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

list

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