- المورد: خيار الاستهداف المحدَّد
- تمثيل JSON
- الاكتساب
- ChannelAssignedTargetingOptionDetails
- AppCategoryAssignedTargetingOptionDetails
- AppAssignedTargetingOptionDetails
- AppPlatform
- UrlAssignedTargetingOptionDetails
- DayAndTimeAssignedTargetingOptionDetails
- DayOfWeek
- TimeZoneResolution
- AgeRangeAssignedTargetingOptionDetails
- RegionalLocationListAssignedTargetingOptionDetails
- ProximityLocationListAssignedTargetingOptionDetails
- ProximityRadiusUnit
- 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
- YoutubeVideoAssignedTargetingOptionDetails
- YoutubeChannelAssignedTargetingOptionDetails
- SessionPositionAssignedTargetingOptionDetails
- SessionPosition
- الطُرق
المرجع: AssignTargetOption
يشير ذلك المصطلح إلى خيار استهداف واحد يحدّد حالة خيار الاستهداف لكيان لديه إعدادات استهداف.
تمثيل JSON |
---|
{ "name": string, "assignedTargetingOptionId": string, "assignedTargetingOptionIdAlias": string, "targetingType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لخيار الاستهداف المعين هذا. |
assignedTargetingOptionId |
النتائج فقط. المعرّف الفريد لخيار الاستهداف الذي تم تعيينه. يكون رقم التعريف فريدًا فقط ضمن نوع استهداف ومورد معيّن. وقد تتم إعادة استخدامه في سياقات أخرى. |
assignedTargetingOptionIdAlias |
النتائج فقط. اسم مستعار للنطاق ستتم إتاحة هذا الحقل فقط لجميع خيارات الاستهداف المعينة لأنواع الاستهداف التالية:
يتوافق هذا الحقل أيضًا مع خيارات الاستهداف المعينة للعنصر المحدد لأنواع الاستهداف التالية:
|
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 |
تفاصيل Exchange. ستتم تعبئة هذا الحقل عندما تكون قيمة |
subExchangeDetails |
تفاصيل التبادل الفرعي ستتم تعبئة هذا الحقل عندما تكون قيمة |
thirdPartyVerifierDetails |
تفاصيل التحقق من الجهة الخارجية. ستتم تعبئة هذا الحقل عندما تكون قيمة |
poiDetails |
تفاصيل نقطة الاهتمام. ستتم تعبئة هذا الحقل عندما تكون قيمة |
businessChainDetails |
تفاصيل سلسلة الأنشطة التجارية ستتم تعبئة هذا الحقل عندما تكون قيمة |
contentDurationDetails |
تفاصيل مدة المحتوى ستتم تعبئة هذا الحقل عندما تكون قيمة |
contentStreamTypeDetails |
تفاصيل مدة المحتوى ستتم تعبئة هذا الحقل عندما يكون نوع الاستهداف |
nativeContentPositionDetails |
تفاصيل موضع المحتوى الأصلي ستتم تعبئة هذا الحقل عندما تكون قيمة |
omidDetails |
افتح تفاصيل المستودع الذي تم تفعيل القياس فيه. ستتم تعبئة هذا الحقل عندما تكون قيمة |
audioContentTypeDetails |
تفاصيل نوع المحتوى الصوتي ستتم تعبئة هذا الحقل عندما تكون قيمة |
contentGenreDetails |
تفاصيل نوع المحتوى ستتم تعبئة هذا الحقل عندما تكون قيمة |
youtubeVideoDetails |
تفاصيل الفيديو على YouTube ستتم تعبئة هذا الحقل عندما تكون قيمة |
youtubeChannelDetails |
تفاصيل القناة على YouTube ستتم تعبئة هذا الحقل عندما تكون قيمة |
sessionPositionDetails |
تفاصيل موضع الجلسة ستتم تعبئة هذا الحقل عندما تكون قيمة |
الاكتساب
يشير إلى ما إذا كان خيار الاستهداف المعيّن مُكتسبًا من كيان مستوى أعلى، مثل شريك أو معلِن. تأتي خيارات الاستهداف المكتسَبة المُكتسَبة لها الأولوية، ودائمًا ما يتم تطبيقها على الاستهداف على مستوى الاستهداف المحدّد في المستوى الحالي ولا يمكن تعديلها من خلال خدمة العنصر الحالية. ويجب تعديلها من خلال خدمة الكيان التي تم اكتسابها منها. لا ينطبق الاكتساب على القنوات المستهدَفة سلبًا، واستبعادات الفئات الإعلانية الحسّاسة، واستبعادات تصنيفات المحتوى الرقمي في حال ضبطها على المستوى الرئيسي.
عمليات التعداد | |
---|---|
INHERITANCE_UNSPECIFIED |
الحالة الموروثة غير محدّدة أو غير معروفة. |
NOT_INHERITED |
خيار الاستهداف المعيّن غير مُكتسب من الكيان ذي المستوى الأعلى. |
INHERITED_FROM_PARTNER |
يتم اكتساب خيار الاستهداف المخصّص من إعدادات استهداف الشركاء. |
INHERITED_FROM_ADVERTISER |
يتم اكتساب خيار الاستهداف المعيّن من إعدادات استهداف المعلنين. |
ChannelAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف القناة الذي تمّ تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_CHANNEL
".
تمثيل JSON |
---|
{ "channelId": string, "negative": boolean } |
الحقول | |
---|---|
channelId |
مطلوبة. معرّف القناة يجب أن يشير إلى حقل معرّف القناة في مرجع قناة يملكها الشريك أو قناة يملكها المعلِن. |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. بالنسبة إلى خيار الاستهداف المخصّص على مستوى المعلِن، يجب أن يكون هذا الحقل صحيحًا. |
AppCategoryAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف فئة التطبيق الذي تم تعيينه ستتم تعبئة هذا الحقل في الحقل appCategoryDetails
ضمن خيار استهداف معيَّن عندما تكون قيمة الحقل targetingType
هي TARGETING_TYPE_APP_CATEGORY
.
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لفئة التطبيق. |
targetingOptionId |
مطلوبة. الحقل |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
AppAssignedTargetingOptionDetails
تفاصيل خيار استهداف التطبيق الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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 |
ومنصة التطبيق هي منصة للتلفزيون المتّصل وغير مُدرَجة صراحةً في مكان آخر. |
APP_PLATFORM_LG_TV |
التطبيق الأساسي للتطبيق هو LG TV. |
APP_PLATFORM_VIZIO_TV |
منصّة التطبيق هي VIZIO TV. |
UrlAssignedTargetingOptionDetails
تفاصيل خيار استهداف عنوان URL الذي تمّ تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_URL
".
تمثيل JSON |
---|
{ "url": string, "negative": boolean } |
الحقول | |
---|---|
url |
مطلوبة. تمثّل هذه السمة عنوان URL، على سبيل المثال تتيح "مساحة العرض والفيديو 360" مستويين من استهداف الأدلة الفرعية، مثل |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
DayAndTimeAssignedTargetingOptionDetails
تمثّل هذه السمة فترة زمنية محدّدة في يوم معيّن من الأسبوع وبوقت بدء وانتهاء. يجب أن يكون الوقت الذي يمثّله startHour
قبل الوقت الذي يمثّله endHour
.
تمثيل JSON |
---|
{ "dayOfWeek": enum ( |
الحقول | |
---|---|
dayOfWeek |
مطلوبة. اليوم من الأسبوع لإعداد استهداف هذا اليوم والوقت. |
startHour |
مطلوبة. ساعة البدء لاستهداف اليوم والوقت. يجب أن تتراوح القيمة بين 0 (بداية اليوم) و23 (قبل ساعة واحدة من نهاية اليوم). |
endHour |
مطلوبة. ساعة النهاية لاستهداف اليوم والوقت. يجب أن تتراوح القيمة بين 1 (ساعة واحدة بعد بدء اليوم) و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
يمثل فئة عمرية قابلة للاستهداف. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_AGE_RANGE
".
تمثيل JSON |
---|
{
"ageRange": enum ( |
الحقول | |
---|---|
ageRange |
مطلوبة. الفئة العمرية للجمهور. لا نتيح إلا استهداف شريحة عمرية مستمرة من الجمهور. وبالتالي، يمكن أن تكون الفئة العمرية الممثلة في هذا الحقل 1) مستهدَفًا فقط أو 2) جزءًا من فئة عمرية أكبر مستمرة. يمكن توسيع مدى وصول استهداف الفئة العمرية المستمرة عن طريق استهداف جمهور من عمر غير معروف أيضًا. |
RegionalLocationListAssignedTargetingOptionDetails
تفاصيل الاستهداف لقائمة المواقع الجغرافية الخاصة بمناطق معيّنة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_REGIONAL_LOCATION_LIST
".
تمثيل JSON |
---|
{ "regionalLocationListId": string, "negative": boolean } |
الحقول | |
---|---|
regionalLocationListId |
مطلوبة. رقم تعريف قائمة المواقع الجغرافية الإقليمية يجب أن تشير إلى الحقل |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
ProximityLocationListAssignedTargetingOptionDetails
تفاصيل الاستهداف لقائمة المواقع الجغرافية القريبة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_PROXIMITY_LOCATION_LIST
".
تمثيل JSON |
---|
{
"proximityLocationListId": string,
"proximityRadius": number,
"proximityRadiusUnit": enum ( |
الحقول | |
---|---|
proximityLocationListId |
مطلوبة. رقم تعريف قائمة المواقع الجغرافية القريبة. يجب أن تشير إلى الحقل |
proximityRadius |
مطلوبة. النطاق الجغرافي الذي يتم التعبير عنه بوحدات المسافة المحدَّدة في |
proximityRadiusUnit |
مطلوبة. وحدات المسافة للنطاق الجغرافي |
ProximityRadiusUnit
تعداد وحدات المسافة لـ ProximityRadius.
عمليات التعداد | |
---|---|
PROXIMITY_RADIUS_UNIT_UNSPECIFIED |
القيمة التلقائية عندما لا يتم تحديد وحدات المسافة في هذا الإصدار. هذا التعداد هو عنصر نائب للقيمة التلقائية ولا يمثل وحدة مسافة حقيقية. |
PROXIMITY_RADIUS_UNIT_MILES |
وحدة مسافة النطاق الجغرافي بالميل |
PROXIMITY_RADIUS_UNIT_KILOMETERS |
وحدة مسافة النطاق الجغرافي بالكيلومتر |
GenderAssignedTargetingOptionDetails
تفاصيل خيار استهداف الجنس الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_GENDER
".
تمثيل JSON |
---|
{
"gender": enum ( |
الحقول | |
---|---|
gender |
مطلوبة. جنس الجمهور. |
VideoPlayerSizeAssignedTargetingOptionDetails
تفاصيل خيارات استهداف حجم مشغّل الفيديو وستتم تعبئة هذا الحقل في الحقل videoPlayerSizeDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_VIDEO_PLAYER_SIZE
. ولا تتوفر ميزة استهداف جميع الخيارات بشكلٍ صريح. ولتحقيق هذا التأثير، أزِل كل خيارات الاستهداف الخاصة بحجم مشغّل الفيديو.
تمثيل JSON |
---|
{
"videoPlayerSize": enum ( |
الحقول | |
---|---|
videoPlayerSize |
مطلوبة. حجم مشغّل الفيديو |
UserRewardedContentAssignedTargetingOptionDetails
تفاصيل خيار استهداف المحتوى الذي يضمّ مكافأة للمستخدم وستتم تعبئة هذا الحقل في الحقل userRewardedContentDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_USER_REWARDED_CONTENT
.
تمثيل JSON |
---|
{
"targetingOptionId": string,
"userRewardedContent": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
userRewardedContent |
النتائج فقط. حالة المحتوى الذي يضم مكافأة للمستخدم في إعلانات الفيديو. |
ParentalStatusAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف الحالة الأبوية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_PARENTAL_STATUS
".
تمثيل JSON |
---|
{
"parentalStatus": enum ( |
الحقول | |
---|---|
parentalStatus |
مطلوبة. الحالة الأبوية للجمهور. |
ContentInstreamPositionAssignedTargetingOptionDetails
تفاصيل خيار استهداف موضع الإعلان أثناء عرض المحتوى للمحتوى المعيّن. وستتم تعبئة هذا الحقل في الحقل contentInstreamPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_INSTREAM_POSITION
.
تمثيل JSON |
---|
{ "contentInstreamPosition": enum ( |
الحقول | |
---|---|
contentInstreamPosition |
مطلوبة. موضع إعلان أثناء عرض المحتوى لإعلانات الفيديو أو الإعلانات الصوتية. |
adType |
النتائج فقط. نوع الإعلان المطلوب استهدافه. لا يسري هذا الخيار إلّا على استهداف طلبات الإدراج والعناصر الجديدة التي تتوافق مع نوع الإعلان المحدّد. وسيكتسب خيار الاستهداف هذا تلقائيًا. القيم المتاحة:
|
AdType
يمثّل نوع تصميم الإعلان المرتبط بالإعلانات.
عمليات التعداد | |
---|---|
AD_TYPE_UNSPECIFIED |
نوع الإعلان غير محدد أو غير معروف في هذا الإصدار. |
AD_TYPE_DISPLAY |
عرض تصميمات الإعلانات، مثل الصور وHTML5 |
AD_TYPE_VIDEO |
تصميمات إعلانات الفيديو، مثل إعلانات الفيديو التي يتم تشغيلها أثناء بث المحتوى في مشغّلات الفيديو |
AD_TYPE_AUDIO |
تصميمات الإعلانات الصوتية، مثل الإعلانات الصوتية التي يتم تشغيلها أثناء عرض المحتوى الصوتي |
ContentOutstreamPositionAssignedTargetingOptionDetails
تفاصيل خيار استهداف موضع الإعلان خارج البث للمحتوى المعيّن. وستتم تعبئة هذا الحقل في الحقل contentOutstreamPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
.
تمثيل JSON |
---|
{ "contentOutstreamPosition": enum ( |
الحقول | |
---|---|
contentOutstreamPosition |
مطلوبة. موضع خارج البث: |
adType |
النتائج فقط. نوع الإعلان المطلوب استهدافه. لا يسري هذا الخيار إلّا على استهداف طلبات الإدراج والعناصر الجديدة التي تتوافق مع نوع الإعلان المحدّد. وسيكتسب خيار الاستهداف هذا تلقائيًا. القيم المتاحة:
|
DeviceTypeAssignedTargetingOptionDetails
تفاصيل الاستهداف لنوع الجهاز ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_DEVICE_TYPE
".
تمثيل JSON |
---|
{
"deviceType": enum ( |
الحقول | |
---|---|
deviceType |
مطلوبة. الاسم المعروض لنوع الجهاز |
youtubeAndPartnersBidMultiplier |
النتائج فقط. يسمح لك مضاعف عروض الأسعار بعرض إعلاناتك لعدد أكبر أو أقل من المرّات بناءً على نوع الجهاز. وسيؤدي ذلك إلى تطبيق مضاعف على سعر عرض السعر الأصلي. عندما يكون هذا الحقل 0، يعني ذلك أنّ هذا الحقل لا ينطبق بدلاً من ضرب 0 في سعر عرض السعر الأصلي. على سبيل المثال، إذا كان سعر عرض السعر بدون المُضاعِف هو 10.0 دولار أمريكي (أو ما يعادله بالعملة المحلية) والمُضاعِف هو 1.5 دولار أمريكي للأجهزة اللوحية، سيكون سعر عرض السعر الناتج للجهاز اللوحي هو 15.0 دولار أمريكي (أو ما يعادله بالعملة المحلّية). ينطبق فقط على عناصر YouTube والشركاء. |
AudienceGroupAssignedTargetingOptionDetails
تفاصيل خيار استهداف مجموعة الجمهور المعينة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_AUDIENCE_GROUP
". العلاقة بين كل مجموعة هي UNION، باستثناء كائن "excludedFirstAndrdParty AudienceGroup" و"excludedGoogle AudienceGroup"، اللذين يتم استخدام "COMPLEMENT" منهما كـ "تتبُّع" مع مجموعات أخرى.
تمثيل JSON |
---|
{ "includedFirstAndThirdPartyAudienceGroups": [ { object ( |
الحقول | |
---|---|
includedFirstAndThirdPartyAudienceGroups[] |
أرقام تعريف جمهور الطرف الأول والطرف الثالث وحالات ورودهما لمجموعات جمهور الطرف الأول والطرف الثالث المضمّنة. تحتوي كل مجموعة جمهور للطرف الأول والطرف الثالث على أرقام تعريف جمهور للطرف الأول والطرف الثالث فقط. العلاقة بين كل مجموعة جمهور تابعة للطرف الأول وأخرى تابعة لطرف ثالث تُقسم إلى انبعاث، والنتيجة هي 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
تفاصيل مجموعة الجمهور المُجمَّعة. تكون جميع إعدادات استهداف الجمهور المجمّعة "أو" مع بعضها البعض منطقيًا.
تمثيل JSON |
---|
{
"settings": [
{
object ( |
الحقول | |
---|---|
settings[] |
مطلوبة. كل إعدادات استهداف الجمهور المجمّع في مجموعة الجمهور المجمّعة. وسيتم تجاهل الإعدادات المتكررة التي تحمل رقم التعريف نفسه. يجب ألا يزيد عدد إعدادات الجمهور المُجمَّع عن خمسة، وإلا سيتم عرض الخطأ. |
CombinedAudienceTargetingSetting
تفاصيل إعداد استهداف الجمهور المُجمَّع.
تمثيل JSON |
---|
{ "combinedAudienceId": string } |
الحقول | |
---|---|
combinedAudienceId |
مطلوبة. رقم تعريف الجمهور المُجمَّع لإعداد استهداف الجمهور المُجمَّع. هذا المعرّف هو |
BrowserAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف المتصفّح الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_BROWSER
".
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. هو الاسم المعروض للمتصفّح. |
targetingOptionId |
مطلوبة. السمة |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. يجب أن تحتوي جميع خيارات استهداف المتصفِّح التي تم تحديدها في المورد نفسه على القيمة نفسها لهذا الحقل. |
HouseholdIncomeAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف دخل الأسرة المحدّد ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_HOUSEHOLD_INCOME
".
تمثيل JSON |
---|
{
"householdIncome": enum ( |
الحقول | |
---|---|
householdIncome |
مطلوبة. دخل الأسرة للجمهور. |
OnScreenPositionAssignedTargetingOptionDetails
تفاصيل خيار استهداف موضع الشاشة على الشاشة. وستتم تعبئة هذا الحقل في الحقل onScreenPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_ON_SCREEN_POSITION
.
تمثيل JSON |
---|
{ "targetingOptionId": string, "onScreenPosition": enum ( |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
onScreenPosition |
النتائج فقط. الموضع على الشاشة. |
adType |
النتائج فقط. نوع الإعلان المطلوب استهدافه. لا يسري هذا الخيار إلّا على استهداف طلبات الإدراج والعناصر الجديدة التي تتوافق مع نوع الإعلان المحدّد. وسيكتسب خيار الاستهداف هذا تلقائيًا. القيم المتاحة:
|
CarrierAndIspAssignedTargetingOptionDetails
تفاصيل حول خيار استهداف مشغّل شبكة الجوّال ومزوّد خدمة الإنترنت المعيّن ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_CARRIER_AND_ISP
".
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لمشغّل شبكة الجوّال أو مزوّد خدمة الإنترنت |
targetingOptionId |
مطلوبة. السمة |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. يجب أن تتضمن كل خيارات استهداف شركات الجوّال ومزوّد خدمة الإنترنت في المورد نفسه القيمة نفسها لهذا الحقل. |
KeywordAssignedTargetingOptionDetails
تفاصيل خيار استهداف الكلمات الرئيسية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_KEYWORD
".
تمثيل JSON |
---|
{ "keyword": string, "negative": boolean } |
الحقول | |
---|---|
keyword |
مطلوبة. الكلمة الرئيسية، على سبيل المثال لا يجوز أن تكون الكلمة الرئيسية الإيجابية كلمة مسيئة. يجب أن يكون ترميز UTF-8 بحجم 255 بايت كحد أقصى. الحد الأقصى لعدد الأحرف هو 80 حرفًا. الحد الأقصى لعدد الكلمات هو 10 كلمات. |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
NegativeKeywordListAssignedTargetingOptionDetails
تفاصيل الاستهداف لقائمة الكلمات الرئيسية السلبية ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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
تفاصيل خيار استهداف البيئة المعيّنة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_ENVIRONMENT
".
تمثيل JSON |
---|
{
"environment": enum ( |
الحقول | |
---|---|
environment |
مطلوبة. تمثّل هذه السمة بيئة العرض. |
InventorySourceAssignedTargetingOptionDetails
تفاصيل الاستهداف لمصدر المستودع ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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
ضمن خيار استهداف معيَّن عندما تكون قيمة الحقل targetingType
هي TARGETING_TYPE_VIEWABILITY
.
تمثيل JSON |
---|
{
"viewability": enum ( |
الحقول | |
---|---|
viewability |
مطلوبة. النسبة المئوية لإمكانية العرض المتوقّعة |
AuthorizedSellerStatusAssignedTargetingOptionDetails
تُمثِّل هذه السمة حالة بائع معتمَدة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
".
إذا لم يتضمن المورد خيار استهداف "TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
"، يعني ذلك أنّه يستخدم خيار "البائعون المباشرون والمورّدون المعتمَدون".
تمثيل JSON |
---|
{
"authorizedSellerStatus": enum ( |
الحقول | |
---|---|
authorizedSellerStatus |
النتائج فقط. تشير هذه السمة إلى حالة البائع المصرّح بها للاستهداف. |
targetingOptionId |
مطلوبة. السمة |
LanguageAssignedTargetingOptionDetails
تفاصيل خيار استهداف اللغة الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_LANGUAGE
".
تمثيل JSON |
---|
{ "displayName": string, "targetingOptionId": string, "negative": boolean } |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض للغة (على سبيل المثال، "الفرنسية"). |
targetingOptionId |
مطلوبة. السمة |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. يجب أن تحتوي كل خيارات استهداف اللغة التي تم تخصيصها في المورد نفسه على القيمة نفسها لهذا الحقل. |
GeoRegionAssignedTargetingOptionDetails
تفاصيل خيار استهداف المنطقة الجغرافية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_GEO_REGION
".
تمثيل JSON |
---|
{
"displayName": string,
"targetingOptionId": string,
"geoRegionType": enum ( |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض للمنطقة الجغرافية (مثل "أونتاريو، كندا"). |
targetingOptionId |
مطلوبة. السمة |
geoRegionType |
النتائج فقط. نوع استهداف المنطقة الجغرافية. |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
InventorySourceGroupAssignedTargetingOptionDetails
تفاصيل الاستهداف لمجموعة مصدر المستودع الإعلاني ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_INVENTORY_SOURCE_GROUP
".
تمثيل JSON |
---|
{ "inventorySourceGroupId": string } |
الحقول | |
---|---|
inventorySourceGroupId |
مطلوبة. رقم تعريف مجموعة مصادر المستودع الإعلاني يجب أن تشير إلى الحقل |
DigitalContentLabelAssignedTargetingOptionDetails
تفاصيل الاستهداف لتصنيف المحتوى الرقمي ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
".
تمثيل JSON |
---|
{
"excludedContentRatingTier": enum ( |
الحقول | |
---|---|
excludedContentRatingTier |
مطلوبة. الاسم المعروض لفئة تقييم تصنيف المحتوى الرقمي المراد استبعاده |
SensitiveCategoryAssignedTargetingOptionDetails
تفاصيل الاستهداف للفئة الإعلانية الحساسة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
".
تمثيل JSON |
---|
{
"excludedSensitiveCategory": enum ( |
الحقول | |
---|---|
excludedSensitiveCategory |
مطلوبة. تعداد لمحتوى الفئة الحساسة في "مساحة العرض والفيديو 360" المصنَّف على أنّه "مستبعد" |
ExchangeAssignedTargetingOptionDetails
تفاصيل خيار استهداف التبادل المعيّن ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_EXCHANGE
".
تمثيل JSON |
---|
{
"exchange": enum ( |
الحقول | |
---|---|
exchange |
مطلوبة. قيمة التعداد للتبادل. |
SubExchangeAssignedTargetingOptionDetails
تفاصيل خيار استهداف التبادل الفرعي الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_SUB_EXCHANGE
".
تمثيل JSON |
---|
{ "targetingOptionId": string } |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. السمة |
ThirdPartyVerifierAssignedTargetingOptionDetails
تفاصيل خيار الاستهداف المخصّص لأداة التحقّق التابعة لجهة خارجية. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_THIRD_PARTY_VERIFIER
".
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد verifier يمكن استهداف إحدى أدوات التحقّق التابعة لجهة خارجية من أجل فرض حدود أمان العلامة التجارية لمرات الظهور. يمكن أن يكون الحقل "verifier " واحدًا فقط مما يلي: |
|
adloox |
أداة التحقق من العلامات التجارية التابعة لجهة خارجية -- Adloox |
doubleVerify |
أداة التحقق من العلامات التجارية التابعة لجهة خارجية -- DoubleVerify. |
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
تفاصيل إعدادات DoubleVerify.
تمثيل JSON |
---|
{ "brandSafetyCategories": { object ( |
الحقول | |
---|---|
brandSafetyCategories |
عناصر التحكّم في أمان العلامة التجارية على DV |
avoidedAgeRatings[] |
تجنَّب تقديم عروض أسعار على تطبيقات تحمل التقييم حسب الفئة العمرية. |
appStarRating |
تجنَّب تقديم عروض أسعار على تطبيقات تحمل التقييمات بالنجوم. |
displayViewability |
إعدادات إمكانية العرض (تنطبق على عرض العناصر فقط) |
videoViewability |
إعدادات إمكانية عرض الفيديو (تنطبق على عناصر الفيديو فقط) |
fraudInvalidTraffic |
يمكنك تجنُّب المواقع الإلكترونية والتطبيقات التي تتضمّن أسعارًا سابقة للاحتيال أو الزيارات غير الصالحة. |
customSegmentId |
رقم تعريف شريحة الجمهور المخصّصة المقدَّم من DoubleVerify. يجب أن يبدأ المعرّف بـ "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
تفاصيل إعدادات إمكانية العرض في DoubleClick Display.
تمثيل 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 |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 75% أو أعلى. |
IAB_VIEWED_RATE_70_PERCENT_HIGHER |
استهدف مستودعًا إعلانيًا على الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 70% أو أعلى. |
IAB_VIEWED_RATE_65_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة% 65 أو أعلى. |
IAB_VIEWED_RATE_60_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 60% أو أعلى. |
IAB_VIEWED_RATE_55_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 55% أو أعلى. |
IAB_VIEWED_RATE_50_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 50% أو أعلى. |
IAB_VIEWED_RATE_40_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 40% أو أعلى. |
IAB_VIEWED_RATE_30_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 30% أو أعلى. |
ViewableDuring
الخيارات الممكنة للمدة القابلة للعرض.
عمليات التعداد | |
---|---|
AVERAGE_VIEW_DURATION_UNSPECIFIED |
هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمتوسط مدة المشاهدة. |
AVERAGE_VIEW_DURATION_5_SEC |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة مدة العرض بنسبة 100% إلى أقصى حد لمدة 5 ثوانٍ أو أكثر. |
AVERAGE_VIEW_DURATION_10_SEC |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة مدة العرض بنسبة 100% إلى أقصى حد تبلغ 10 ثوانٍ أو أكثر. |
AVERAGE_VIEW_DURATION_15_SEC |
استهداف مستودع الإعلانات على الويب وفي التطبيقات لزيادة مدة العرض بنسبة 100% إلى 15 ثانية أو أكثر |
VideoViewability
تفاصيل إعدادات إمكانية عرض الفيديو في DoubleVerify.
تمثيل JSON |
---|
{ "videoIab": enum ( |
الحقول | |
---|---|
videoIab |
استهداف مستودع الإعلانات على الويب لزيادة نسبة IAB القابلة للعرض إلى أقصى حد |
videoViewableRate |
استهداف المستودع الإعلاني على الويب لزيادة نسبة إمكانية العرض بالكامل إلى أقصى حد |
playerImpressionRate |
استهداف المستودع الإعلاني لزيادة مرات الظهور إلى أقصى حد باستخدام حجم مشغّل بحجم 400x300 أو أكبر |
VideoIAB
الخيارات المتاحة لنسبة IAB القابلة للعرض
عمليات التعداد | |
---|---|
VIDEO_IAB_UNSPECIFIED |
هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمعدل العرض القابل للعرض في مكتب IAB. |
IAB_VIEWABILITY_80_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة% 80 أو أعلى. |
IAB_VIEWABILITY_75_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 75% أو أعلى. |
IAB_VIEWABILITY_70_PERCENT_HIGHER |
استهدف مستودعًا إعلانيًا على الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 70% أو أعلى. |
IAB_VIEWABILITY_65_PERCENT_HIHGER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة% 65 أو أعلى. |
IAB_VIEWABILITY_60_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 60% أو أعلى. |
IAB_VIEWABILITY_55_PERCENT_HIHGER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 55% أو أعلى. |
IAB_VIEWABILITY_50_PERCENT_HIGHER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 50% أو أعلى. |
IAB_VIEWABILITY_40_PERCENT_HIHGER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 40% أو أعلى. |
IAB_VIEWABILITY_30_PERCENT_HIHGER |
استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 30% أو أعلى. |
VideoViewableRate
الخيارات الممكنة لنسبة العرض بالكامل
عمليات التعداد | |
---|---|
VIDEO_VIEWABLE_RATE_UNSPECIFIED |
هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمعدل إمكانية عرض الفيديو. |
VIEWED_PERFORMANCE_40_PERCENT_HIGHER |
استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض بالكامل بنسبة 40% أو أعلى. |
VIEWED_PERFORMANCE_35_PERCENT_HIGHER |
استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 35% أو أعلى. |
VIEWED_PERFORMANCE_30_PERCENT_HIGHER |
استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 30% أو أعلى. |
VIEWED_PERFORMANCE_25_PERCENT_HIGHER |
استهدف مستودعًا على الويب لزيادة نسبة إمكانية العرض بالكامل بنسبة 25% أو أعلى. |
VIEWED_PERFORMANCE_20_PERCENT_HIGHER |
استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 20% أو أعلى. |
VIEWED_PERFORMANCE_10_PERCENT_HIGHER |
استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 10% أو أعلى. |
PlayerImpressionRate
الخيارات المحتملة لمرات الظهور.
عمليات التعداد | |
---|---|
PLAYER_SIZE_400X300_UNSPECIFIED |
هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمرات الظهور. |
PLAYER_SIZE_400X300_95 |
المواقع التي حققت أكثر من 95%من مرات الظهور. |
PLAYER_SIZE_400X300_70 |
المواقع التي حققت أكثر من 70%من مرات الظهور. |
PLAYER_SIZE_400X300_25 |
المواقع التي يزيد عدد مرات ظهورها عن 25%. |
PLAYER_SIZE_400X300_5 |
المواقع التي يزيد عدد مرات ظهورها عن 5%. |
FraudInvalidTraffic
إعدادات DoubleClick Search لالاحتيال والزيارات غير الصالحة
تمثيل JSON |
---|
{
"avoidedFraudOption": enum ( |
الحقول | |
---|---|
avoidedFraudOption |
تجنَّب المواقع الإلكترونية والتطبيقات التي تتضمّن عمليات احتيال سابقة أو الزيارات غير الصالحة. |
avoidInsufficientOption |
إحصاءات غير كافية حول الاحتيال والزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT) |
FraudOption
الخيارات المتاحة للمعدّل السابق للاحتيال والإحالات الناجحة غير الصالحة (IVT)
عمليات التعداد | |
---|---|
FRAUD_UNSPECIFIED |
وهذا التعداد هو مجرد عنصر نائب ولا يحدّد أي خيارات للاحتيال أو الزيارات غير الصالحة. |
AD_IMPRESSION_FRAUD_100 |
الاحتيال ونسبة الزيارات غير الصالحة بالكامل |
AD_IMPRESSION_FRAUD_50 |
50% أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT). |
AD_IMPRESSION_FRAUD_25 |
%25 أو عمليات احتيال أو زيارات غير صالحة ناشئة عن تقنيات معروفة (IVT). |
AD_IMPRESSION_FRAUD_10 |
10% أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT). |
AD_IMPRESSION_FRAUD_8 |
8% أو ارتفاع نسبة الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT) |
AD_IMPRESSION_FRAUD_6 |
6% أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT) |
AD_IMPRESSION_FRAUD_4 |
4% أو ارتفاع نسبة الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT). |
AD_IMPRESSION_FRAUD_2 |
زيادة بنسبة% 2 أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT). |
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 1,000 |
للبالغين
الخيارات المحتملة للبالغين في 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 |
العنف: استبعاد المخاطر العالية والمعتدلة |
المقامرة
خيارات المقامرة الممكنة في علوم الإعلانات المتكاملة.
عمليات التعداد | |
---|---|
GAMBLING_UNSPECIFIED |
هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي خيارات للمقامرة. |
GAMBLING_HR |
المقامرة - استبعاد المخاطر العالية |
GAMBLING_HMR |
المقامرة - استبعاد المخاطر العالية والمعتدلة. |
AdFraudPrevention
خيارات منع الاحتيال في إعلانات Integral Ad Science المحتملة
عمليات التعداد | |
---|---|
SUSPICIOUS_ACTIVITY_UNSPECIFIED |
هذا التعداد هو مجرد عنصر نائب ولا يحدِّد أي خيارات لمنع الاحتيال الإعلاني. |
SUSPICIOUS_ACTIVITY_HR |
الاحتيال الإعلاني - استبعاد المخاطر العالية |
SUSPICIOUS_ACTIVITY_HMR |
الاحتيال الإعلاني: استبعاد المخاطر العالية والمعتدلة |
DisplayViewability
خيارات إمكانية عرض العرض في Integral Ad Science المحتملة.
عمليات التعداد | |
---|---|
PERFORMANCE_VIEWABILITY_UNSPECIFIED |
هذا التعداد هو فقط عنصر نائب ولا يحدِّد أي خيارات لإمكانية العرض. |
PERFORMANCE_VIEWABILITY_40 |
استهداف إمكانية العرض بنسبة% 40 أو معدّل أعلى |
PERFORMANCE_VIEWABILITY_50 |
استهداف إمكانية العرض بنسبة 50% أو أعلى: |
PERFORMANCE_VIEWABILITY_60 |
يمكنك استهداف إمكانية العرض بنسبة% 60 أو قيمة أعلى. |
PERFORMANCE_VIEWABILITY_70 |
يمكنك استهداف إمكانية العرض بنسبة% 70 أو معدّل أعلى. |
VideoViewability
خيارات إمكانية عرض الفيديو المحتملة من Integral Ad Science
عمليات التعداد | |
---|---|
VIDEO_VIEWABILITY_UNSPECIFIED |
هذا التعداد هو فقط عنصر نائب ولا يحدد أي خيارات لإمكانية عرض الفيديو. |
VIDEO_VIEWABILITY_40 |
+40%في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB). |
VIDEO_VIEWABILITY_50 |
نسبة%50 أو أكثر في العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB). |
VIDEO_VIEWABILITY_60 |
+60%في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB) |
VIDEO_VIEWABILITY_70 |
+70%في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB). |
PoiAssignedTargetingOptionDetails
تفاصيل خيار استهداف نقطة الاهتمام الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_POI
".
تمثيل JSON |
---|
{
"displayName": string,
"targetingOptionId": string,
"latitude": number,
"longitude": number,
"proximityRadiusAmount": number,
"proximityRadiusUnit": enum ( |
الحقول | |
---|---|
displayName |
النتائج فقط. الاسم المعروض لنقطة الاهتمام، مثل "تايمز سكوير" أو "الإبرة الفضائية"، متبوعًا بعنوانها الكامل إن توفّر. |
targetingOptionId |
مطلوبة. السمة يمكن استرداد أرقام تعريف خيارات استهداف نقاط الاهتمام المقبولة باستخدام في حال استهداف إحداثيات خط طول/خط عرض معيّنة تمت إزالتها من عنوان أو اسم نقطة اهتمام، يمكنك إنشاء رقم تعريف خيار الاستهداف اللازم من خلال تقريب قيم الإحداثيات المطلوبة إلى الخانة العشرية السادسة وإزالة الكسور العشرية وتسلسل قيم السلسلة مفصولة بفاصلة منقوطة. على سبيل المثال، يمكنك استهداف زوج خطوط الطول/العرض لـ 40.7414691، -74.003387 باستخدام معرّف خيار الاستهداف "40741469;-74003387". عند الإنشاء، سيتم تعديل قيمة الحقل هذه لإلحاق فاصلة منقوطة وقيمة تجزئة أبجدية رقمية في حال تقديم إحداثيات خط العرض/خط الطول فقط. |
latitude |
النتائج فقط. يتم تقريب خط عرض نقطة الاهتمام إلى الموضع العشري السادس. |
longitude |
النتائج فقط. يتم تقريب خط طول نقطة الاهتمام إلى الموضع العشري السادس. |
proximityRadiusAmount |
مطلوبة. نصف قطر المنطقة المحيطة بنقطة الاهتمام التي سيتم استهدافها. يتم تحديد وحدات النطاق الجغرافي بواسطة |
proximityRadiusUnit |
مطلوبة. وحدة المسافة التي يتم من خلالها قياس نطاق الاستهداف. |
DistanceUnit
الخيارات المحتملة لوحدة المسافة.
عمليات التعداد | |
---|---|
DISTANCE_UNIT_UNSPECIFIED |
لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار. |
DISTANCE_UNIT_MILES |
اميال. |
DISTANCE_UNIT_KILOMETERS |
كيلومترات. |
BusinessChainAssignedTargetingOptionDetails
تفاصيل لخيار استهداف سلسلة الأنشطة التجارية المحدّد ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_BUSINESS_CHAIN
".
تمثيل JSON |
---|
{
"displayName": string,
"targetingOptionId": string,
"proximityRadiusAmount": number,
"proximityRadiusUnit": enum ( |
الحقول | |
---|---|
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 |
---|
{
"contentPosition": enum ( |
الحقول | |
---|---|
contentPosition |
مطلوبة. موضع المحتوى |
OmidAssignedTargetingOptionDetails
يُمثِّل ذلك نوع مستودع تمّ تفعيل ميزة "القياس المفتوح" عليه ويمكن استهدافه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType
" مضبوطة على "TARGETING_TYPE_OMID
".
تمثيل JSON |
---|
{
"omid": enum ( |
الحقول | |
---|---|
omid |
مطلوبة. نوع المستودع الإعلاني المفعَّل فيه ميزة "القياس المفتوح". |
AudioContentTypeAssignedTargetingOptionDetails
تفاصيل نوع المحتوى الصوتي الذي تم تخصيص خيار الاستهداف له. وستتم تعبئة هذا الحقل في الحقل audioContentTypeDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_AUDIO_CONTENT_TYPE
. ولا تتوفر ميزة استهداف جميع الخيارات بشكلٍ صريح. أزِل جميع خيارات استهداف أنواع المحتوى الصوتي لتحقيق هذا التأثير.
تمثيل JSON |
---|
{
"audioContentType": enum ( |
الحقول | |
---|---|
audioContentType |
مطلوبة. نوع المحتوى الصوتي |
ContentGenreAssignedTargetingOptionDetails
تفاصيل حول نوع المحتوى الذي تم تعيينه لخيار الاستهداف. وستتم تعبئة هذا الحقل في الحقل contentGenreDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_GENRE
. ولا تتوفر ميزة استهداف جميع الخيارات بشكلٍ صريح. لتحقيق هذا التأثير، عليك إزالة جميع خيارات استهداف نوع المحتوى.
تمثيل JSON |
---|
{ "targetingOptionId": string, "displayName": string, "negative": boolean } |
الحقول | |
---|---|
targetingOptionId |
مطلوبة. الحقل |
displayName |
النتائج فقط. الاسم المعروض لنوع المحتوى. |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
YoutubeVideoAssignedTargetingOptionDetails
تفاصيل خيار الاستهداف المعيّن للفيديو على YouTube وستتم تعبئة هذا الحقل في الحقل youtubeVideoDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_YOUTUBE_VIDEO
.
تمثيل JSON |
---|
{ "videoId": string, "negative": boolean } |
الحقول | |
---|---|
videoId |
معرّف فيديو YouTube كما يظهر على صفحة المشاهدة على YouTube. |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
YoutubeChannelAssignedTargetingOptionDetails
تفاصيل قناة YouTube التي تم تعيين خيار الاستهداف لها. وستتم تعبئة هذا الحقل في الحقل youtubeChannelDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_YOUTUBE_CHANNEL
.
تمثيل JSON |
---|
{ "channelId": string, "negative": boolean } |
الحقول | |
---|---|
channelId |
معرّف قناة القائم بالتحميل على YouTube أو رمز القناة الخاص بقناة على YouTube. |
negative |
يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي. |
SessionPositionAssignedTargetingOptionDetails
تفاصيل خيار الاستهداف الذي تم تعيينه لموضع الجلسة. وستتم تعبئة هذا الحقل في الحقل sessionPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_SESSION_POSITION
.
تمثيل JSON |
---|
{
"sessionPosition": enum ( |
الحقول | |
---|---|
sessionPosition |
تمثّل هذه السمة الموضع الذي سيظهر فيه الإعلان في جلسة معيّنة. |
SessionPosition
المواضع المحتملة في الجلسة.
عمليات التعداد | |
---|---|
SESSION_POSITION_UNSPECIFIED |
هذا عنصر نائب، ولا يشير إلى أي مواضع. |
SESSION_POSITION_FIRST_IMPRESSION |
الانطباع الأول عن الجلسة. |
الطُرق |
|
---|---|
|
يحصل على خيار استهداف واحد يتم تعيينه لمجموعة إعلانية. |
|
يسرد خيارات الاستهداف التي تمّ تعيينها لمجموعة إعلانية. |