REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

المورد: AssignedTargetingOption

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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)
  },
  "lookalikeAudienceDetails": {
    object (LookalikeAudienceAssignedTargetingOptionDetails)
  },
  "googleAudienceDetails": {
    object (GoogleAudienceAssignedTargetingOptionDetails)
  },
  "customListDetails": {
    object (CustomListAssignedTargetingOptionDetails)
  },
  "combinedAudienceDetails": {
    object (CombinedAudienceAssignedTargetingOptionDetails)
  },
  "firstPartyAndPartnerAudienceDetails": {
    object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
الحقول
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)

للعرض فقط. حالة اكتساب خيار الاستهداف المحدّد
معلومات تفصيلية عن خيار الاستهداف الذي يتم تعيينه. يمكن ملء حقل واحد فقط في التفاصيل، ويجب أن يتوافق مع targeting_type. في ما يلي قائمة بالحقول غير المتقاطعة. سيتم ضبط حقل واحد على الأكثر في الرد:
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_DEAL.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

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

object (ViewabilityAssignedTargetingOptionDetails)

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

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

إذا لم يتوفّر خيار حالة البائع المعتمَد في أحد الموارد، يتم تلقائيًا استهداف جميع البائعين المعتمَدين المُشار إليهم على أنّهم DIRECT أو RESELLER في ملف 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.

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

object (ContentThemeAssignedTargetingOptionDetails)

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

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

object (ExchangeAssignedTargetingOptionDetails)

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

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (LookalikeAudienceAssignedTargetingOptionDetails)

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

object (GoogleAudienceAssignedTargetingOptionDetails)

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

object (CustomListAssignedTargetingOptionDetails)

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

object (CombinedAudienceAssignedTargetingOptionDetails)

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

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

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

object (AuctionPackageAssignedTargetingOptionDetails)

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

object (YoutubeChannelPackAssignedTargetingOptionDetails)

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

ChannelAssignedTargetingOptionDetails

تفاصيل خيار استهداف القنوات المحدّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_CHANNEL.

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

string (int64 format)

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

boolean

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

AppCategoryAssignedTargetingOptionDetails

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

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

string

للعرض فقط. الاسم المعروض لفئة التطبيق
targetingOptionId

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_APP_CATEGORY
negative

boolean

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

AppAssignedTargetingOptionDetails

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

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

string

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

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

string

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

boolean

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

enum (AppPlatform)

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

AppPlatform

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

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

UrlAssignedTargetingOptionDetails

تفاصيل خيار استهداف عناوين URL الذي تم تحديده سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_URL.

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

string

الحقل مطلوب. عنوان URL، مثل example.com

تتيح "مساحة العرض والفيديو 360" مستويَين من استهداف الدليل الفرعي، مثل www.example.com/one-subdirectory-level/second-level، وخمسة مستويات من استهداف النطاق الفرعي، مثل five.four.three.two.one.example.com.
negative

boolean

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

DayAndTimeAssignedTargetingOptionDetails

تمثيل لشريحة زمنية محدّدة في يوم معيّن من الأسبوع مع وقتَي بدء وانتهاء يجب أن يكون الوقت الذي يمثّله startHour قبل الوقت الذي يمثّله endHour.

تمثيل JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
الحقول
dayOfWeek

enum (DayOfWeek)

الحقل مطلوب. يوم الأسبوع لإعداد استهداف اليوم والوقت هذا.
startHour

integer

الحقل مطلوب. ساعة البدء لاستهداف اليوم والوقت يجب أن تكون القيمة بين 0 (بداية اليوم) و23 (ساعة واحدة قبل نهاية اليوم).
endHour

integer

الحقل مطلوب. ساعة الانتهاء لاستهداف اليوم والوقت يجب أن تكون القيمة بين 1 (ساعة واحدة بعد بداية اليوم) و24 (نهاية اليوم).
timeZoneResolution

enum (TimeZoneResolution)

الحقل مطلوب. الآلية المستخدَمة لتحديد المنطقة الزمنية التي سيتم استخدامها لإعداد الاستهداف حسب اليوم والوقت.

بالنسبة إلى تفاصيل "حملات زيادة الطلب"، تكون قيمة هذا الحقل دائمًا TIME_ZONE_RESOLUTION_ADVERTISER.

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

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

تمثيل JSON 
{
  "ageRange": enum (AgeRange)
}
الحقول
ageRange

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

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

ProximityLocationListAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
الحقول
proximityLocationListId

string (int64 format)

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

number

الحقل مطلوب. النطاق الجغرافي المعبَّر عنه بوحدات المسافة المحدّدة في proximityRadiusUnit يمثّل ذلك حجم المنطقة المحيطة بالموقع الجغرافي الذي سيتم استهدافه. يجب أن يتراوح النطاق الجغرافي بين ميل واحد و500 ميل أو بين كيلومتر واحد و800 كيلومتر.
proximityRadiusUnit

enum (ProximityRadiusUnit)

الحقل مطلوب. وحدات مسافة النطاق الجغرافي

ProximityRadiusUnit

تعداد وحدات المسافة لـ ProximityRadius

عمليات التعداد
PROXIMITY_RADIUS_UNIT_UNSPECIFIED القيمة التلقائية في حال عدم تحديد وحدات المسافة في هذا الإصدار هذا التعداد هو عنصر نائب للقيمة التلقائية ولا يمثّل وحدة مسافة حقيقية.
PROXIMITY_RADIUS_UNIT_MILES وحدة مسافة النطاق الجغرافي بالأميال
PROXIMITY_RADIUS_UNIT_KILOMETERS وحدة مسافة النطاق الجغرافي بالكيلومتر

GenderAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف حسب الجنس المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_GENDER.

تمثيل JSON 
{
  "gender": enum (Gender)
}
الحقول
gender

enum (Gender)

الحقل مطلوب. جنس الجمهور

VideoPlayerSizeAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
الحقول
videoPlayerSize

enum (VideoPlayerSize)

الحقل مطلوب. حجم مشغّل الفيديو

UserRewardedContentAssignedTargetingOptionDetails

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

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

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_USER_REWARDED_CONTENT
userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

تفاصيل خيار استهداف الحالة الأبوية المحدَّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_PARENTAL_STATUS.

تمثيل JSON 
{
  "parentalStatus": enum (ParentalStatus)
}
الحقول
parentalStatus

enum (ParentalStatus)

الحقل مطلوب. الحالة الأبوية للجمهور

ContentInstreamPositionAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
الحقول
contentInstreamPosition

enum (ContentInstreamPosition)

الحقل مطلوب. موضع الإعلان أثناء عرض الفيديو أو الإعلان الصوتي
adType

enum (AdType)

للعرض فقط. نوع الإعلان المطلوب استهدافه ينطبق هذا الخيار على استهداف طلب الإدراج فقط، وستكتسب البنود الإعلانية الجديدة التي تتيح نوع الإعلان المحدّد خيار الاستهداف هذا تلقائيًا. القيم المحتمَلة هي:

  • ‫AD_TYPE_VIDEO، سيتم تطبيق الإعداد على البند الإعلاني الجديد عندما يكون lineItemType LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • ‫AD_TYPE_AUDIO، سيتم تطبيق الإعداد على البند الإعلاني الجديد عندما يكون lineItemType LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

