REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

المرجع: خيار الاستهداف المخصَّص

خيار استهداف واحد مُعين، يحدد حالة خيار الاستهداف لكيان لديه إعدادات استهداف.

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

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

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

تفاصيل حول خيار استهداف القناة الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType هي TARGETING_TYPE_CHANNEL.

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

string (int64 format)

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

boolean

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

AppCategoryAssignedTargetingOptionDetails

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

تفاصيل حول خيار استهداف التطبيق الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType هي TARGETING_TYPE_APP.

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

string

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

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

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

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

UrlAssignedTargetingOptionDetails

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

مطلوبة. ساعة النهاية لاستهداف اليوم والوقت. يجب أن تتراوح المدة بين ساعة واحدة (بعد ساعة واحدة من بداية اليوم) و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

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

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

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

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

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

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

string

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

enum (DeviceType)

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

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

AudienceGroupAssignedTargetingOptionDetails

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

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

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

object (FirstAndThirdPartyAudienceGroup)

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

object (GoogleAudienceGroup)

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

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

تفاصيل مجموعة الجمهور المُجمَّعة. وتكون جميع إعدادات استهداف الجمهور المُجمَّعة حسب "OR" بشكلٍ منطقي.

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

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

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

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

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

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

string

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

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

boolean

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

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

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

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

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

string

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

string

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

boolean

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

GeoRegionAssignedTargetingOptionDetails

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

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

string

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

تفاصيل الاستهداف للفئة الحساسة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType هي TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

string

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

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

تفاصيل خيار استهداف Exchange الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType هي TARGETING_TYPE_EXCHANGE.

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

string

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

SubExchangeAssignedTargetingOptionDetails

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

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

string

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

ThirdPartyVerifierAssignedTargetingOptionDetails

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

أداة التحقق من العلامات التجارية التابعة لجهة خارجية -- DoubleCheck.
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 محتوى للبالغين (محتوى ناعم)
ILLEGAL_CONTENT محتوى غير قانوني.
BORDERLINE_CONTENT محتوى قريب من مخالفة السياسات
DISCRIMINATORY_CONTENT المحتوى التمييزي
VIOLENT_CONTENT_WEAPONS المحتوى الذي يتضمّن عنفًا والأسلحة
LOW_VIEWABILITY_DOMAINS نطاقات إمكانية العرض المنخفضة:
FRAUD الاحتيال

DoubleVerify

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

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

رقم تعريف شريحة الجمهور المخصّصة المقدَّم من DoubleCheck. يجب أن يبدأ المعرّف بـ "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

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

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

تفاصيل إعدادات إمكانية عرض الإعلانات المعروضة في Doubleتحقّق

تمثيل 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 استهداف مستودع المساحات المتوفّرة للإعلانات على الويب وفي التطبيقات لزيادة معدّل إمكانية العرض لمكتب الإعلانات التفاعلية إلى أقصى حدّ بنسبة% 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 استهداف مستودع المساحات المتوفّرة للإعلانات على الويب وفي التطبيقات لزيادة معدّل العرض إلى أقصى حد بنسبة 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

تفاصيل إعدادات إمكانية عرض الفيديو في Doubleتحقّق

تمثيل 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 استهداف مستودع المساحات المتوفّرة للإعلانات على الويب وفي التطبيقات لزيادة معدّل إمكانية العرض لمكتب الإعلانات التفاعلية إلى أقصى حدّ بنسبة% 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 استهداف مستودع المساحات المتوفّرة للإعلانات على الويب وفي التطبيقات لزيادة معدّل العرض إلى أقصى حد بنسبة 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

إعدادات DoubleClick Connect والاحتيال والزيارات غير الصالحة

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

enum (FraudOption)

تجنُّب المواقع الإلكترونية والتطبيقات التي تتضمّن عمليات احتيال أو زيارات غير صالحة ناشئة عن تقنيات معروفة
avoidInsufficientOption

boolean

إحصاءات غير كافية حول الاحتيال التاريخي وغير ذلك.

FraudOption

الخيارات المحتملة لمعدّل الاحتيال والزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT)

عمليات التعداد
FRAUD_UNSPECIFIED وهذا التعداد هو مجرّد عنصر نائب ولا يحدّد أي خيارات للاحتيال أو للزيارات غير الصالحة.
AD_IMPRESSION_FRAUD_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

نطاقات نتائج 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

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

تفاصيل لخيار استهداف سلسلة الأنشطة التجارية الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة 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

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

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