- المورد: خيار الاستهداف المحدَّد
- تمثيل JSON
- الاكتساب
- ChannelAssignedTargetingOptionDetails
- AppCategoryAssignedTargetingOptionDetails
- AppAssignedTargetingOptionDetails
- AppPlatform
- UrlAssignedTargetingOptionDetails
- DayAndTimeAssignedTargetingOptionDetails
- DayOfWeek
- TimeZoneResolution
- AgeRangeAssignedTargetingOptionDetails.
- RegionalLocationListAssignedTargetingOptionDetails
- ProximityLocationListAssignedTargetingOptionDetails
- ProximityRadiusRange
- GenderAssignedTargetingOptionDetails
- VideoPlayerSizeAssignedTargetingOptionDetails
- UserRewardedContentAssignedTargetingOptionDetails
- ParentalStatusAssignedTargetingOptionDetails
- ContentInstreamPositionAssignedTargetingOptionDetails
- AdType
- ContentOutstreamPositionAssignedTargetingOptionDetails
- DeviceTypeAssignedTargetingOptionDetails
- AudienceGroupAssignedTargetingOptionDetails
- FirstAndThirdPartyAudienceGroup
- FirstAndThirdPartyAudienceTargetingSetting
- مدى الحداثة
- GoogleAudienceGroup
- GoogleAudienceTargetingSetting
- CustomListGroup
- CustomListTargetingSetting
- CombinedAudienceGroup
- CombinedAudienceTargetingSetting
- BrowserAssignedTargetingOptionDetails
- HouseholdIncomeAssignedTargetingOptionDetails
- OnScreenPositionAssignedTargetingOptionDetails
- CarrierAndIspAssignedTargetingOptionDetails
- KeywordAssignedTargetingOptionDetails
- NegativeKeywordListAssignedTargetingOptionDetails
- OperatingSystemAssignedTargetingOptionDetails
- DeviceMakeModelAssignedTargetingOptionDetails
- EnvironmentAssignedTargetingOptionDetails
- InventorySourceAssignedTargetingOptionDetails
- CategoryAssignedTargetingOptionDetails
- ViewabilityAssignedTargetingOptionDetails
- AuthorizedSellerStatusAssignedTargetingOptionDetails
- LanguageAssignedTargetingOptionDetails
- GeoRegionAssignedTargetingOptionDetails
- InventorySourceGroupAssignedTargetingOptionDetails
- DigitalContentLabelAssignedTargetingOptionDetails
- SensitiveCategoryAssignedTargetingOptionDetails
- ExchangeAssignedTargetingOptionDetails
- SubExchangeAssignedTargetingOptionDetails
- ThirdPartyVerifierAssignedTargetingOptionDetails
- Adloox
- AdlooxCategory
- DoubleVerify
- BrandSafetyCategories
- HighSeverityCategory
- MediumSeverityCategory
- AgeRating
- AppStarRating
- StarRating
- DisplayViewability
- مكتب الإعلانات التفاعلية (IAB)
- ViewableDuring
- VideoViewability
- VideoIAB
- VideoViewableRate
- PlayerImpressionRate
- FraudInvalidTraffic
- FraudOption
- IntegralAdScience
- TRAQScore
- للبالغين
- الكحول
- IllegalDownloads
- المخدّرات
- HateSpeech
- OffensiveLanguage
- العنف
- المقامرة
- AdFraudPrevention
- DisplayViewability
- VideoViewability
- PoiAssignedTargetingOptionDetails
- DistanceUnit
- BusinessChainAssignedTargetingOptionDetails
- ContentDurationAssignedTargetingOptionDetails.
- ContentStreamTypeAssignedTargetingOptionDetails
- NativeContentPositionAssignedTargetingOptionDetails
- OmidAssignedTargetingOptionDetails
- AudioContentTypeAssignedTargetingOptionDetails
- ContentGenreAssignedTargetingOptionDetails
- الطُرق
المرجع: خيار الاستهداف المخصَّص
خيار استهداف واحد مُعين، يحدد حالة خيار الاستهداف لكيان لديه إعدادات استهداف.
تمثيل JSON |
---|
{ "name": string, "assignedTargetingOptionId": string, "targetingType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لخيار الاستهداف الذي تم تعيينه هذا. |
assignedTargetingOptionId |
النتائج فقط. رقم التعريف الفريد لخيار الاستهداف المعيَّن. ويكون رقم التعريف فريدًا فقط ضمن مورد ونوع استهداف معيّنَين. وقد تتم إعادة استخدامه في سياقات أخرى. |
targetingType |
النتائج فقط. تحدد نوع خيار الاستهداف الذي تم تعيينه هذا. |
inheritance |
النتائج فقط. حالة الاكتساب لخيار الاستهداف الذي تم تعيينه. |
حقل الاتحاد details معلومات تفصيلية عن خيار الاستهداف الذي يتم تعيينه. يمكن ملء حقل واحد فقط في التفاصيل، ويجب أن يتوافق مع السمة targeting_type ، ويمكن أن يكون الحقل details واحدًا فقط مما يلي: |
|
channelDetails |
تفاصيل القناة وستتم تعبئة هذا الحقل عندما تكون قيمة |
appCategoryDetails |
تفاصيل فئة التطبيق وستتم تعبئة هذا الحقل عندما تكون قيمة |
appDetails |
تفاصيل التطبيق وستتم تعبئة هذا الحقل عندما تكون قيمة |
urlDetails |
تفاصيل عنوان URL. وستتم تعبئة هذا الحقل عندما تكون قيمة |
dayAndTimeDetails |
تفاصيل اليوم والوقت. وستتم تعبئة هذا الحقل عندما تكون قيمة |
ageRangeDetails |
تفاصيل الفئة العمرية وستتم تعبئة هذا الحقل عندما تكون قيمة |
regionalLocationListDetails |
تفاصيل قائمة المواقع الجغرافية الإقليمية وستتم تعبئة هذا الحقل عندما تكون قيمة |
proximityLocationListDetails |
تفاصيل قائمة المواقع القريبة. وستتم تعبئة هذا الحقل عندما تكون قيمة |
genderDetails |
تفاصيل الجنس وستتم تعبئة هذا الحقل عندما تكون قيمة |
videoPlayerSizeDetails |
تفاصيل حجم مشغّل الفيديو وستتم تعبئة هذا الحقل عندما تكون قيمة |
userRewardedContentDetails |
تفاصيل المحتوى الذي يضم مكافأة للمستخدم وستتم تعبئة هذا الحقل عندما تكون قيمة |
parentalStatusDetails |
تفاصيل الحالة الأبوية. وستتم تعبئة هذا الحقل عندما تكون قيمة |
contentInstreamPositionDetails |
تفاصيل موضع الإعلان أثناء عرض المحتوى. وستتم تعبئة هذا الحقل عندما تكون قيمة |
contentOutstreamPositionDetails |
تفاصيل موضع الإعلان خارج البث وستتم تعبئة هذا الحقل عندما تكون قيمة |
deviceTypeDetails |
تفاصيل نوع الجهاز وستتم تعبئة هذا الحقل عندما تكون قيمة |
audienceGroupDetails |
تفاصيل استهداف الجمهور. وستتم تعبئة هذا الحقل عندما تكون قيمة |
browserDetails |
تفاصيل المتصفّح وستتم تعبئة هذا الحقل عندما تكون قيمة |
householdIncomeDetails |
تفاصيل دخل الأسرة وستتم تعبئة هذا الحقل عندما تكون قيمة |
onScreenPositionDetails |
على تفاصيل موضع الشاشة. وستتم تعبئة هذا الحقل عندما تكون قيمة |
carrierAndIspDetails |
تفاصيل مشغّل شبكة الجوّال ومزوّد خدمة الإنترنت وستتم تعبئة هذا الحقل عندما تكون قيمة |
keywordDetails |
تفاصيل الكلمات الرئيسية وستتم تعبئة هذا الحقل عندما تكون قيمة يمكن تخصيص 5,000 كلمة رئيسية سلبية مباشرة كحدّ أقصى لمورد معيَّن. لا يوجد حد لعدد الكلمات الرئيسية الإيجابية التي يمكن تعيينها. |
negativeKeywordListDetails |
تفاصيل الكلمات الرئيسية وستتم تعبئة هذا الحقل عندما تكون قيمة يمكن تخصيص 4 قوائم كلمات رئيسية سلبية كحدّ أقصى لمورد معيَّن. |
operatingSystemDetails |
تفاصيل نظام التشغيل وستتم تعبئة هذا الحقل عندما تكون قيمة |
deviceMakeModelDetails |
تفاصيل العلامة التجارية للجهاز وطرازه وستتم تعبئة هذا الحقل عندما تكون قيمة |
environmentDetails |
تفاصيل البيئة وستتم تعبئة هذا الحقل عندما تكون قيمة |
inventorySourceDetails |
تفاصيل مصدر المستودع وستتم تعبئة هذا الحقل عندما تكون قيمة |
categoryDetails |
تفاصيل الفئة. وستتم تعبئة هذا الحقل عندما تكون قيمة سيؤدي استهداف فئة إلى استهداف فئاتها الفرعية أيضًا. إذا تم استبعاد فئة من الاستهداف، وتم تضمين فئة فرعية، تكون الأولوية للاستبعاد. |
viewabilityDetails |
تفاصيل إمكانية العرض وستتم تعبئة هذا الحقل عندما تكون قيمة يمكنك استهداف خيار إمكانية عرض واحد فقط لكل مورد. |
authorizedSellerStatusDetails |
تفاصيل حالة البائع المفوَّض وستتم تعبئة هذا الحقل عندما تكون قيمة يمكنك استهداف خيار واحد فقط لحالة البائع المعتمَدة لكل مورد. إذا لم يتضمّن أحد الموارد خيار حالة البائع المفوَّض، يتم تلقائيًا استهداف جميع البائعين المعتمَدين بصفتهم "مباشر" أو "مورّدين" في ملف ads.txt. |
languageDetails |
تفاصيل اللغة وستتم تعبئة هذا الحقل عندما تكون قيمة |
geoRegionDetails |
تفاصيل المناطق الجغرافية وستتم تعبئة هذا الحقل عندما تكون قيمة |
inventorySourceGroupDetails |
تفاصيل مجموعة مصادر المستودع وستتم تعبئة هذا الحقل عندما تكون قيمة |
digitalContentLabelExclusionDetails |
تفاصيل تصنيفات المحتوى الرقمي وستتم تعبئة هذا الحقل عندما تكون قيمة تصنيفات المحتوى الرقمي تستهدف الاستبعادات. إنّ استبعادات تصنيفات المحتوى الرقمي على مستوى المعلِن، في حال ضبطها، يتم دائمًا تطبيقها في العرض (على الرغم من عدم ظهورها في إعدادات الموارد). يمكن أن تستبعد إعدادات الموارد تصنيفات المحتوى بالإضافة إلى استبعادات المعلِنين، ولكن لا يمكنها إلغاؤها. ولن يتم عرض عنصر في حال استبعاد جميع تصنيفات المحتوى الرقمي. |
sensitiveCategoryExclusionDetails |
تفاصيل الفئات الحساسة. وستتم تعبئة هذا الحقل عندما تكون قيمة الفئات الإعلانية الحساسة هي استهداف الاستبعادات. إنّ استبعادات الفئات الإعلانية الحساسة على مستوى المعلِن، في حال ضبطها، يتم تطبيقها دائمًا في العرض (على الرغم من عدم ظهورها في إعدادات الموارد). يمكن أن تستبعد إعدادات الموارد الفئات الإعلانية الحساسة بالإضافة إلى استبعادات المعلنين، ولكن لا يمكن إلغاؤها. |
exchangeDetails |
تفاصيل التبادل. وستتم تعبئة هذا الحقل عندما تكون قيمة |
subExchangeDetails |
تفاصيل التبادل الفرعي. وستتم تعبئة هذا الحقل عندما تكون قيمة |
thirdPartyVerifierDetails |
تفاصيل إثبات هوية وأهلية الجهة الخارجية وستتم تعبئة هذا الحقل عندما تكون قيمة |
poiDetails |
تفاصيل نقطة الاهتمام. وستتم تعبئة هذا الحقل عندما تكون قيمة |
businessChainDetails |
تفاصيل سلسلة الأنشطة التجارية وستتم تعبئة هذا الحقل عندما تكون قيمة |
contentDurationDetails |
تفاصيل مدة المحتوى وستتم تعبئة هذا الحقل عندما تكون قيمة |
contentStreamTypeDetails |
تفاصيل مدة المحتوى ستتم تعبئة هذا الحقل عندما يكون نوع الاستهداف |
nativeContentPositionDetails |
تفاصيل موضع المحتوى الأصلي وستتم تعبئة هذا الحقل عندما تكون قيمة |
omidDetails |
افتح تفاصيل المستودع المفعَّل فيه القياس. وستتم تعبئة هذا الحقل عندما تكون قيمة |
audioContentTypeDetails |
تفاصيل نوع المحتوى الصوتي وستتم تعبئة هذا الحقل عندما تكون قيمة |
contentGenreDetails |
تفاصيل نوع المحتوى وستتم تعبئة هذا الحقل عندما تكون قيمة |
الاكتساب
يشير إلى ما إذا كان خيار الاستهداف المعيَّن موروثًا من كيان على مستوى أعلى، مثل شريك أو معلن. تكون لخيارات الاستهداف المكتسَبة المُكتسَبة أولوية، وتنطبق دائمًا على العرض على الاستهداف المحدَّد على المستوى الحالي، ولا يمكن تعديلها من خلال خدمة الكيان الحالية. ويجب تعديلها من خلال خدمة الكيان التي تم اكتسابها منها. لا ينطبق الاكتساب إلا على القنوات المستهدَفة السلبية واستبعادات الفئات الإعلانية الحسّاسة واستبعادات تصنيفات المحتوى الرقمي إذا تم ضبطها على المستوى الرئيسي.
عمليات التعداد | |
---|---|
INHERITANCE_UNSPECIFIED |
الوراثة غير محدد أو غير معروف. |
NOT_INHERITED |
خيار الاستهداف الذي تم تعيينه غير موروث من الكيان على مستوى أعلى. |
INHERITED_FROM_PARTNER |
يتم اكتساب خيار الاستهداف المعيَّن من إعدادات استهداف الشركاء. |
INHERITED_FROM_ADVERTISER |
يتم اكتساب خيار الاستهداف الذي تم تعيينه من إعدادات استهداف المعلنين. |
ChannelAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف القناة الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_CHANNEL
.
تمثيل JSON |
---|
{ "channelId": string, "negative": boolean } |
الحقول | |
---|---|
channelId |
مطلوبة. رقم تعريف القناة. يجب أن تتم الإشارة إلى حقل "معرّف القناة" في مرجع قناة يملكها الشريك أو قناة يملكها المعلِن. |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. يجب أن يكون هذا الحقل صحيحًا بالنسبة إلى خيار الاستهداف الذي يتم تعيينه على مستوى المعلن. |
AppCategoryAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف فئة التطبيق الذي تم تعيينه ستتم تعبئة هذا الحقل في الحقل appCategoryDetails
ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_APP_CATEGORY
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لفئة التطبيق. |
targetingOptionId |
مطلوبة. الحقل |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
AppAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف التطبيق الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_APP
.
تمثيل JSON |
---|
{
"appId": string,
"displayName": string,
"negative": boolean,
"appPlatform": enum ( |
الحقول | |
---|---|
appId |
مطلوبة. رقم تعريف التطبيق. يستخدم تطبيق "متجر Play" لنظام التشغيل Android معرِّف الحزمة، على سبيل المثال |
displayName |
النتائج فقط. الاسم المعروض للتطبيق |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
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 |
مطلوبة. عنوان URL، على سبيل المثال تدعم "مساحة العرض والفيديو 360" مستويين من استهداف الدليل الفرعي، مثل |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
DayAndTimeAssignedTargetingOptionDetails
تمثّل هذه السمة جزءًا من الوقت تم تحديده في يوم معيّن من الأسبوع ووقت بدء وانتهاء. يجب أن يكون الوقت الذي يمثّله startHour
قبل الوقت الذي يمثّله endHour
.
تمثيل JSON |
---|
{ "dayOfWeek": enum ( |
الحقول | |
---|---|
dayOfWeek |
مطلوبة. اليوم من الأسبوع لإعداد استهداف هذا اليوم والوقت. |
startHour |
مطلوبة. ساعة البدء لاستهداف اليوم والوقت. يجب أن تتراوح القيمة بين 0 (بداية اليوم) و23 (قبل ساعة واحدة من نهاية اليوم). |
endHour |
مطلوبة. ساعة النهاية لاستهداف اليوم والوقت. يجب أن تتراوح المدة بين ساعة واحدة (بعد ساعة واحدة من بداية اليوم) و24 (نهاية اليوم). |
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 |
الفئة العمرية للجمهور. لا نتيح إلا استهداف فئة عمرية مستمرة للجمهور. وبالتالي، يمكن أن تكون الفئة العمرية الممثلة في هذا الحقل 1) مستهدَفًا فقط أو 2) جزءًا من فئة عمرية مستمرة أكبر. يمكن توسيع مدى وصول استهداف الفئة العمرية المستمرة عن طريق استهداف جمهور من عمر غير معروف أيضًا. النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
RegionalLocationListAssignedTargetingOptionDetails
تفاصيل استهداف قائمة المواقع الجغرافية الإقليمية ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_REGIONAL_LOCATION_LIST
.
تمثيل JSON |
---|
{ "regionalLocationListId": string, "negative": boolean } |
الحقول | |
---|---|
regionalLocationListId |
مطلوبة. رقم تعريف قائمة المواقع الجغرافية الإقليمية يجب أن يشير إلى الحقل |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
ProximityLocationListAssignedTargetingOptionDetails
تفاصيل استهداف قائمة المواقع الجغرافية القريبة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_PROXIMITY_LOCATION_LIST
.
تمثيل JSON |
---|
{
"proximityLocationListId": string,
"proximityRadiusRange": enum ( |
الحقول | |
---|---|
proximityLocationListId |
مطلوبة. رقم تعريف قائمة المواقع الجغرافية القريبة. يجب أن يشير إلى الحقل |
proximityRadiusRange |
مطلوبة. نطاق النطاق الجغرافي لقائمة المواقع الجغرافية القريبة ويمثّل هذا حجم المنطقة المحيطة بموقع جغرافي مختار سيتم استهدافه. يجب أن تكون قيمة الموقع الجغرافي القريب في |
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 |
جنس الجمهور. النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
VideoPlayerSizeAssignedTargetingOptionDetails
تفاصيل خيارات استهداف حجم مشغّل الفيديو ستتم تعبئة هذه البيانات في الحقل videoPlayerSizeDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_VIDEO_PLAYER_SIZE
. استهداف جميع الخيارات بشكل صريح غير متاح. أزل كل خيارات استهداف حجم مشغّل الفيديو لتحقيق هذا التأثير.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"videoPlayerSize": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
videoPlayerSize |
حجم مشغّل الفيديو النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
UserRewardedContentAssignedTargetingOptionDetails
تفاصيل خيار استهداف المحتوى الذي يضم مكافأة للمستخدم ستتم تعبئة هذه البيانات في الحقل userRewardedContentDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_USER_REWARDED_CONTENT
.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"userRewardedContent": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
userRewardedContent |
النتائج فقط. حالة المحتوى الذي يضم مكافأة للمستخدم لإعلانات الفيديو. |
ParentalStatusAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف الحالة الأبوية الذي تمّ تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_PARENTAL_STATUS
.
تمثيل JSON |
---|
{
"parentalStatus": enum ( |
الحقول | |
---|---|
parentalStatus |
الحالة الأبوية للجمهور. النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
ContentInstreamPositionAssignedTargetingOptionDetails
تفاصيل خيار استهداف موضع الإعلان ضمن البث المباشر للمحتوى الذي تم تعيينه. ستتم تعبئة هذه البيانات في الحقل contentInstreamPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_INSTREAM_POSITION
.
تمثيل JSON |
---|
{ "targetingOptionId": string, "contentInstreamPosition": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
contentInstreamPosition |
موضع إعلان أثناء عرض المحتوى لإعلانات الفيديو أو الإعلانات الصوتية. النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
adType |
النتائج فقط. نوع الإعلان المطلوب استهدافه. لا يسري ذلك إلا على استهداف طلبات الإدراج والعناصر الجديدة التي تدعم نوع الإعلان المحدّد. وستكتسب خيار الاستهداف هذا تلقائيًا خيار الاستهداف. القيم المتاحة:
|
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 ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
contentOutstreamPosition |
موضع ظهور المحتوى خارج البث النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
adType |
النتائج فقط. نوع الإعلان المطلوب استهدافه. لا يسري ذلك إلا على استهداف طلبات الإدراج والعناصر الجديدة التي تدعم نوع الإعلان المحدّد. وستكتسب خيار الاستهداف هذا تلقائيًا خيار الاستهداف. القيم المتاحة:
|
DeviceTypeAssignedTargetingOptionDetails
تفاصيل الاستهداف لنوع الجهاز ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_DEVICE_TYPE
.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"deviceType": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. رقم تعريف نوع الجهاز. |
deviceType |
الاسم المعروض لنوع الجهاز النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
AudienceGroupAssignedTargetingOptionDetails
تفاصيل خيار استهداف مجموعة الجمهور المحدّدة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_AUDIENCE_GROUP
. العلاقة بين كل مجموعة هي UNION، باستثناء فرعَي العروض المستبعَدينFirstAndFirstPartyGroupGroup واللذين يستبعدهما GoogleDeviceGroup، والتي يتم استخدام COMPLEMENT منها كنقطة إنزال مع مجموعات أخرى.
تمثيل JSON |
---|
{ "includedFirstAndThirdPartyAudienceGroups": [ { object ( |
الحقول | |
---|---|
includedFirstAndThirdPartyAudienceGroups[] |
رقما تعريف الجمهور وحالاتهما الخاصة بالطرف الأول والطرف الثالث لمجموعات الجمهور المضمّنة الأولى والثالثة تحتوي كل مجموعة جمهور للطرف الأول والطرف الثالث على أرقام تعريف جمهور للطرف الأول والطرف الثالث فقط. العلاقة بين كل مجموعة جمهور للطرف الأول والطرف الثالث هي Interint، والنتيجة هي UNION مع مجموعات جمهور أخرى. وسيتم تجاهل المجموعات المكرّرة التي لها الإعدادات نفسها. |
includedGoogleAudienceGroup |
أرقام تعريف شرائح جمهور Google لمجموعة جمهور Google المضمّنة تحتوي على أرقام تعريف شرائح جمهور Google فقط. |
includedCustomListGroup |
أرقام تعريف القوائم المخصّصة لمجموعة القوائم المخصّصة المضمّنة. يحتوي على أرقام تعريف القوائم المخصّصة فقط. |
includedCombinedAudienceGroup |
أرقام تعريف شرائح الجمهور المُجمَّعة لمجموعة الجمهور المُجمَّع المُضمَّنة. يحتوي على أرقام تعريف شرائح جمهور مُجمَّعة فقط. |
excludedFirstAndThirdPartyAudienceGroup |
رقما تعريف جمهور الطرف الأول والطرف الثالث وحالاتهما لمجموعة الجمهور المستبعَدة من الطرف الأول والطرف الثالث. تُستخدَم للاستهداف السلبي. يتم استخدام تكملة اتحاد هذه المجموعة ومجموعات الجمهور المستبعَدة الأخرى كنقطة نهاية لأي استهداف إيجابي للجمهور. تتطابق جميع العناصر منطقيًا باستخدام "OR" مع بعضها. |
excludedGoogleAudienceGroup |
أرقام تعريف شرائح جمهور Google لمجموعة جمهور Google المستبعدة تُستخدَم للاستهداف السلبي. يتم استخدام تكملة اتحاد هذه المجموعة ومجموعات الجمهور المستبعَدة الأخرى كنقطة نهاية لأي استهداف إيجابي للجمهور. يحتوي فقط على شرائح جمهور Google من النوع "شرائح الجمهور ذات الاهتمامات المشتركة" و"الجمهور في السوق" و"التطبيقات المثبّتة". تتطابق جميع العناصر منطقيًا باستخدام "OR" مع بعضها. |
FirstAndThirdPartyAudienceGroup
تفاصيل مجموعة الجمهور التابعة للطرف الأول والطرف الثالث. تتطابق جميع إعدادات استهداف جمهور الطرف الأول والطرف الثالث مع بعضها بشكل منطقي.
تمثيل JSON |
---|
{
"settings": [
{
object ( |
الحقول | |
---|---|
settings[] |
مطلوبة. جميع إعدادات استهداف جمهور الطرف الأول والطرف الثالث في مجموعة جمهور الطرف الأول والطرف الثالث. غير مسموح بالإعدادات المتكررة باستخدام رقم التعريف نفسه. |
FirstAndThirdPartyAudienceTargetingSetting
تفاصيل إعداد استهداف جمهور الطرف الأول والطرف الثالث.
تمثيل JSON |
---|
{
"firstAndThirdPartyAudienceId": string,
"recency": enum ( |
الحقول | |
---|---|
firstAndThirdPartyAudienceId |
مطلوبة. رقم تعريف جمهور الطرف الأول والطرف الثالث لإعداد استهداف جمهور الطرف الأول والطرف الثالث. هذا المعرّف هو |
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 ( |
الحقول | |
---|---|
settings[] |
مطلوبة. جميع إعدادات استهداف جمهور Google في مجموعة جمهور Google. وسيتم تجاهل الإعدادات المتكررة التي لها رقم التعريف نفسه. |
GoogleAudienceTargetingSetting
تفاصيل إعداد استهداف الجمهور في Google.
تمثيل JSON |
---|
{ "googleAudienceId": string } |
الحقول | |
---|---|
googleAudienceId |
مطلوبة. رقم تعريف جمهور Google لإعداد استهداف الجمهور في Google. هذا المعرّف هو |
CustomListGroup
تفاصيل مجموعة القوائم المخصّصة. تتطابق جميع إعدادات استهداف القائمة المخصّصة مع بعضها بشكل منطقي.
تمثيل JSON |
---|
{
"settings": [
{
object ( |
الحقول | |
---|---|
settings[] |
مطلوبة. جميع إعدادات استهداف القائمة المخصّصة في مجموعة القوائم المخصّصة وسيتم تجاهل الإعدادات المتكررة التي لها رقم التعريف نفسه. |
CustomListTargetingSetting
تفاصيل إعداد استهداف القائمة المخصّصة.
تمثيل JSON |
---|
{ "customListId": string } |
الحقول | |
---|---|
customListId |
مطلوبة. رقم تعريف مخصّص لإعداد استهداف القائمة المخصّصة. هذا المعرّف هو |
CombinedAudienceGroup
تفاصيل مجموعة الجمهور المُجمَّعة. وتكون جميع إعدادات استهداف الجمهور المُجمَّعة حسب "OR" بشكلٍ منطقي.
تمثيل JSON |
---|
{
"settings": [
{
object ( |
الحقول | |
---|---|
settings[] |
مطلوبة. كل إعدادات استهداف الجمهور المُجمَّعة في مجموعة جمهور مُجمَّعة. وسيتم تجاهل الإعدادات المتكررة التي لها رقم التعريف نفسه. يجب ألا يزيد عدد إعدادات الجمهور المجمّعة عن خمسة، وإلا سيحدث الخطأ. |
CombinedAudienceTargetingSetting
تفاصيل إعداد استهداف الجمهور المجمّع.
تمثيل JSON |
---|
{ "combinedAudienceId": string } |
الحقول | |
---|---|
combinedAudienceId |
مطلوبة. رقم تعريف الجمهور المُجمَّع لإعداد استهداف الجمهور المُجمَّع. هذا المعرّف هو |
BrowserAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف المتصفّح الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_BROWSER
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. هو الاسم المعروض للمتصفّح. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. يجب أن تحتوي كل خيارات استهداف المتصفِّح المخصَّصة في المورد نفسه على القيمة نفسها لهذا الحقل. |
HouseholdIncomeAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف دخل الأسرة المحدّد ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_HOUSEHOLD_INCOME
.
تمثيل JSON |
---|
{
"householdIncome": enum ( |
الحقول | |
---|---|
householdIncome |
دخل الأسرة للجمهور. النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
OnScreenPositionAssignedTargetingOptionDetails
تفاصيل خيار استهداف الموضع على الشاشة ستتم تعبئة هذه البيانات في الحقل onScreenPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_ON_SCREEN_POSITION
.
تمثيل JSON |
---|
{ "targetingOptionId": string, "onScreenPosition": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
onScreenPosition |
النتائج فقط. الموضع على الشاشة. |
adType |
النتائج فقط. نوع الإعلان المطلوب استهدافه. لا يسري ذلك إلا على استهداف طلبات الإدراج والعناصر الجديدة التي تدعم نوع الإعلان المحدّد. وستكتسب خيار الاستهداف هذا تلقائيًا خيار الاستهداف. القيم المتاحة:
|
CarrierAndIspAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف شبكة الجوّال ومزوّد خدمة الإنترنت الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_CARRIER_AND_ISP
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لمشغّل شبكة الجوّال أو مزوّد خدمة الإنترنت |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. يجب أن تحتوي جميع خيارات استهداف شركات الجوّال ومزوّد خدمة الإنترنت على القيمة نفسها لهذا الحقل. |
KeywordAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف الكلمات الرئيسية المعيَّن. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_KEYWORD
.
تمثيل JSON |
---|
{ "keyword": string, "negative": boolean } |
الحقول | |
---|---|
keyword |
مطلوبة. الكلمة الرئيسية، على سبيل المثال لا يجوز أن تكون الكلمة الرئيسية الإيجابية كلمة مسيئة. يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 255 بايت. الحد الأقصى لعدد الأحرف هو 80 حرفًا. الحد الأقصى لعدد الكلمات هو 10 كلمات. |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
NegativeKeywordListAssignedTargetingOptionDetails
تفاصيل الاستهداف لقائمة الكلمات الرئيسية السلبية ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
.
تمثيل JSON |
---|
{ "negativeKeywordListId": string } |
الحقول | |
---|---|
negativeKeywordListId |
مطلوبة. رقم تعريف قائمة الكلمات الرئيسية السلبية. يجب أن يشير إلى الحقل |
OperatingSystemAssignedTargetingOptionDetails
تفاصيل خيار استهداف نظام التشغيل المعين. ستتم تعبئة هذه البيانات في الحقل operatingSystemDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_OPERATING_SYSTEM
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لنظام التشغيل. |
targetingOptionId |
مطلوبة. رقم تعريف خيار الاستهداف الذي تتم تعبئته في الحقل |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
DeviceMakeModelAssignedTargetingOptionDetails
تفاصيل خيارات استهداف ماركة الجهاز وطرازه. ستتم تعبئة هذه البيانات في الحقل deviceMakeModelDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_DEVICE_MAKE_MODEL
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض للعلامة التجارية للجهاز وطرازه. |
targetingOptionId |
مطلوبة. الحقل |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
EnvironmentAssignedTargetingOptionDetails
تفاصيل خيار استهداف البيئة المعينة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_ENVIRONMENT
.
تمثيل JSON |
---|
{
"environment": enum ( |
الحقول | |
---|---|
environment |
بيئة العرض: النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. |
InventorySourceAssignedTargetingOptionDetails
تفاصيل الاستهداف لمصدر المستودع الإعلاني ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_INVENTORY_SOURCE
.
تمثيل JSON |
---|
{ "inventorySourceId": string } |
الحقول | |
---|---|
inventorySourceId |
مطلوبة. رقم تعريف مصدر المستودع يجب أن يشير إلى الحقل |
CategoryAssignedTargetingOptionDetails
تفاصيل خيار استهداف الفئة المعينة. ستتم تعبئة هذه البيانات في الحقل categoryDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CATEGORY
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض للفئة. |
targetingOptionId |
مطلوبة. الحقل |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
ViewabilityAssignedTargetingOptionDetails
تفاصيل خيار استهداف إمكانية العرض المخصَّص ستتم تعبئة هذا الحقل في الحقل viewabilityDetails
ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_VIEWABILITY
.
تمثيل JSON |
---|
{
"viewability": enum ( |
الحقول | |
---|---|
viewability |
النسبة المئوية لإمكانية العرض المتوقّعة النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. |
AuthorizedSellerStatusAssignedTargetingOptionDetails
يُمثِّل هذا الخيار حالة بائع مُفوَّض. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
.
إذا لم يكن هناك خيار استهداف TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
المحدَّد لأحد الموارد، يعني ذلك أنّه يستخدم خيار "البائعون المباشرون والمورّدون المعتمَدون".
تمثيل JSON |
---|
{
"authorizedSellerStatus": enum ( |
الحقول | |
---|---|
authorizedSellerStatus |
النتائج فقط. حالة البائع المفوَّضة المطلوب استهدافها |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
LanguageAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف اللغة الذي تمّ تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_LANGUAGE
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض للغة (على سبيل المثال، "الفرنسية"). |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. يجب أن تحتوي كل خيارات استهداف اللغة المخصَّصة على المورد نفسه على القيمة نفسها لهذا الحقل. |
GeoRegionAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف المنطقة الجغرافية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_GEO_REGION
.
تمثيل JSON |
---|
{
"displayName": string,
"targetingOptionId": string,
"geoRegionType": enum ( |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض للمنطقة الجغرافية (على سبيل المثال، "أونتاريو، كندا"). |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
geoRegionType |
النتائج فقط. نوع استهداف المنطقة الجغرافية. |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
InventorySourceGroupAssignedTargetingOptionDetails
تفاصيل الاستهداف لمجموعة مصادر المستودع الإعلاني ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_INVENTORY_SOURCE_GROUP
.
تمثيل JSON |
---|
{ "inventorySourceGroupId": string } |
الحقول | |
---|---|
inventorySourceGroupId |
مطلوبة. رقم تعريف مجموعة مصادر المستودع يجب أن يشير إلى الحقل |
DigitalContentLabelAssignedTargetingOptionDetails
تفاصيل الاستهداف لتصنيف المحتوى الرقمي ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
.
تمثيل JSON |
---|
{
"excludedTargetingOptionId": string,
"contentRatingTier": enum ( |
الحقول | |
---|---|
excludedTargetingOptionId |
مطلوبة. معرّف تصنيف المحتوى الرقمي المطلوب استبعاده. |
contentRatingTier |
النتائج فقط. الاسم المعروض لفئة تقييم تصنيف المحتوى الرقمي. |
SensitiveCategoryAssignedTargetingOptionDetails
تفاصيل الاستهداف للفئة الحساسة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
.
تمثيل JSON |
---|
{
"excludedTargetingOptionId": string,
"sensitiveCategory": enum ( |
الحقول | |
---|---|
excludedTargetingOptionId |
مطلوبة. رقم تعريف الفئة الحساسة المطلوب استبعادها. |
sensitiveCategory |
النتائج فقط. تعداد مصنِّف المحتوى للفئات الإعلانية الحساسة في "مساحة العرض والفيديو 360" |
ExchangeAssignedTargetingOptionDetails
تفاصيل خيار استهداف Exchange الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_EXCHANGE
.
تمثيل JSON |
---|
{ "targetingOptionId": string } |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
SubExchangeAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف التبادل الفرعي الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_SUB_EXCHANGE
.
تمثيل JSON |
---|
{ "targetingOptionId": string } |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
ThirdPartyVerifierAssignedTargetingOptionDetails
تفاصيل خيار الاستهداف المخصّص لأداة التحقّق التابعة لجهة خارجية ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_THIRD_PARTY_VERIFIER
.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد verifier يمكن استهداف إحدى أدوات التحقّق التابعة لجهة خارجية من أجل فرض حدود أمان العلامة التجارية لمرات الظهور. يمكن أن تكون السمة "verifier " واحدة فقط مما يلي: |
|
adloox |
أداة التحقق من العلامات التجارية التابعة لجهة خارجية -- Adloox. |
doubleVerify |
أداة التحقق من العلامات التجارية التابعة لجهة خارجية -- DoubleCheck. |
integralAdScience |
أداة التحقق من العلامة التجارية التابعة لجهة خارجية -- Integral Ad Science |
Adloox
تفاصيل إعدادات Adloox
تمثيل JSON |
---|
{
"excludedAdlooxCategories": [
enum ( |
الحقول | |
---|---|
excludedAdlooxCategories[] |
إعدادات أمان العلامة التجارية في 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[] |
تجنَّب تقديم عروض أسعار على تطبيقات تحمل التقييم حسب الفئة العمرية. |
appStarRating |
تجنَّب تقديم عروض أسعار على التطبيقات التي تحمل التقييمات بالنجوم. |
displayViewability |
إعدادات إمكانية العرض (ينطبق على عرض العناصر فقط) |
videoViewability |
إعدادات إمكانية عرض الفيديو (تنطبق على عناصر الفيديو فقط) |
fraudInvalidTraffic |
تجنَّب استخدام المواقع الإلكترونية والتطبيقات ذات الأسعار السابقة للاحتيال أو الزيارات غير الصالحة. |
customSegmentId |
رقم تعريف شريحة الجمهور المخصّصة المقدَّم من DoubleCheck. يجب أن يبدأ المعرّف بـ "51" ويتألف من ثمانية أرقام. لا يمكن تحديد رقم تعريف شريحة مخصّصة مع أي من الحقول التالية: |
BrandSafetyCategories
إعدادات عناصر التحكّم في أمان العلامة التجارية
تمثيل JSON |
---|
{ "avoidUnknownBrandSafetyCategory": boolean, "avoidedHighSeverityCategories": [ enum ( |
الحقول | |
---|---|
avoidUnknownBrandSafetyCategory |
غير معروف أو غير قابل للتقييم. |
avoidedHighSeverityCategories[] |
فئات تجنب المخاطر العالية لأمان العلامة التجارية |
avoidedMediumSeverityCategories[] |
فئات الأمان المتوسطة الخطورة لأمان العلامة التجارية |
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 ( |
الحقول | |
---|---|
avoidedStarRating |
تجنَّب تقديم عروض أسعار على التطبيقات التي تحمل التقييمات بالنجوم. |
avoidInsufficientStarRating |
تجنَّب تقديم عروض أسعار للتطبيقات التي لديها تقييمات غير كافية بالنجوم. |
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 |
استهداف مستودع المساحات المتوفّرة للإعلانات على الويب وفي التطبيقات لزيادة نسبة إمكانية العرض إلى أقصى حد وفقًا لمكتب IAB |
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 |
استهداف المستودع على الويب لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) إلى أقصى حد |
videoViewableRate |
استهداف المستودع على الويب لزيادة نسبة العرض الكامل إلى أقصى حد |
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 ( |
الحقول | |
---|---|
avoidedFraudOption |
تجنُّب المواقع الإلكترونية والتطبيقات التي تتضمّن عمليات احتيال أو زيارات غير صالحة ناشئة عن تقنيات معروفة |
avoidInsufficientOption |
إحصاءات غير كافية حول الاحتيال التاريخي وغير ذلك. |
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 ( |
الحقول | |
---|---|
traqScoreOption |
جودة إعلانية حقيقية (ينطبق ذلك على العناصر على الشبكة الإعلانية فقط). |
excludeUnrateable |
أمان العلامة التجارية: غير قابل للتقييم |
excludedAdultRisk |
أمان العلامة التجارية - محتوى البالغين |
excludedAlcoholRisk |
أمان العلامة التجارية: الكحول |
excludedIllegalDownloadsRisk |
أمان العلامة التجارية - عمليات التنزيل غير القانونية |
excludedDrugsRisk |
أمان العلامة التجارية - المخدّرات |
excludedHateSpeechRisk |
أمان العلامة التجارية: الكلام الذي يحض على الكراهية: |
excludedOffensiveLanguageRisk |
أمان العلامة التجارية: لغة مسيئة: |
excludedViolenceRisk |
أمان العلامة التجارية - العنف |
excludedGamblingRisk |
أمان العلامة التجارية - المقامرة |
excludedAdFraudRisk |
إعدادات الإعلانات الاحتيالية |
displayViewability |
قسم "إمكانية العرض على الشبكة الإعلانية" (ينطبق على عرض العناصر فقط) |
videoViewability |
قسم إمكانية عرض الفيديو (ينطبق على عناصر الفيديو فقط) |
customSegmentId[] |
رقم تعريف الشريحة المخصّصة المقدَّم من Integral Ad Science. يجب أن تتراوح قيمة المعرّف بين |
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 ( |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لنقطة الاهتمام، على سبيل المثال "تايمز سكوير"، أو "إبرة الفضاء"، متبوعًا بعنوانها الكامل إذا كان متاحًا. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة يمكن استرداد أرقام تعريف خيارات استهداف نقاط الاهتمام المقبولة باستخدام في حال استهداف إحداثيات خط عرض/خط طول تمت إزالتها من عنوان أو اسم نقطة اهتمام، يمكنك إنشاء رقم تعريف خيار الاستهداف اللازم عن طريق تقريب قيم الإحداثيات المطلوبة إلى الخانة العشرية السادسة، وإزالة الأرقام العشرية، وتسلسل قيم السلسلة المفصولة بفاصلة منقوطة. على سبيل المثال، يمكنك استهداف زوج خط الطول/خط العرض 40.7414691، -74.003387 باستخدام رقم تعريف خيار الاستهداف "40741469;-74003387". |
latitude |
النتائج فقط. إنّ خط عرض نقطة الاهتمام مقرَّب إلى المنزل العشري السادس. |
longitude |
النتائج فقط. خط طول نقطة الاهتمام مقرَّب إلى العلامة العشرية السادسة. |
proximityRadiusAmount |
مطلوبة. نصف قطر المنطقة المحيطة بنقطة الاهتمام التي سيتم استهدافها. يتم تحديد وحدات النطاق الجغرافي من خلال |
proximityRadiusUnit |
مطلوبة. وحدة المسافة التي يتم من خلالها قياس نطاق الاستهداف. |
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 ( |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لسلسلة أنشطة تجارية، مثل "KFC" أو "Chase Bank". |
targetingOptionId |
مطلوبة. تمثّل هذه السمة يمكن استرداد أرقام التعريف المقبولة لخيارات استهداف سلسلة الأنشطة التجارية باستخدام |
proximityRadiusAmount |
مطلوبة. نصف قطر المنطقة المحيطة بسلسلة النشاط التجاري الذي سيتم استهدافه. يتم تحديد وحدات النطاق الجغرافي من خلال |
proximityRadiusUnit |
مطلوبة. وحدة المسافة التي يتم من خلالها قياس نطاق الاستهداف. |
ContentDurationAssignedTargetingOptionDetails
تفاصيل خيار الاستهداف الذي تم تخصيصه لمدّة المحتوى ستتم تعبئة هذه البيانات في الحقل contentDurationDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_DURATION
. استهداف جميع الخيارات بشكل صريح غير متاح. أزل جميع خيارات استهداف مدة المحتوى لتحقيق هذا التأثير.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"contentDuration": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
contentDuration |
النتائج فقط. تمثّل هذه السمة مدة المحتوى. |
ContentStreamTypeAssignedTargetingOptionDetails
تفاصيل حول نوع مصدر المحتوى الذي تم تعيينه لخيار الاستهداف. ستتم تعبئة هذه البيانات في الحقل contentStreamTypeDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_STREAM_TYPE
. استهداف جميع الخيارات بشكل صريح غير متاح. عليك إزالة كل خيارات استهداف نوع ساحة المحتوى لتحقيق هذا التأثير.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"contentStreamType": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
contentStreamType |
النتائج فقط. نوع مجموعة بث المحتوى |
NativeContentPositionAssignedTargetingOptionDetails
تفاصيل خيار الاستهداف الذي تم تعيينه لموضع المحتوى الأصلي ستتم تعبئة هذه البيانات في الحقل nativeContentPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_NATIVE_CONTENT_POSITION
. استهداف جميع الخيارات بشكل صريح غير متاح. لتحقيق هذا التأثير، عليك إزالة جميع خيارات استهداف موضع المحتوى الأصلي.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"contentPosition": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
contentPosition |
موضع المحتوى النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
OmidAssignedTargetingOptionDetails
يُمثِّل هذا النوع مستودعًا إعلانيًا يمكن استهدافه لتفعيل ميزة "القياس المفتوح". ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار Assign المستهدَفOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_OMID
.
تمثيل JSON |
---|
{
"omid": enum ( |
الحقول | |
---|---|
omid |
نوع المستودع الإعلاني المفعَّل فيه القياس المفتوح. النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
targetingOptionId |
مطلوبة. تمثّل هذه السمة |
AudioContentTypeAssignedTargetingOptionDetails
تفاصيل نوع المحتوى الصوتي الذي تم تعيينه لخيار الاستهداف. ستتم تعبئة هذه البيانات في الحقل audioContentTypeDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_AUDIO_CONTENT_TYPE
. استهداف جميع الخيارات بشكل صريح غير متاح. عليك إزالة جميع خيارات استهداف نوع المحتوى الصوتي لتحقيق هذا التأثير.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"audioContentType": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
audioContentType |
نوع المحتوى الصوتي النتائج فقط في الإصدار 1. مطلوبة في الإصدار 2. |
ContentGenreAssignedTargetingOptionDetails
تفاصيل حول نوع المحتوى الذي تم تعيينه لخيار الاستهداف. ستتم تعبئة هذه البيانات في الحقل contentGenreDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_GENRE
. استهداف جميع الخيارات بشكل صريح غير متاح. لتحقيق هذا التأثير، عليك إزالة جميع خيارات استهداف نوع المحتوى.
تمثيل JSON |
---|
{ "targetingOptionId": string, "displayName": string, "negative": boolean } |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
displayName |
النتائج فقط. الاسم المعروض لنوع المحتوى |
negative |
يشير إلى ما إذا كان هذا الخيار مستهدَفًا سلبًا. |
الطُرق |
|
---|---|
|
يتم تعيين خيار استهداف واحد للحملة. |
|
يسرد خيارات الاستهداف المعينة لإحدى الحملات لنوع استهداف محدد. |