تمثّل نوع تصميم الإعلان المرتبط بالإعلانات.

عمليات التعداد
AD_TYPE_UNSPECIFIED لم يتم تحديد نوع الإعلان أو أنّه غير معروف في هذا الإصدار.
AD_TYPE_DISPLAY تصاميم الإعلانات الصورية، مثل الصور وHTML5
AD_TYPE_VIDEO تصاميم إعلانات الفيديو، مثل إعلانات الفيديو التي يتم تشغيلها أثناء بث المحتوى في مشغّلات الفيديو
AD_TYPE_AUDIO مواد إبداعية صوتية، مثل الإعلانات الصوتية التي يتم تشغيلها أثناء المحتوى الصوتي

ContentOutstreamPositionAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
الحقول
contentOutstreamPosition

enum (ContentOutstreamPosition)

الحقل مطلوب. موضع المحتوى خارج مشغّل الفيديو
adType

enum (AdType)

للعرض فقط. نوع الإعلان المطلوب استهدافه ينطبق هذا الخيار على استهداف طلب الإدراج فقط، وستكتسب البنود الإعلانية الجديدة التي تتيح نوع الإعلان المحدّد خيار الاستهداف هذا تلقائيًا. القيم المحتمَلة هي:

  • ‫AD_TYPE_DISPLAY، سيتم تطبيق الإعداد على البند الإعلاني الجديد عندما يكون lineItemType LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • ‫AD_TYPE_VIDEO، سيتم تطبيق الإعداد على البند الإعلاني الجديد عندما يكون lineItemType LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

تفاصيل الاستهداف لنوع الجهاز سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_DEVICE_TYPE.

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

enum (DeviceType)

الحقل مطلوب. الاسم المعروض لنوع الجهاز
youtubeAndPartnersBidMultiplier

number

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

على سبيل المثال، إذا كان سعر عرض السعر بدون مضاعِف هو 10.0 دولار أمريكي وكان المضاعِف هو 1.5 للأجهزة اللوحية، سيكون سعر عرض السعر الناتج للأجهزة اللوحية هو 15.0 دولار أمريكي.

ينطبق ذلك على البنود الإعلانية في YouTube والشركاء فقط.

AudienceGroupAssignedTargetingOptionDetails

تفاصيل خيار استهداف شريحة الجمهور المحدّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_AUDIENCE_GROUP. العلاقة بين كل مجموعة هي UNION، باستثناء excludedFirstAndThirdPartyAudienceGroup وexcludedGoogleAudienceGroup، حيث يتم استخدام COMPLEMENT كـ INTERSECTION مع المجموعات الأخرى.

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

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

اختيارية: أرقام تعريف الجمهور المجمّع لمجموعة الجمهور المجمّع المضمّنة يحتوي على أرقام تعريف الجمهور المجمّع فقط.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

اختيارية: أرقام تعريف شرائح جمهور الطرف الأول والشركاء ومدى حداثة شرائح جمهور الطرف الأول والشركاء المضمّنة تحتوي كل مجموعة من شرائح جمهور الطرف الأول والشركاء على أرقام تعريف شرائح جمهور الطرف الأول والشركاء فقط. العلاقة بين كل شريحة جمهور تابعة للطرف الأول وشريحة جمهور تابعة للشريك هي INTERSECTION، والنتيجة هي UNION مع شرائح الجمهور الأخرى. سيتم تجاهل المجموعات المتكرّرة التي تتضمّن الإعدادات نفسها.
excludedFirstPartyAndPartnerAudienceGroup

object (FirstPartyAndPartnerAudienceGroup)

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

GoogleAudienceGroup

تفاصيل شريحة الجمهور من Google تكون جميع إعدادات استهداف الجمهور في Google منطقيًا "أو" بعضها البعض.

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

object (GoogleAudienceTargetingSetting)

الحقل مطلوب. جميع إعدادات استهداف الجمهور من Google في شريحة الجمهور من Google سيتم تجاهل الإعدادات المتكررة التي تحمل رقم التعريف نفسه.

GoogleAudienceTargetingSetting

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

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

string (int64 format)

الحقل مطلوب. رقم تعريف شريحة الجمهور على Google لإعداد استهداف الجمهور على Google هذا المعرّف هو googleAudienceId.

CustomListGroup

تفاصيل مجموعة القوائم المخصّصة تكون جميع إعدادات استهداف قوائم العملاء منطقيًا "أو" لبعضها البعض.

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

object (CustomListTargetingSetting)

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

CustomListTargetingSetting

تفاصيل إعداد استهداف قائمة العملاء

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

string (int64 format)

الحقل مطلوب. رقم التعريف المخصّص لإعداد استهداف قائمة العملاء هذا المعرّف هو customListId.

CombinedAudienceGroup

تفاصيل شريحة الجمهور المجمّعة تكون جميع إعدادات استهداف الجمهور المجمّع منطقيًا "أو" لبعضها البعض.

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

FirstPartyAndPartnerAudienceGroup

تفاصيل شريحة جمهور الطرف الأول والشريك تكون جميع إعدادات استهداف الجمهور التابعة للطرف الأول والشركاء منطقيًا "أو" لبعضها البعض.

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

object (FirstPartyAndPartnerAudienceTargetingSetting)

الحقل مطلوب. جميع إعدادات استهداف الجمهور التابعة للطرف الأول والشركاء في شريحة الجمهور التابعة للطرف الأول والشركاء لا يُسمح بالإعدادات المتكرّرة التي لها رقم التعريف نفسه.

FirstPartyAndPartnerAudienceTargetingSetting

تفاصيل إعدادات استهداف جمهور الطرف الأول والشركاء

تمثيل JSON 
{
  "firstPartyAndPartnerAudienceId": string,
  "recency": enum (Recency)
}
الحقول
firstPartyAndPartnerAudienceId

string (int64 format)

الحقل مطلوب. رقم تعريف شريحة جمهور الطرف الأول والشريك لإعداد استهداف الجمهور للطرف الأول والشريك هذا المعرّف هو firstPartyAndPartnerAudienceId.
recency

enum (Recency)

الحقل مطلوب. مدى حداثة إعداد استهداف جمهور الطرف الأول والشركاء لا ينطبق ذلك إلا على شرائح جمهور الطرف الأول، وإلا سيتم تجاهلها. لمزيد من المعلومات، يُرجى الرجوع إلى https://support.google.com/displayvideo/answer/2949947#recency. في حال عدم تحديد أي قيمة، لن يتم استخدام أي حدّ أقصى لمدى الحداثة.

مدى الحداثة

جميع قيم مدى الحداثة المتاحة لشرائح جمهور الطرف الأول والشركاء

