REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

المورد: AssignTargetOption

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

تمثيل JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
الحقول
name

string

النتائج فقط. اسم المورد لخيار الاستهداف المعيّن هذا.

assignedTargetingOptionId

string

النتائج فقط. المعرّف الفريد لخيار الاستهداف المعيّن. رقم التعريف فريد فقط ضمن نوع معيّن من الموارد ونوع الاستهداف. وقد يُعاد استخدامه في سياقات أخرى.

assignedTargetingOptionIdAlias

string

النتائج فقط. الاسم المستعار لـ assignedTargetingOptionId. يمكن استخدام هذه القيمة بدلاً من assignedTargetingOptionId عند استرداد الاستهداف الحالي أو حذفه.

لن يكون هذا الحقل متاحًا إلا لجميع خيارات الاستهداف المحدّدة لأنواع الاستهداف التالية:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

هذا الحقل متاح أيضًا لخيارات الاستهداف المعيَّنة لتفاصيل الإعلان لأنواع الاستهداف التالية:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

النتائج فقط. يحدد نوع خيار الاستهداف المعيّن هذا.

inheritance

enum (Inheritance)

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

حقل الاتحاد details. معلومات تفصيلية عن خيار الاستهداف الذي يتمّ تعيينه. يجب ملء حقل واحد فقط بالتفاصيل، ويجب أن يتوافق مع السمة targeting_type. يمكن أن تكون السمة details واحدًا مما يلي فقط:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

تفاصيل القناة ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

تفاصيل فئة التطبيق. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

تفاصيل التطبيق ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

تفاصيل عنوان URL. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

تفاصيل اليوم والوقت ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

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

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

تفاصيل قائمة المواقع الجغرافية القريبة ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

تفاصيل الجنس ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

تفاصيل حجم مشغّل الفيديو ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

تفاصيل الحالة الأبوية. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

تفاصيل موضع الإعلان أثناء عرض الفيديو ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

تفاصيل موضع الإعلان خارج البث ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

تفاصيل نوع الجهاز ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

تفاصيل موضع الشاشة ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

تفاصيل مشغِّل شبكة الجوّال ومزوّد خدمة الإنترنت ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

يمكن تحديد 5,000 كلمة رئيسية سلبية مباشرة كحدّ أقصى للمورد. لا يوجد حدّ لعدد الكلمات الرئيسية الإيجابية التي يمكن تحديدها.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

يمكن تخصيص 4 قوائم كلمات رئيسية سلبية كحدّ أقصى لمورد معيّن.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

تفاصيل نظام التشغيل ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

تفاصيل العلامة التجارية للجهاز وطرازه ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

تفاصيل الفئة ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CATEGORY.

وسيؤدي استهداف إحدى الفئات أيضًا إلى استهداف فئاتها الفرعية. وإذا تم استبعاد فئة من الاستهداف وتم تضمين فئة فرعية، ستكون الأولوية للاستبعاد.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

تفاصيل إمكانية العرض ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_VIEWABILITY.

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

تفاصيل حالة البائع المعتمَد ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

إذا لم يتضمن أحد الموارد خيار حالة البائع المعتمد، سيتم تلقائيًا استهداف جميع البائعين المعتمَدين الذين تمت الإشارة إليهم باعتبارهم "مباشر" أو "بائع" في ملف ads.txt.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

الفئات الإعلانية الحساسة هي استبعادات الاستهداف. في حال ضبط استثناءات الفئات الإعلانية الحساسة على مستوى المعلِن، يتم تطبيقها دائمًا أثناء العرض (على الرغم من عدم ظهورها في إعدادات الموارد). يمكن لإعدادات الموارد أن تستبعد فئات إعلانية حساسة بالإضافة إلى استبعادات المعلنين، ولكن لا يمكنها تجاوزها.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

تفاصيل Exchange ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

تفاصيل نقاط الاهتمام ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

تفاصيل سلسلة النشاط التجاري ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

تفاصيل مدة المحتوى ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

تفاصيل مدة المحتوى ستتم تعبئة هذا الحقل عندما يكون TargetType (نوع الاستهداف) هو TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

تفاصيل موضع المحتوى الأصلي ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

افتح تفاصيل المستودع المفعَّلة للقياس. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

تفاصيل نوع المحتوى الصوتي ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

تفاصيل نوع المحتوى. ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_GENRE.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

تفاصيل فيديو YouTube ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

تفاصيل القناة على YouTube ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

تفاصيل موضع الجلسة ستتم تعبئة هذا الحقل عندما تكون قيمة targetingType هي TARGETING_TYPE_SESSION_POSITION.

الطُرق

create

يعيّن خيار استهداف لطلب إدراج.

delete

حذف خيار استهداف معيّن من طلب إدراج.

get

تتيح هذه الميزة تحديد خيار استهداف واحد لطلب إدراج.

list

يسرد خيارات الاستهداف المحدّدة لطلب إدراج.