- المورد: TargetingOption
- DigitalContentLabelTargetingOptionDetails
- SensitiveCategoryTargetingOptionDetails
- AppCategoryTargetingOptionDetails
- OnScreenPositionTargetingOptionDetails
- ContentOutstreamPositionTargetingOptionDetails
- ContentInstreamPositionTargetingOptionDetails
- VideoPlayerSizeTargetingOptionDetails
- AgeRangeTargetingOptionDetails
- ParentalStatusTargetingOptionDetails
- UserRewardedContentTargetingOptionDetails
- HouseholdIncomeTargetingOptionDetails
- GenderTargetingOptionDetails
- DeviceTypeTargetingOptionDetails
- BrowserTargetingOptionDetails
- CarrierAndIspTargetingOptionDetails
- CarrierAndIspType
- EnvironmentTargetingOptionDetails
- OperatingSystemTargetingOptionDetails
- DeviceMakeModelTargetingOptionDetails
- ViewabilityTargetingOptionDetails
- CategoryTargetingOptionDetails
- LanguageTargetingOptionDetails
- AuthorizedSellerStatusTargetingOptionDetails
- GeoRegionTargetingOptionDetails
- ExchangeTargetingOptionDetails
- SubExchangeTargetingOptionDetails
- PoiTargetingOptionDetails
- BusinessChainTargetingOptionDetails
- ContentDurationTargetingOptionDetails
- ContentStreamTypeTargetingOptionDetails
- NativeContentPositionTargetingOptionDetails
- OmidTargetingOptionDetails
- AudioContentTypeTargetingOptionDetails
- ContentGenreTargetingOptionDetails
- الطُرق
المورد: TargetingOption
يمثّل خيار استهداف واحدًا، وهو مفهوم قابل للاستهداف في "مساحة العرض والفيديو 360".
تمثيل JSON |
---|
{ "name": string, "targetingOptionId": string, "targetingType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المرجع لخيار الاستهداف هذا. |
targeting |
النتائج فقط. معرّف فريد لخيار الاستهداف هذا يكون الصف { |
targeting |
النتائج فقط. نوع خيار الاستهداف هذا. |
حقل الربط details معلومات تفصيلية عن خيارات الاستهداف يمكن ملء حقل واحد فقط في التفاصيل، ويجب أن يكون مطابقًا targeting_type . يمكن أن يكون details واحدًا فقط مما يلي: |
|
digital |
تفاصيل تصنيف المحتوى الرقمي |
sensitive |
تفاصيل الفئة الإعلانية الحساسة |
app |
تفاصيل فئة التطبيق. |
on |
تفاصيل موضع الإعلان على الشاشة |
content |
تفاصيل موضع الإعلانات أثناء عرض المحتوى |
content |
تفاصيل موضع الإعلانات أثناء عرض المحتوى |
video |
تفاصيل حجم مشغّل الفيديو |
age |
تفاصيل الفئة العمرية |
parental |
تفاصيل الحالة الأبوية |
user |
تفاصيل المحتوى الذي يقدّم مكافآت للمستخدمين |
household |
تفاصيل دخل الأسرة |
gender |
تفاصيل الجنس |
device |
تفاصيل نوع الجهاز |
browser |
تفاصيل المتصفّح |
carrier |
تفاصيل مشغّل شبكة الجوّال ومزوّد خدمة الإنترنت |
environment |
تفاصيل البيئة |
operating |
تفاصيل موارد نظام التشغيل |
device |
تفاصيل مرجع العلامة التجارية للجهاز وطرازه |
viewability |
تفاصيل مرجع مدى الرؤية |
category |
تفاصيل مَراجع الفئة |
language |
تفاصيل المرجع اللغوي |
authorized |
تفاصيل مرجع حالة البائع المعتمَد |
geo |
تفاصيل موارد المنطقة الجغرافية |
exchange |
تفاصيل الاستبدال |
sub |
تفاصيل التبادل الفرعي |
poi |
تفاصيل مرجع نقاط الاهتمام |
business |
تفاصيل مرجع سلسلة الأنشطة التجارية |
content |
تفاصيل مرجع مدة المحتوى |
content |
تفاصيل مورد نوع مصدر المحتوى |
native |
تفاصيل موضع المحتوى الأصلي |
omid |
تفاصيل المستودع التي تم تفعيل ميزة "القياس المفتوح" فيها |
audio |
تفاصيل نوع المحتوى الصوتي |
content |
تفاصيل مرجع نوع المحتوى |
DigitalContentLabelTargetingOptionDetails
تمثّل فئة تقييم تصنيف المحتوى الرقمي التي يمكن استهدافها. سيتمّ ملء هذا الحقل في digitalContentLabelDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
.
تمثيل JSON |
---|
{
"contentRatingTier": enum ( |
الحقول | |
---|---|
content |
النتائج فقط. قائمة أرقام مميزة لمستويات ملاءمة المحتوى للعلامات التجارية |
SensitiveCategoryTargetingOptionDetails
يمثّل فئة حساسة يمكن استهدافها. سيتمّ ملء هذا الحقل في sensitiveCategoryDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
.
تمثيل JSON |
---|
{
"sensitiveCategory": enum ( |
الحقول | |
---|---|
sensitive |
النتائج فقط. قائمة أرقام متسلسلة لمصنّف المحتوى في فئة "المحتوى الحسّاس" في "مساحة العرض والفيديو 360" |
AppCategoryTargetingOptionDetails
يمثّل مجموعة تطبيقات يمكن استهدافها. تتيح لك المجموعة استهداف مجموعات ديناميكية من التطبيقات ذات الصلة التي تديرها المنصة، مثل All Apps/Google Play/Games
. ستتم تعبئة هذا الحقل في الحقل appCategoryDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_APP_CATEGORY
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. اسم مجموعة التطبيقات. |
OnScreenPositionTargetingOptionDetails
يمثّل موضعًا قابلاً للاستهداف على الشاشة، ويمكن أن تستخدمه الإعلانات الصورية وإعلانات الفيديو. سيتم ملء هذا الحقل onScreenPositionDetails
عندما يكون targetingType
هو TARGETING_TYPE_ON_SCREEN_POSITION
.
تمثيل JSON |
---|
{
"onScreenPosition": enum ( |
الحقول | |
---|---|
on |
النتائج فقط. موضع العنصر على الشاشة |
ContentOutstreamPositionTargetingOptionDetails
تمثّل موضع إعلان قابل للاستهداف خارج الفيديو، ويمكن أن تستخدمه الإعلانات الصورية وإعلانات الفيديو. ستتم تعبئة هذا الحقل في الحقل contentOutstreamPositionDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
.
تمثيل JSON |
---|
{
"contentOutstreamPosition": enum ( |
الحقول | |
---|---|
content |
النتائج فقط. موضع الإعلان خارج البثّ |
ContentInstreamPositionTargetingOptionDetails
تمثّل موضعًا قابلاً للاستهداف أثناء عرض المحتوى، ويمكن أن تستخدمه إعلانات الفيديو والإعلانات الصوتية. سيتم ملء هذا الحقل contentInstreamPositionDetails
عندما يكون targetingType
هو TARGETING_TYPE_CONTENT_INSTREAM_POSITION
.
تمثيل JSON |
---|
{
"contentInstreamPosition": enum ( |
الحقول | |
---|---|
content |
النتائج فقط. موضع الإعلان أثناء عرض المحتوى |
VideoPlayerSizeTargetingOptionDetails
تمثل هذه السمة حجم مشغّل فيديو قابل للاستهداف. سيتم ملء هذا الحقل videoPlayerSizeDetails
عندما يكون targetingType
هو TARGETING_TYPE_VIDEO_PLAYER_SIZE
.
تمثيل JSON |
---|
{
"videoPlayerSize": enum ( |
الحقول | |
---|---|
video |
النتائج فقط. حجم مشغّل الفيديو |
AgeRangeTargetingOptionDetails
تمثّل فئة عمرية يمكن استهدافها. سيتم ملء هذا الحقل ageRangeDetails
عندما يكون targetingType
هو TARGETING_TYPE_AGE_RANGE
.
تمثيل JSON |
---|
{
"ageRange": enum ( |
الحقول | |
---|---|
age |
النتائج فقط. الفئة العمرية للجمهور. |
ParentalStatusTargetingOptionDetails
تمثّل حالة أبوية يمكن استهدافها. ستتم تعبئة هذا الحقل في الحقل parentalStatusDetails
ضمن TargetOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_PARENTAL_STATUS
.
تمثيل JSON |
---|
{
"parentalStatus": enum ( |
الحقول | |
---|---|
parental |
النتائج فقط. الحالة الأبوية لشريحة جمهور معيّنة. |
UserRewardedContentTargetingOptionDetails
تمثّل حالة المحتوى الذي يحصل المستخدمون على مكافأة مقابل مشاهدته، ويمكن استهدافه في إعلانات الفيديو فقط. سيتم ملء هذا الحقل userRewardedContentDetails
عندما يكون targetingType
هو TARGETING_TYPE_USER_REWARDED_CONTENT
.
تمثيل JSON |
---|
{
"userRewardedContent": enum ( |
الحقول | |
---|---|
user |
النتائج فقط. حالة المحتوى الذي يحصل عليه المستخدمون مكافأة في إعلانات الفيديو. |
HouseholdIncomeTargetingOptionDetails
يمثّل دخل أسرة يمكن استهدافه. ستتم تعبئة هذا الحقل في الحقل householdIncomeDetails
ضمن TargetOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_HOUSEHOLD_INCOME
.
تمثيل JSON |
---|
{
"householdIncome": enum ( |
الحقول | |
---|---|
household |
النتائج فقط. دخل الأسرة لشريحة جمهور معيّنة. |
GenderTargetingOptionDetails
تمثل جنسًا قابلاً للاستهداف. سيتمّ ملء هذا الحقل في genderDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_GENDER
.
تمثيل JSON |
---|
{
"gender": enum ( |
الحقول | |
---|---|
gender |
النتائج فقط. جنس شريحة الجمهور |
DeviceTypeTargetingOptionDetails
يمثّل نوع جهاز قابل للاستهداف. سيتمّ ملء هذا الحقل في deviceTypeDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_DEVICE_TYPE
.
تمثيل JSON |
---|
{
"deviceType": enum ( |
الحقول | |
---|---|
device |
النتائج فقط. نوع الجهاز المستخدَم للاستهداف. |
BrowserTargetingOptionDetails
يمثّل متصفّحًا قابلاً للاستهداف. سيتم ملء هذا الحقل browserDetails
عندما يكون targetingType
هو TARGETING_TYPE_BROWSER
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض للمتصفّح |
CarrierAndIspTargetingOptionDetails
يمثل مشغِّل شبكة جوّال أو مزوّد خدمة إنترنت قابل للاستهداف. سيتمّ ملء هذا الحقل في carrierAndIspDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_CARRIER_AND_ISP
.
تمثيل JSON |
---|
{
"displayName": string,
"type": enum ( |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض لمشغّل شبكة الجوّال أو مزوّد خدمة الإنترنت |
type |
النتائج فقط. النوع الذي يشير إلى ما إذا كان مشغل شبكة الجوال أو مزوّد خدمة الإنترنت |
CarrierAndIspType
نوع CarrierAndIspTargetingOption
عمليات التعداد | |
---|---|
CARRIER_AND_ISP_TYPE_UNSPECIFIED |
القيمة التلقائية عندما يكون النوع غير محدّد أو غير معروف في هذا الإصدار. |
CARRIER_AND_ISP_TYPE_ISP |
يشير إلى أن مورد الاستهداف هذا يشير إلى مزود خدمة الإنترنت (ISP). |
CARRIER_AND_ISP_TYPE_CARRIER |
يشير إلى أنّ مرجع الاستهداف هذا يشير إلى مشغّل شبكة جوّال. |
EnvironmentTargetingOptionDetails
تمثّل بيئة يمكن استهدافها. سيتمّ ملء هذا الحقل في environmentDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_ENVIRONMENT
.
تمثيل JSON |
---|
{
"environment": enum ( |
الحقول | |
---|---|
environment |
النتائج فقط. بيئة الخدمة |
OperatingSystemTargetingOptionDetails
يمثّل نظام تشغيل قابلاً للاستهداف. ستتم تعبئة هذا الحقل في الحقل operatingSystemDetails
ضمن TargetOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_OPERATING_SYSTEM
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض لنظام التشغيل |
DeviceMakeModelTargetingOptionDetails
يمثّل طراز الجهاز ونوع الجهاز المستهدَفَين. سيتمّ ملء هذا الحقل في deviceMakeModelDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_DEVICE_MAKE_MODEL
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض للعلامة التجارية للجهاز وطرازه |
ViewabilityTargetingOptionDetails
تمثّل إمكانية عرض قابلة للاستهداف. ستتم تعبئة هذا الحقل في الحقل viewabilityDetails
ضمن TargetOption عندما تكون قيمة targetingType
هي TARGETING_TYPE_VIEWABILITY
.
تمثيل JSON |
---|
{
"viewability": enum ( |
الحقول | |
---|---|
viewability |
النتائج فقط. النسبة المئوية المتوقّعة لإمكانية العرض |
CategoryTargetingOptionDetails
تمثّل فئة يمكن استهدافها. سيتمّ ملء هذا الحقل في categoryDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_CATEGORY
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض للفئة. |
LanguageTargetingOptionDetails
تمثّل لغة يمكن استهدافها. سيتم ملء هذا الحقل languageDetails
عندما يكون targetingType
هو TARGETING_TYPE_LANGUAGE
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض للّغة (مثل "الفرنسية"). |
AuthorizedSellerStatusTargetingOptionDetails
تمثّل حالة بائع معتمَد يمكن استهدافه. سيتم ملء هذا الحقل authorizedSellerStatusDetails
عندما يكون targetingType
هو TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
.
تمثيل JSON |
---|
{
"authorizedSellerStatus": enum ( |
الحقول | |
---|---|
authorized |
النتائج فقط. حالة البائع المعتمَد |
GeoRegionTargetingOptionDetails
تمثّل منطقة جغرافية قابلة للاستهداف. سيتم ملء هذا الحقل geoRegionDetails
عندما يكون targetingType
هو TARGETING_TYPE_GEO_REGION
.
تمثيل JSON |
---|
{
"displayName": string,
"geoRegionType": enum ( |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض للمنطقة الجغرافية (مثل "أونتاريو، كندا"). |
geo |
النتائج فقط. نوع استهداف المنطقة الجغرافية |
ExchangeTargetingOptionDetails
تمثّل تبادلاً قابلاً للاستهداف. سيتمّ ملء هذا الحقل في exchangeDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_EXCHANGE
.
تمثيل JSON |
---|
{
"exchange": enum ( |
الحقول | |
---|---|
exchange |
النتائج فقط. نوع عملية الصرف |
SubExchangeTargetingOptionDetails
تمثّل بورصة فرعية يمكن استهدافها. سيتمّ ملء هذا الحقل في subExchangeDetails
من TargetingOption عندما يكون targetingType
هو TARGETING_TYPE_SUB_EXCHANGE
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض للتبادل الفرعي. |
PoiTargetingOptionDetails
يمثّل نقطة اهتمام قابلة للاستهداف. سيتم ملء هذا الحقل poiDetails
عندما يكون targetingType
هو TARGETING_TYPE_POI
.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number, "displayName": string } |
الحقول | |
---|---|
latitude |
النتائج فقط. خط العرض لنقطة الاهتمام مع التقريب إلى أقرب منزلة عشرية سادسة |
longitude |
النتائج فقط. خط طول نقطة الاهتمام مع تقريبها إلى المنزل العشري السادس. |
display |
النتائج فقط. الاسم المعروض لنقطة الاهتمام(مثل "ميدان التايمز" أو "إبرة الفضاء")، متبوعًا بعنوانها الكامل إن توفّر |
BusinessChainTargetingOptionDetails
يمثّل سلسلة أنشطة تجارية قابلة للاستهداف ضمن منطقة جغرافية. سيتم ملء هذا الحقل businessChainDetails
عندما يكون targetingType
هو TARGETING_TYPE_BUSINESS_CHAIN
.
تمثيل JSON |
---|
{
"businessChain": string,
"geoRegion": string,
"geoRegionType": enum ( |
الحقول | |
---|---|
business |
النتائج فقط. الاسم المعروض لسلسلة النشاط التجاري، مثل "KFC" أو "مصرف Chase". |
geo |
النتائج فقط. الاسم المعروض للمنطقة الجغرافية، مثل "أونتاريو، كندا" |
geo |
النتائج فقط. نوع المنطقة الجغرافية |
ContentDurationTargetingOptionDetails
يمثّل مدة محتوى قابل للاستهداف. سيتم ملء هذا الحقل contentDurationDetails
عندما يكون targetingType
هو TARGETING_TYPE_CONTENT_DURATION
.
تمثيل JSON |
---|
{
"contentDuration": enum ( |
الحقول | |
---|---|
content |
النتائج فقط. مدة المحتوى |
ContentStreamTypeTargetingOptionDetails
تمثّل نوع مجموعة بث محتوى يمكن استهدافه. ستتم تعبئة هذا الحقل في الحقل contentStreamTypeDetails
عندما تكون قيمة targetingType
هي TARGETING_TYPE_CONTENT_STREAM_TYPE
.
تمثيل JSON |
---|
{
"contentStreamType": enum ( |
الحقول | |
---|---|
content |
النتائج فقط. نوع مجموعة بث المحتوى |
NativeContentPositionTargetingOptionDetails
تمثّل موضع إعلان قابل للاستهداف في المحتوى. سيتم ملء هذا الحقل nativeContentPositionDetails
عندما يكون targetingType
هو TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
تمثيل JSON |
---|
{
"contentPosition": enum ( |
الحقول | |
---|---|
content |
النتائج فقط. موضع المحتوى |
OmidTargetingOptionDetails
يمثّل نوع مستودع إعلاني قابل للاستهداف ومفعّل فيه قياس الأداء المفتوح. سيتم ملء هذا الحقل omidDetails
عندما يكون targetingType
هو TARGETING_TYPE_OMID
.
تمثيل JSON |
---|
{
"omid": enum ( |
الحقول | |
---|---|
omid |
النتائج فقط. نوع المستودع الإعلاني الذي تم تفعيل ميزة "القياس المفتوح" فيه. |
AudioContentTypeTargetingOptionDetails
يمثّل هذا النوع نوع محتوى صوتيًا قابلاً للاستهداف. سيتم ملء هذا الحقل audioContentTypeDetails
عندما يكون targetingType
هو TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
تمثيل JSON |
---|
{
"audioContentType": enum ( |
الحقول | |
---|---|
audio |
النتائج فقط. نوع المحتوى الصوتي |
ContentGenreTargetingOptionDetails
تمثّل نوع محتوى يمكن استهدافه. سيتم ملء هذا الحقل contentGenreDetails
عندما يكون targetingType
هو TARGETING_TYPE_CONTENT_GENRE
.
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
display |
النتائج فقط. الاسم المعروض لنوع المحتوى |
الطُرق |
|
---|---|
|
يتوفر خيار استهداف واحد. |
|
يسرد خيارات الاستهداف من نوع معيّن. |
|
يبحث عن خيارات استهداف من نوع معيّن استنادًا إلى عبارات البحث المحدّدة. |