عمليات التعداد
RECENCY_NO_LIMIT ما مِن حدّ أقصى لمدى الحداثة.
RECENCY_1_MINUTE مدى الحداثة هو دقيقة واحدة.
RECENCY_5_MINUTES مدى الحداثة هو 5 دقائق.
RECENCY_10_MINUTES مدى الحداثة هو 10 دقائق.
RECENCY_15_MINUTES مدى الحداثة هو 15 دقيقة.
RECENCY_30_MINUTES مدى الحداثة هو 30 دقيقة.
RECENCY_1_HOUR مدى الحداثة هو ساعة واحدة.
RECENCY_2_HOURS مدى الحداثة هو ساعتان.
RECENCY_3_HOURS مدى الحداثة هو 3 ساعات.
RECENCY_6_HOURS مدى الحداثة هو 6 ساعات.
RECENCY_12_HOURS مدى الحداثة هو 12 ساعة.
RECENCY_1_DAY مدى الحداثة هو يوم واحد.
RECENCY_2_DAYS مدى الحداثة هو يومان.
RECENCY_3_DAYS مدى الحداثة هو 3 أيام.
RECENCY_5_DAYS مدى الحداثة هو 5 أيام.
RECENCY_7_DAYS مدى الحداثة هو 7 أيام.
RECENCY_10_DAYS مدى الحداثة هو 10 أيام.
RECENCY_14_DAYS مدى الحداثة هو 14 يومًا.
RECENCY_15_DAYS مدى الحداثة هو 15 يومًا.
RECENCY_21_DAYS مدى الحداثة هو 21 يومًا.
RECENCY_28_DAYS مدى الحداثة هو 28 يومًا.
RECENCY_30_DAYS مدى الحداثة هو 30 يومًا.
RECENCY_40_DAYS مدى الحداثة هو 40 يومًا.
RECENCY_45_DAYS مدى الحداثة هو 45 يومًا.
RECENCY_60_DAYS مدى الحداثة هو 60 يومًا.
RECENCY_90_DAYS مدى الحداثة هو 90 يومًا.
RECENCY_120_DAYS مدى الحداثة هو 120 يومًا.
RECENCY_180_DAYS مدى الحداثة هو 180 يومًا.
RECENCY_270_DAYS مدى الحداثة هو 270 يومًا.
RECENCY_365_DAYS مدى الحداثة هو 365 يومًا.

BrowserAssignedTargetingOptionDetails

تفاصيل خيار استهداف المتصفّح المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_BROWSER.

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

string

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

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_BROWSER
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "householdIncome": enum (HouseholdIncome)
}
الحقول
householdIncome

enum (HouseholdIncome)

الحقل مطلوب. دخل الأسرة للجمهور

OnScreenPositionAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
الحقول
targetingOptionId

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_ON_SCREEN_POSITION
onScreenPosition

enum (OnScreenPosition)

للعرض فقط. الموضع على الشاشة
adType

enum (AdType)

للعرض فقط. نوع الإعلان المطلوب استهدافه ينطبق هذا الخيار على استهداف طلبات الإدراج فقط، وستكتسب البنود الإعلانية الجديدة التي تتيح نوع الإعلان المحدّد خيار الاستهداف هذا تلقائيًا. القيم المحتمَلة هي:

  • ‫AD_TYPE_DISPLAY، سيتم تطبيق الإعداد على البند الإعلاني الجديد عندما يكون lineItemType LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • ‫AD_TYPE_VIDEO، سيتم تطبيق الإعداد على البند الإعلاني الجديد عندما يكون lineItemType LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

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

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

string

للعرض فقط. الاسم المعروض لمشغّل شبكة الجوّال أو مزوّد خدمة الإنترنت
targetingOptionId

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_CARRIER_AND_ISP
negative

boolean

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

KeywordAssignedTargetingOptionDetails

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

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

string

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

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

boolean

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

string

اختيارية: أسماء السياسات التي يجب استثناء الكلمة الرئيسية منها

عند محاولة استهداف كلمة رئيسية تنتهك إحدى السياسات، سيتضمّن الخطأ الذي يتم عرضه اسم السياسة ذات الصلة. استخدِم هذا الاسم في هذا الحقل لإعفاء الكلمة الرئيسية المستهدَفة من السياسة.

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

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string (int64 format)

الحقل مطلوب. رقم تعريف قائمة الكلمات الرئيسية السلبية يجب أن يشير إلى الحقل negativeKeywordListId لمورد NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

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

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

string

للعرض فقط. الاسم المعروض لنظام التشغيل
targetingOptionId

string

الحقل مطلوب. رقم تعريف خيار الاستهداف الذي تم ملؤه في حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_OPERATING_SYSTEM.
negative

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

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

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

string

للعرض فقط. الاسم المعروض للعلامة التجارية للجهاز وطرازه
targetingOptionId

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_DEVICE_MAKE_MODEL
negative

boolean

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

EnvironmentAssignedTargetingOptionDetails

تفاصيل خيار استهداف البيئة المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_ENVIRONMENT.

تمثيل JSON 
{
  "environment": enum (Environment)
}
الحقول
environment

enum (Environment)

الحقل مطلوب. بيئة العرض

InventorySourceAssignedTargetingOptionDetails

تفاصيل الاستهداف لمصدر المستودع سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_INVENTORY_SOURCE_DEAL.

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

string (int64 format)

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

CategoryAssignedTargetingOptionDetails

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

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

string

للعرض فقط. الاسم المعروض للفئة
targetingOptionId

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CATEGORY
negative

boolean

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

ViewabilityAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "viewability": enum (Viewability)
}
الحقول
viewability

enum (Viewability)

الحقل مطلوب. النسبة المئوية لإمكانية العرض المتوقّعة

AuthorizedSellerStatusAssignedTargetingOptionDetails

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

إذا لم يكن لدى المورد خيار استهداف معيّن من TARGETING_TYPE_AUTHORIZED_SELLER_STATUS، سيتم استخدام خيار "البائعون المباشرون والمورّدون المعتمَدون".

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

enum (AuthorizedSellerStatus)

للعرض فقط. حالة البائع المعتمَد المطلوب استهدافها
targetingOptionId

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_AUTHORIZED_SELLER_STATUS

LanguageAssignedTargetingOptionDetails

تفاصيل خيار استهداف اللغة المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_LANGUAGE.

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

string

للعرض فقط. الاسم المعروض للغة (مثل "الفرنسية").
targetingOptionId

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_LANGUAGE
negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

تفاصيل خيار استهداف المنطقة الجغرافية المحدَّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_GEO_REGION.

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

string

للعرض فقط. الاسم المعروض للمنطقة الجغرافية (مثلاً، "أونتاريو، كندا")
targetingOptionId

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_GEO_REGION
geoRegionType

enum (GeoRegionType)

للعرض فقط. نوع استهداف المنطقة الجغرافية
negative

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

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

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

تفاصيل الاستهداف لتصنيف المحتوى الرقمي سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

تمثيل JSON 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
الحقول
excludedContentRatingTier

enum (ContentRatingTier)

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

يقبل هذا الحقل القيمة CONTENT_RATING_TIER_UNRATED فقط.

SensitiveCategoryAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
الحقول
excludedSensitiveCategory

enum (SensitiveCategory)

الحقل مطلوب. قائمة تعداد لمحتوى الفئة الحسّاسة في "مساحة العرض والفيديو 360" المصنَّف على أنّه مستبعَد.

يقبل هذا الحقل القيم التالية فقط:

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

ContentThemeAssignedTargetingOptionDetails

تفاصيل الاستهداف لموضوع المحتوى سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

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

string

الحقل مطلوب. رقم تعريف موضوع المحتوى المطلوب استبعاده
contentTheme

enum (ContentTheme)

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

enum (ContentTheme)

الحقل مطلوب. قيمة تعداد لموضوع المحتوى في "مساحة العرض والفيديو 360" الذي تم تصنيفه على أنّه "مستبعَد".

ExchangeAssignedTargetingOptionDetails

تفاصيل خيار استهداف Exchange المحدّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_EXCHANGE.

تمثيل JSON 
{
  "exchange": enum (Exchange)
}
الحقول
exchange

enum (Exchange)

الحقل مطلوب. قيمة التعداد للبورصة

SubExchangeAssignedTargetingOptionDetails

تفاصيل خيار استهداف سوق الإعلانات الفرعية المحدَّد سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_SUB_EXCHANGE.

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

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_SUB_EXCHANGE

ThirdPartyVerifierAssignedTargetingOptionDetails

تفاصيل خيار استهداف أداة التحقّق التابعة لجهة خارجية الذي تم تعيينه سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_THIRD_PARTY_VERIFIER.

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  },
  "peer39": {
    object (Peer39)
  }
  // End of mutually exclusive fields.
}
الحقول
يمكن استهداف إحدى جهات التحقّق الخارجية من أجل فرض حدود أمان العلامة التجارية لمرات الظهور. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
doubleVerify

object (DoubleVerify)

أداة التحقّق من العلامة التجارية التابعة لجهة خارجية: DoubleVerify
integralAdScience

object (IntegralAdScience)

أداة التحقّق من العلامة التجارية التابعة لجهة خارجية: Integral Ad Science
peer39

object (Peer39)

أداة التحقّق من العلامة التجارية التابعة لجهة خارجية: Peer39
نهاية الحقول التي يستبعد كلّ منها الآخر

DoubleVerify

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

تمثيل JSON 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
الحقول
brandSafetyCategories

object (BrandSafetyCategories)

عناصر التحكّم في أمان العلامة التجارية من DoubleVerify
avoidedAgeRatings[]

enum (AgeRating)

تجنَّب تقديم عروض أسعار على التطبيقات التي تحمل التقييم حسب الفئة العمرية.
appStarRating

object (AppStarRating)

تجنَّب تقديم عروض أسعار للتطبيقات التي تتضمّن تقييمات بالنجوم.
displayViewability

object (DisplayViewability)

إعدادات إمكانية عرض الإعلانات الصورية (تنطبق على البنود الإعلانية الصورية فقط)
videoViewability

object (VideoViewability)

إعدادات إمكانية عرض الفيديو (تنطبق على البنود الإعلانية للفيديو فقط).
fraudInvalidTraffic

object (FraudInvalidTraffic)

تجنُّب المواقع الإلكترونية والتطبيقات التي تتضمّن معدلات احتيال وزيارات غير صالحة سابقة
customSegmentId

string (int64 format)

معرّف شريحة الجمهور المخصّصة الذي تقدّمه DoubleVerify يجب أن يبدأ المعرّف بالرقم "51" وأن يتألف من ثمانية أرقام. لا يمكن تحديد رقم تعريف شريحة الجمهور المخصّصة مع أيّ من الحقول التالية:

BrandSafetyCategories

إعدادات عناصر التحكّم في أمان العلامة التجارية

تمثيل JSON 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
الحقول
avoidUnknownBrandSafetyCategory

boolean

غير معروف أو غير قابل للتقييم
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

فئات التجنّب العالية الخطورة لأمان العلامة التجارية
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

فئات التجنّب ذات الخطورة المتوسطة لأمان العلامة التجارية

HighSeverityCategory

الخيارات المتاحة للفئات ذات الخطورة العالية

عمليات التعداد
HIGHER_SEVERITY_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي فئات شديدة الخطورة.
ADULT_CONTENT_PORNOGRAPHY المحتوى المخصّص للبالغين: المواد الإباحية والمواضيع المخصّصة للبالغين والعُري
COPYRIGHT_INFRINGEMENT انتهاك حقوق الطبع والنشر
SUBSTANCE_ABUSE المخدرات/الكحول/المواد الخاضعة للرقابة: تعاطي المواد الضارّة
GRAPHIC_VIOLENCE_WEAPONS محتوى يتضمّن مشاهد عنف قاسية أو فاضحة أو أسلحة
HATE_PROFANITY الكراهية/اللغة النابية
CRIMINAL_SKILLS الأنشطة غير القانونية: المهارات الإجرامية
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER محتوى محفَّز أو برامج ضارة أو غير منظَّم

MediumSeverityCategory

الخيارات المتاحة لفئات الخطورة المتوسطة

عمليات التعداد
MEDIUM_SEVERITY_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي فئات متوسطة الخطورة.
AD_SERVERS خوادم الإعلانات:
ADULT_CONTENT_SWIMSUIT محتوى مخصّص للبالغين: ملابس سباحة
ALTERNATIVE_LIFESTYLES المواضيع المثيرة للجدل: أنماط الحياة البديلة
CELEBRITY_GOSSIP مواضيع مثيرة للجدل: أخبار المشاهير
GAMBLING المواضيع المثيرة للجدل: المقامرة
OCCULT مواضيع مثيرة للجدل: الخوارق
SEX_EDUCATION مواضيع مثيرة للجدل: التربية الجنسية
DISASTER_AVIATION الكوارث: الطيران
DISASTER_MAN_MADE الكوارث: من صنع الإنسان
DISASTER_NATURAL الكوارث: طبيعية
DISASTER_TERRORIST_EVENTS الكوارث: الأحداث الإرهابية
DISASTER_VEHICLE Disaster: Vehicle.
ALCOHOL المخدرات/الكحول/المواد الخاضعة للرقابة: الكحول
SMOKING المخدرات/الكحول/المواد الخاضعة للرقابة: التدخين
NEGATIVE_NEWS_FINANCIAL أخبار سلبية: مالية
NON_ENGLISH Non-Std Content: 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

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

تمثيل JSON 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
الحقول
avoidedStarRating

enum (StarRating)

تجنَّب تقديم عروض أسعار للتطبيقات التي تتضمّن تقييمات بالنجوم.
avoidInsufficientStarRating

boolean

تجنَّب تقديم عروض أسعار للتطبيقات التي لا تتضمّن تقييمات كافية بالنجوم.

StarRating

الخيارات المتاحة للتقييمات بالنجوم

عمليات التعداد
APP_STAR_RATE_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي خيارات للتقييم بالنجوم للتطبيق.
APP_STAR_RATE_1_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 1.5 نجمة
APP_STAR_RATE_2_LESS التطبيقات الرسمية التي يقل تقييمها عن نجمتَين
APP_STAR_RATE_2_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 2.5 نجمة
APP_STAR_RATE_3_LESS التطبيقات الرسمية التي يقل تقييمها عن 3 نجوم
APP_STAR_RATE_3_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 3.5 نجوم
APP_STAR_RATE_4_LESS التطبيقات الرسمية التي يقل تقييمها عن 4 نجوم
APP_STAR_RATE_4_POINT_5_LESS التطبيقات الرسمية التي يقل تقييمها عن 4.5 نجوم

DisplayViewability

تفاصيل إعدادات إمكانية عرض الإعلانات الصورية في DoubleVerify

تمثيل JSON 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
الحقول
iab

enum (IAB)

استهداف المساحات الإعلانية المتاحة على الويب والتطبيقات لزيادة نسبة إمكانية العرض وفقًا لمعايير IAB إلى أقصى حدّ
viewableDuring

enum (ViewableDuring)

استهدِف المساحات الإعلانية المتاحة على الويب والتطبيقات لزيادة مدة العرض بنسبة% 100 إلى أقصى حدّ.

مكتب الإعلانات التفاعلية (IAB)

الخيارات المتاحة لنسبة إمكانية العرض وفقًا لمكتب الإعلانات التفاعلية (IAB)

عمليات التعداد
IAB_VIEWED_RATE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لنسبة المشاهدة وفقًا لمكتب الإعلانات التفاعلية (IAB).
IAB_VIEWED_RATE_80_PERCENT_HIGHER استهداف المساحات الإعلانية المتاحة على الويب والتطبيقات لزيادة نسبة إمكانية العرض وفقًا لمعايير IAB إلى% 80 أو أكثر
IAB_VIEWED_RATE_75_PERCENT_HIGHER استهداف المساحات الإعلانية المتاحة على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمعايير 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),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
الحقول
videoIab

enum (VideoIAB)

استهداف المساحات الإعلانية المتاحة على الويب لزيادة نسبة إمكانية العرض وفقًا لمعايير IAB إلى أقصى حدّ
videoViewableRate

enum (VideoViewableRate)

استهدِف المساحات الإعلانية المتاحة على الويب لزيادة نسبة إمكانية العرض الكاملة إلى أقصى حدّ.
playerImpressionRate

enum (PlayerImpressionRate)

استهدِف المساحات الإعلانية المتاحة لزيادة عدد مرّات الظهور إلى أقصى حدّ باستخدام مشغّل بحجم 400×300 أو أكبر.

VideoIAB

الخيارات المتاحة لنسبة إمكانية العرض وفقًا لمكتب الإعلانات التفاعلية (IAB)

عمليات التعداد
VIDEO_IAB_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لنسبة إمكانية العرض في الفيديو وفقًا لمكتب الإعلانات التفاعلية (IAB).
IAB_VIEWABILITY_80_PERCENT_HIGHER استهداف المساحات الإعلانية المتاحة على الويب والتطبيقات لزيادة نسبة إمكانية العرض وفقًا لمعايير IAB إلى% 80 أو أكثر
IAB_VIEWABILITY_75_PERCENT_HIGHER استهداف المساحات الإعلانية المتاحة على الويب والمساحات الإعلانية المتاحة على التطبيقات لزيادة نسبة إمكانية العرض وفقًا لمعايير 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

إعدادات DoubleVerify Fraud & Invalid Traffic

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

enum (FraudOption)

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

boolean

إحصاءات غير كافية حول الزيارات غير الصالحة والاحتيال في السابق

FraudOption

الخيارات المتاحة لمعدّل الاحتيال والزيارات غير الصالحة السابقة

عمليات التعداد
FRAUD_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي خيارات للاحتيال والزيارات غير الصالحة.
AD_IMPRESSION_FRAUD_100 ‫% 100 من الزيارات غير الصالحة والاحتيالية
AD_IMPRESSION_FRAUD_75 ‫75% أو أكثر من الزيارات غير الصالحة والاحتيالية
AD_IMPRESSION_FRAUD_50 ‫% 50 أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_25 ‫% 25 أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_10 ‫% 10 أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_8 ‫8% أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_6 ‫6% أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_4 ‫% 4 أو أكثر من عمليات الاحتيال والزيارات غير الصالحة
AD_IMPRESSION_FRAUD_2 ‫% 2 أو أكثر من عمليات الاحتيال والزيارات غير الصالحة

IntegralAdScience

تفاصيل إعدادات Integral Ad Science

تمثيل JSON 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
الحقول
traqScoreOption

enum (TRAQScore)

جودة الإعلان الحقيقية (تنطبق على البنود الإعلانية على الشبكة الإعلانية فقط)
excludeUnrateable

boolean

أمان العلامة التجارية - غير قابل للتقييم
excludedAdultRisk

enum (Adult)

أمان العلامة التجارية: المحتوى المخصّص للبالغين
excludedAlcoholRisk

enum (Alcohol)

أمان العلامة التجارية - الكحول
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

أمان العلامة التجارية - عمليات التنزيل غير القانونية
excludedDrugsRisk

enum (Drugs)

أمان العلامة التجارية - المخدرات
excludedHateSpeechRisk

enum (HateSpeech)

أمان العلامة التجارية - الكلام الذي يحض على الكراهية
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

أمان العلامة التجارية - اللغة المسيئة
excludedViolenceRisk

enum (Violence)

أمان العلامة التجارية - العنف
excludedGamblingRisk

enum (Gambling)

أمان العلامة التجارية - المقامرة
excludedAdFraudRisk

enum (AdFraudPrevention)

إعدادات الإعلانات الاحتيالية
displayViewability

enum (DisplayViewability)

قسم "إمكانية عرض الإعلانات الصورية" (ينطبق على تفاصيل الإعلانات الصورية فقط)
videoViewability

enum (VideoViewability)

قسم "إمكانية عرض الفيديو" (ينطبق على البنود الإعلانية للفيديو فقط)
customSegmentId[]

string (int64 format)

رقم تعريف شريحة الجمهور المخصّصة الذي تقدّمه شركة Integral Ad Science. يجب أن يتراوح المعرّف بين 1000001 و1999999 أو 3000001 و3999999، ضِمنًا.
qualitySyncCustomSegmentId[]

string (int64 format)

اختيارية: رقم تعريف شريحة الجمهور المخصّصة لمزامنة الجودة الذي تقدّمه شركة Integral Ad Science. يجب أن يتراوح المعرّف بين 3000000 و4999999، شاملةً هذين الرقمين.

TRAQScore

نطاقات نقاط TRAQ (جودة الإعلان الصحيح) المحتملة في Integral Ad Science

عمليات التعداد
TRAQ_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي تقييمات جودة إعلانات حقيقية.
TRAQ_250 تتراوح نتيجة TRAQ بين 250 و1000.
TRAQ_500 نتيجة TRAQ تتراوح بين 500 و1000.
TRAQ_600 تتراوح نتيجة TRAQ بين 600 و1000.
TRAQ_700 تتراوح نتيجة TRAQ بين 700 و1000.
TRAQ_750 تتراوح نتيجة TRAQ بين 750 و1000.
TRAQ_875 تتراوح نتيجة TRAQ بين 875 و1000.
TRAQ_1000 نتيجة TRAQ هي 1000.

للبالغين

خيارات Integral Ad Science المتاحة للبالغين

عمليات التعداد
ADULT_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للبالغين.
ADULT_HR محتوى للبالغين - استبعاد المحتوى العالي الخطورة
ADULT_HMR محتوى للبالغين: استبعاد المحتوى العالي والمتوسط الخطورة

الكحول

خيارات Integral Ad Science المحتملة للكحول

عمليات التعداد
ALCOHOL_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للكحول.
ALCOHOL_HR Alcohol - Exclude High Risk.
ALCOHOL_HMR الكحول - استبعاد المحتوى العالي والمتوسط الخطورة

IllegalDownloads

خيارات "عمليات التنزيل غير القانونية" المحتملة في Integral Ad Science

عمليات التعداد
ILLEGAL_DOWNLOADS_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لعمليات التنزيل غير القانونية.
ILLEGAL_DOWNLOADS_HR عمليات التنزيل غير القانونية - استبعاد المحتوى العالي الخطورة
ILLEGAL_DOWNLOADS_HMR عمليات التنزيل غير القانونية - استبعاد المحتوى العالي والمتوسط الخطورة

مخدّرات

خيارات "المخدرات" المحتملة في Integral Ad Science

عمليات التعداد
DRUGS_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للأدوية.
DRUGS_HR Drugs - Exclude High Risk.
DRUGS_HMR Drugs - Exclude High and Moderate Risk.

HateSpeech

الخيارات المحتملة للكلام الذي يحض على الكراهية في Integral Ad Science

عمليات التعداد
HATE_SPEECH_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للكلام الذي يحض على الكراهية.
HATE_SPEECH_HR الكلام الذي يحض على الكراهية - استبعاد المحتوى العالي الخطورة
HATE_SPEECH_HMR الكلام الذي يحض على الكراهية: استبعاد المحتوى العالي والمتوسط الخطورة

OffensiveLanguage

خيارات اللغة المسيئة المحتملة في Integral Ad Science

عمليات التعداد
OFFENSIVE_LANGUAGE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات لغة.
OFFENSIVE_LANGUAGE_HR اللغة المسيئة - استبعاد المحتوى العالي الخطورة
OFFENSIVE_LANGUAGE_HMR اللغة المسيئة: استبعاد المحتوى العالي والمتوسط الخطورة

عنف

خيارات العنف المحتملة في Integral Ad Science

عمليات التعداد
VIOLENCE_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للعنف.
VIOLENCE_HR العنف - استبعاد المحتوى العالي الخطورة
VIOLENCE_HMR العنف: استبعاد المحتوى العالي والمتوسط الخطورة

المقامرة

خيارات المقامرة المحتملة في Integral Ad Science

عمليات التعداد
GAMBLING_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيارات للمقامرة.
GAMBLING_HR المقامرة - استبعاد المحتوى العالي الخطورة
GAMBLING_HMR المقامرة - استبعاد المحتوى العالي والمتوسط الخطورة

AdFraudPrevention

خيارات منع الاحتيال الإعلاني المحتملة من Integral Ad Science

عمليات التعداد
SUSPICIOUS_ACTIVITY_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدّد أي خيارات لمنع الإعلانات الاحتيالية.
SUSPICIOUS_ACTIVITY_HR Ad Fraud - Exclude High Risk.
SUSPICIOUS_ACTIVITY_HMR Ad Fraud - Exclude High and Moderate Risk.
SUSPICIOUS_ACTIVITY_FD Ad Fraud - Exclude Fraudulent Device.

DisplayViewability

خيارات إمكانية العرض المحتملة في Integral Ad Science Display

عمليات التعداد
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)

Peer39

تفاصيل إعدادات أمان العلامة التجارية في Peer39

تمثيل JSON 
{
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
الحقول
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

اختيارية: فئات Peer39 للاحتيال والزيارات غير الصالحة والمواقع الإلكترونية المُصمّمة لـ AdSense التي يجب استبعادها
adultExplicitSexualContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM للمحتوى الجنسي الفاضح والمخصّص للبالغين المطلوب استبعادها:
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM التي يجب استبعادها في ما يخصّ المحتوى الذي يتضمّن جرائم وأفعالاً ضارّة
armsAmmunitionContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM للمحتوى المتعلّق بالأسلحة والذخيرة المطلوب استبعادها
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM التي يجب استبعادها في المحتوى المتعلّق بالموت أو الإصابات أو النزاعات العسكرية:
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM التي يجب استبعادها في المحتوى الذي يتناول قضايا اجتماعية حسّاسة مثيرة للجدل
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM التي يجب استبعادها في ما يخصّ المحتوى الذي يتضمّن أدوية محظورة أو كحولاً
onlinePiracyContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر GARM لمحتوى القرصنة على الإنترنت المطلوب استبعادها
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر المحتوى الذي يتضمّن كلامًا يحض على الكراهية وأعمالاً عدائية وفقًا لإطار عمل GARM المطلوب استبعادها
obscenityProfanityContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر المحتوى البذيء واللغة النابية وفقًا GARM التي تريد استبعادها:
spamHarmfulContent

enum (GarmRiskExclusion)

اختيارية: نطاقات المخاطر التي يجب استبعادها في ما يتعلّق بالمحتوى غير المرغوب فيه أو الضارّ وفقًا GARM:
terrorismContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر المحتوى الإرهابي وفقًا GARM التي يجب استبعادها
misinformationContent

enum (GarmRiskExclusion)

اختيارية: نطاقات مخاطر المحتوى الذي يتضمّن معلومات خاطئة وفقًا لإطار عمل GARM المطلوب استبعادها
displayIabViewability

enum (DisplayIabViewability)

اختيارية: الحد الأدنى لإمكانية العرض وفقًا لمكتب الإعلانات التفاعلية (IAB) للإعلانات الصورية
videoIabViewability

enum (VideoIabViewability)

اختيارية: الحد الأدنى لإمكانية العرض وفقًا لمكتب IAB لإعلانات الفيديو

FraudIvtMfaCategory

فئات Peer39 المتاحة: الاحتيال والزيارات غير الصالحة والمواقع الإلكترونية المُصمّمة لـ AdSense

عمليات التعداد
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد فئة Peer39 Fraud أو IVT أو MFA أو عندما تكون غير معروفة في هذا الإصدار.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

خيارات استبعاد مستوى المخاطر المتاحة في GARM

عمليات التعداد
GARM_RISK_EXCLUSION_UNSPECIFIED هذا التعداد هو عنصر نائب فقط ولا يحدّد أي خيار لاستبعاد المخاطر وفقًا لـ GARM.
GARM_RISK_EXCLUSION_FLOOR استبعاد مخاطر الحد الأدنى للسعر
GARM_RISK_EXCLUSION_HIGH استبعاد المخاطر العالية والمنخفضة
GARM_RISK_EXCLUSION_MEDIUM استبعاد المخاطر المتوسطة والعالية والحد الأدنى من المخاطر
GARM_RISK_EXCLUSION_LOW استبعاد جميع مستويات المخاطر (المنخفضة والمتوسطة والعالية والحد الأدنى)

DisplayIabViewability

الحدود المتاحة لإمكانية عرض الإعلانات الصورية في Peer39 IAB

عمليات التعداد
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED القيمة التلقائية في حال عدم تحديدها أو إذا كانت غير معروفة في هذا الإصدار
DISPLAY_IAB_VIEWABILITY_10 ‫10%أو أكثر من الإعلان معروضة على الشاشة (معيار إمكانية العرض على "الشبكة الإعلانية" لمكتب الإعلانات التفاعلية)
DISPLAY_IAB_VIEWABILITY_20 ‫20%أو أكثر من الإعلان يظهر على الشاشة (معيار إمكانية عرض الإعلانات الصورية لمكتب الإعلانات التفاعلية)
DISPLAY_IAB_VIEWABILITY_35 ‫35%أو أكثر من الإعلان قابل للعرض (معيار إمكانية عرض الإعلانات الصورية من IAB)
DISPLAY_IAB_VIEWABILITY_50 ‫%50 أو أكثر من الإعلان معروض (معيار إمكانية عرض الإعلانات الصورية من IAB)
DISPLAY_IAB_VIEWABILITY_75 ‫75%أو أكثر من الإعلان قابل للعرض (معيار إمكانية عرض الإعلانات الصورية في مكتب الإعلانات التفاعلية)

VideoIabViewability

الحدود المتاحة لإمكانية عرض فيديوهات Peer39 IAB

عمليات التعداد
VIDEO_IAB_VIEWABILITY_UNSPECIFIED القيمة التلقائية في حال عدم تحديدها أو إذا كانت غير معروفة في هذا الإصدار
VIDEO_IAB_VIEWABILITY_10 ‫10%أو أكثر من الإعلان يظهر على الشاشة (معيار إمكانية عرض الفيديو لدى مكتب IAB)
VIDEO_IAB_VIEWABILITY_20 ‫20%أو أكثر من الفيديو معروض (معيار إمكانية عرض الفيديو في مكتب IAB)
VIDEO_IAB_VIEWABILITY_35 ‫35%أو أكثر من الإعلان معروض على الشاشة (معيار إمكانية عرض إعلانات الفيديو من مكتب IAB)
VIDEO_IAB_VIEWABILITY_50 ‫50%أو أكثر من الإعلان معروض على الشاشة (معيار إمكانية عرض إعلانات الفيديو لمكتب IAB)
VIDEO_IAB_VIEWABILITY_75 ‫75%أو أكثر من الإعلان قابل للعرض (معيار إمكانية عرض الفيديو في مكتب IAB)

PoiAssignedTargetingOptionDetails

تفاصيل خيار استهداف نقطة الاهتمام المحدَّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_POI.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
الحقول
displayName

string

للعرض فقط. الاسم المعروض لنقطة الاهتمام، مثل "ميدان التايمز" أو "برج سبيس نيدل"، متبوعًا بعنوانه الكامل إذا كان متاحًا.
targetingOptionId

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_POI

يمكن استرداد أرقام تعريف خيارات استهداف نقاط الاهتمام المقبولة باستخدام targetingTypes.targetingOptions.search.

إذا كنت تستهدف إحداثيات خطوط عرض/طول معيّنة تمت إزالتها من عنوان أو اسم نقطة اهتمام، يمكنك إنشاء رقم تعريف خيار الاستهداف اللازم عن طريق تقريب قيم الإحداثيات المطلوبة إلى الخانة العشرية السادسة، وإزالة الأرقام العشرية، ودمج قيم السلسلة المفصولة بفاصلة منقوطة. على سبيل المثال، يمكنك استهداف زوج خطوط العرض/الطول ‎40.7414691, -74.003387 باستخدام رقم تعريف خيار الاستهداف "40741469;-74003387". عند الإنشاء، سيتم تعديل قيمة هذا الحقل لإلحاق فاصلة منقوطة و قيمة تجزئة أبجدية رقمية في حال تقديم إحداثيات خطوط العرض/الطول فقط.
latitude

number

للعرض فقط. خط العرض لنقطة الاهتمام مقرَّبًا إلى أقرب جزء من مليون
longitude

number

للعرض فقط. خط الطول لنقطة الاهتمام مقرَّبًا إلى أقرب جزء من مليون
proximityRadiusAmount

number

الحقل مطلوب. نطاق المنطقة المحيطة بنقطة الاهتمام التي سيتم استهدافها. يتم تحديد وحدات النطاق الجغرافي من خلال proximityRadiusUnit. يجب أن تتراوح القيمة بين 1 و800 إذا كانت الوحدة DISTANCE_UNIT_KILOMETERS وبين 1 و500 إذا كانت الوحدة DISTANCE_UNIT_MILES.
proximityRadiusUnit

enum (DistanceUnit)

الحقل مطلوب. وحدة المسافة التي يتم من خلالها قياس نطاق الاستهداف

DistanceUnit

خيارات وحدات المسافة المحتملة

عمليات التعداد
DISTANCE_UNIT_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنّها غير معروفة في هذا الإصدار.
DISTANCE_UNIT_MILES أميال.
DISTANCE_UNIT_KILOMETERS كيلومترات.

BusinessChainAssignedTargetingOptionDetails

تفاصيل خيار استهداف سلاسل المتاجر المعيّن سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_BUSINESS_CHAIN.

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
الحقول
displayName

string

للعرض فقط. الاسم المعروض لسلسلة تجارية، مثل "KFC" أو "Chase Bank".
targetingOptionId

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_BUSINESS_CHAIN

يمكن استرداد أرقام تعريف خيارات استهداف سلاسل الأنشطة التجارية المقبولة باستخدام SearchTargetingOptions.
proximityRadiusAmount

number

الحقل مطلوب. نطاق المنطقة المحيطة بسلسلة المتاجر التي سيتم استهدافها. يتم تحديد وحدات النطاق الجغرافي من خلال proximityRadiusUnit. يجب أن تتراوح القيمة بين 1 و800 إذا كانت الوحدة DISTANCE_UNIT_KILOMETERS وبين 1 و500 إذا كانت الوحدة DISTANCE_UNIT_MILES. الحدّ الأدنى للزيادة في كلتا الحالتَين هو 0.1. سيتم تقريب المدخلات إلى أقرب قيمة مقبولة إذا كانت دقيقة جدًا، على سبيل المثال، سيتم تقريب 15.57 إلى 15.6.
proximityRadiusUnit

enum (DistanceUnit)

الحقل مطلوب. وحدة المسافة التي يتم قياس نطاق الاستهداف بها

ContentDurationAssignedTargetingOptionDetails

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

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

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_DURATION
contentDuration

enum (ContentDuration)

للعرض فقط. مدة المحتوى

ContentStreamTypeAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لنوع مجموعة بث المحتوى ستتم تعبئة هذه القيمة في الحقل contentStreamTypeDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_STREAM_TYPE. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق ذلك، عليك إزالة جميع خيارات استهداف أنواع مصادر المحتوى.

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

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_STREAM_TYPE
contentStreamType

enum (ContentStreamType)

للعرض فقط. نوع مجموعة بث المحتوى

NativeContentPositionAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لموضع الإعلان المدمج مع المحتوى ستتم تعبئة هذه القيمة في الحقل nativeContentPositionDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_NATIVE_CONTENT_POSITION. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق ذلك، عليك إزالة جميع خيارات استهداف مواضع المحتوى الأصلي.

تمثيل JSON 
{
  "contentPosition": enum (NativeContentPosition)
}
الحقول
contentPosition

enum (NativeContentPosition)

الحقل مطلوب. موضع المحتوى

OmidAssignedTargetingOptionDetails

تمثّل نوع مساحة إعلانية مفعَّلة فيها ميزة "القياس المفتوح" ويمكن استهدافها. سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_OMID.

تمثيل JSON 
{
  "omid": enum (Omid)
}
الحقول
omid

enum (Omid)

الحقل مطلوب. نوع المساحة الإعلانية التي تم تفعيل "القياس المفتوح" فيها

AudioContentTypeAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لنوع المحتوى الصوتي ستتم تعبئة هذه القيمة في الحقل audioContentTypeDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_AUDIO_CONTENT_TYPE. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق ذلك، يجب إزالة جميع خيارات استهداف أنواع المحتوى الصوتي.

تمثيل JSON 
{
  "audioContentType": enum (AudioContentType)
}
الحقول
audioContentType

enum (AudioContentType)

الحقل مطلوب. نوع المحتوى الصوتي

ContentGenreAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المحدّد لنوع المحتوى ستتم تعبئة هذه القيمة في الحقل contentGenreDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_GENRE. لا يمكن استهداف جميع الخيارات بشكل صريح. لتحقيق هذا التأثير، يجب إزالة جميع خيارات استهداف أنواع المحتوى.

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

string

الحقل مطلوب. حقل targetingOptionId عندما تكون قيمة targetingType هي TARGETING_TYPE_CONTENT_GENRE
displayName

string

للعرض فقط. الاسم المعروض لنوع المحتوى
negative

boolean

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

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

معرّف فيديو على YouTube كما يظهر على صفحة المشاهدة في YouTube
negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

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

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

string

معرّف القناة على YouTube التي حمّلت الفيديو أو رمز القناة على YouTube
negative

boolean

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

SessionPositionAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "sessionPosition": enum (SessionPosition)
}
الحقول
sessionPosition

enum (SessionPosition)

الموضع الذي سيظهر فيه الإعلان خلال الجلسة

SessionPosition

المواضع المحتملة في الجلسة

عمليات التعداد
SESSION_POSITION_UNSPECIFIED هذا عنصر نائب، ولا يشير إلى أي مواضع.
SESSION_POSITION_FIRST_IMPRESSION تمثّل هذه السمة الظهور الأول للجلسة.

LookalikeAudienceAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف الجمهور المشابه سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_LOOKALIKE_AUDIENCE.

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

string (int64 format)

الحقل مطلوب. رقم تعريف شريحة الجمهور المشابهة
negative

boolean

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

GoogleAudienceAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف الجمهور من Google سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_GOOGLE_AUDIENCE.

تمثيل JSON 
{
  "googleAudienceId": string,
  "googleAudienceType": enum (GoogleAudienceType),
  "negative": boolean
}
الحقول
googleAudienceId

string (int64 format)

الحقل مطلوب. رقم تعريف شريحة الجمهور من Google
googleAudienceType

enum (GoogleAudienceType)

الحقل مطلوب. نوع جمهور Google
negative

boolean

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

CustomListAssignedTargetingOptionDetails

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

تمثيل JSON 
{
  "customListId": string,
  "customListType": enum (CustomListType)
}
الحقول
customListId

string (int64 format)

الحقل مطلوب. رقم تعريف قائمة العملاء
customListType

enum (CustomListType)

الحقل مطلوب. نوع القائمة المخصّصة

CustomListType

الأنواع المحتملة لقائمة العملاء

عمليات التعداد
CUSTOM_LIST_TYPE_UNSPECIFIED القيمة التلقائية عندما لا يكون النوع محدّدًا أو عندما يكون غير معروف
CUSTOM_LIST_TYPE_CUSTOM_AFFINITY قائمة مخصّصة لنوع الجمهور المخصّص ذي الاهتمامات المشتركة
CUSTOM_LIST_TYPE_CUSTOM_INTENT قائمة مخصّصة من نوع الجمهور المخصّص حسب النية بالشراء

CombinedAudienceAssignedTargetingOptionDetails

تفاصيل خيار استهداف الجمهور المجمّع سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_COMBINED_AUDIENCE.

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

string (int64 format)

الحقل مطلوب. رقم تعريف شريحة الجمهور المجمَّعة

FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف جمهور الطرف الأول والشركاء سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.

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

string (int64 format)

الحقل مطلوب. رقم تعريف جمهور الطرف الأول أو الشريك
negative

boolean

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

AuctionPackageAssignedTargetingOptionDetails

تفاصيل خيار استهداف حزمة المزاد المحدَّدة سيتم ملء هذا الحقل في حقل التفاصيل الخاص بـ AssignedTargetingOption عندما يكون targetingType هو TARGETING_TYPE_AUCTION_PACKAGE.

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

string

الحقل مطلوب. ‫targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_AUCTION_PACKAGE
displayName

string

للعرض فقط. الاسم المعروض لحزمة المزاد

YoutubeChannelPackAssignedTargetingOptionDetails

تفاصيل حول خيار الاستهداف المحدّد لحزمة قنوات على YouTube ستتم تعبئة هذه القيمة في الحقل youtubeChannelPackDetails عندما تكون قيمة targetingType هي TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

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

string (int64 format)

الحقل مطلوب. معرّف حزمة قنوات YouTube
negative

boolean

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

الاكتساب

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

عمليات التعداد
INHERITANCE_UNSPECIFIED الوراثة غير محدّدة أو غير معروفة.
NOT_INHERITED لم يتم اكتساب خيار الاستهداف المحدّد من جهة ذات مستوى أعلى.
INHERITED_FROM_PARTNER يتم اكتساب خيار الاستهداف المحدّد من إعدادات استهداف الشريك.
INHERITED_FROM_ADVERTISER يتم اكتساب خيار الاستهداف المحدّد من إعدادات استهداف المعلِن.

الطُرق

create

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

delete

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

get

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

list

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