REST Resource: advertisers.campaigns.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)

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

الاكتساب

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

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

ChannelAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف القناة الذي تمّ تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_CHANNEL".

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

string (int64 format)

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

boolean

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

AppCategoryAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف فئة التطبيق الذي تم تعيينه ستتم تعبئة هذا الحقل في الحقل appCategoryDetails ضمن خيار استهداف معيَّن عندما تكون قيمة الحقل 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

تفاصيل خيار استهداف التطبيق الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_APP".

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

string

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

يستخدم تطبيق "متجر Play" على جهاز Android معرِّف الحزمة، على سبيل المثال com.google.android.gm. يستخدِم رقم تعريف التطبيق على متجر التطبيقات من Apple سلسلة من 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.
APP_PLATFORM_ANDROID_TV ومنصة التطبيق هي Android TV.
APP_PLATFORM_GENERIC_CTV ومنصة التطبيق هي منصة للتلفزيون المتّصل وغير مُدرَجة صراحةً في مكان آخر.

UrlAssignedTargetingOptionDetails

تفاصيل خيار استهداف عنوان URL الذي تمّ تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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)

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

DayOfWeek

يمثّل أحد أيام الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED لم يتم تحديد يوم من الأسبوع.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

TimeZoneResolution

الأساليب الممكنة لحل المنطقة الزمنية.

عمليات التعداد
TIME_ZONE_RESOLUTION_UNSPECIFIED درجة دقة المنطقة الزمنية إما غير محدّدة أو غير معروفة.
TIME_ZONE_RESOLUTION_END_USER يتم تحديد الأوقات وفقًا للمنطقة الزمنية للمستخدم الذي رأى الإعلان.
TIME_ZONE_RESOLUTION_ADVERTISER يتم تحديد الأوقات وفقًا للمنطقة الزمنية للمعلِن الذي عرض الإعلان.

AgeRangeAssignedTargetingOptionDetails

يمثل فئة عمرية قابلة للاستهداف. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_AGE_RANGE".

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

enum (AgeRange)

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

RegionalLocationListAssignedTargetingOptionDetails

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

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

string (int64 format)

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

boolean

يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي.

ProximityLocationListAssignedTargetingOptionDetails

تفاصيل الاستهداف لقائمة المواقع الجغرافية القريبة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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 يمثّل هذا حجم المنطقة المحيطة بالموقع الجغرافي المحدّد الذي سيتم استهدافه. يجب أن يتراوح النطاق بين 1 و500 ميل أو 800 كيلومتر.
proximityRadiusUnit

enum (ProximityRadiusUnit)

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

ProximityRadiusUnit

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

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

GenderAssignedTargetingOptionDetails

تفاصيل خيار استهداف الجنس الذي تم تعيينه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل حول خيار استهداف الحالة الأبوية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل الاستهداف لنوع الجهاز ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل خيار استهداف مجموعة الجمهور المعينة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_AUDIENCE_GROUP". العلاقة بين كل مجموعة هي UNION، باستثناء كائن "excludedFirstAndrdParty AudienceGroup" و"excludedGoogle AudienceGroup"، اللذين يتم استخدام "COMPLEMENT" منهما كـ "تتبُّع" مع مجموعات أخرى.

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

object (FirstAndThirdPartyAudienceGroup)

أرقام تعريف جمهور الطرف الأول والطرف الثالث وحالات ورودهما لمجموعات جمهور الطرف الأول والطرف الثالث المضمّنة. تحتوي كل مجموعة جمهور للطرف الأول والطرف الثالث على أرقام تعريف جمهور للطرف الأول والطرف الثالث فقط. العلاقة بين كل مجموعة جمهور تابعة للطرف الأول وأخرى تابعة لطرف ثالث تُقسم إلى انبعاث، والنتيجة هي UNION مع مجموعات جمهور أخرى. سيتم تجاهل المجموعات المكرّرة التي تم تطبيق الإعدادات نفسها عليها.
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

object (CustomListGroup)

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

object (CombinedAudienceGroup)

أرقام تعريف الجمهور المُجمَّعة لمجموعة الجمهور المُجمَّعة المضمنة. يحتوي على أرقام تعريف شرائح جمهور مُجمَّعة فقط.
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

أرقام تعريف جمهور الطرف الأول والطرف الثالث وحالات ورودها لكل من مجموعة جمهور الطرف الأول والطرف الثالث المستبعدة. تُستخدَم للاستهداف السلبي. يُستخدم تكملة اتحاد هذه المجموعة ومجموعات الجمهور المستبعدة الأخرى كنقطة بداية لأي استهداف إيجابي للجمهور. جميع العناصر هي "OR" منطقيًا من بعضها.
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

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

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

تفاصيل إعداد استهداف جمهور الطرف الأول والطرف الثالث.

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

string (int64 format)

مطلوبة. رقم تعريف جمهور الطرف الأول والطرف الثالث لإعداد استهداف جمهور الطرف الأول والطرف الثالث. هذا المعرّف هو firstAndThirdPartyAudienceId.
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 يومًا.

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.

BrowserAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف المتصفّح الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_BROWSER".

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

string

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

string

مطلوبة. السمة targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_BROWSER.
negative

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

تفاصيل حول خيار استهداف دخل الأسرة المحدّد ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل حول خيار استهداف مشغّل شبكة الجوّال ومزوّد خدمة الإنترنت المعيّن ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل خيار استهداف الكلمات الرئيسية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_KEYWORD".

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

string

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

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

boolean

يشير هذا العمود إلى ما إذا كان يتم استهداف هذا الخيار بشكلٍ سلبي.

NegativeKeywordListAssignedTargetingOptionDetails

تفاصيل الاستهداف لقائمة الكلمات الرئيسية السلبية ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل خيار استهداف البيئة المعيّنة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_ENVIRONMENT".

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

enum (Environment)

مطلوبة. تمثّل هذه السمة بيئة العرض.

InventorySourceAssignedTargetingOptionDetails

تفاصيل الاستهداف لمصدر المستودع ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_INVENTORY_SOURCE".

تمثيل 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 ضمن خيار استهداف معيَّن عندما تكون قيمة الحقل targetingType هي TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

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

AuthorizedSellerStatusAssignedTargetingOptionDetails

تُمثِّل هذه السمة حالة بائع معتمَدة. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل خيار استهداف اللغة الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_LANGUAGE".

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

string

النتائج فقط. الاسم المعروض للغة (على سبيل المثال، "الفرنسية").
targetingOptionId

string

مطلوبة. السمة targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_LANGUAGE.
negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

تفاصيل خيار استهداف المنطقة الجغرافية الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

تفاصيل الاستهداف لمجموعة مصدر المستودع الإعلاني ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_INVENTORY_SOURCE_GROUP".

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

string (int64 format)

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

DigitalContentLabelAssignedTargetingOptionDetails

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

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

تفاصيل الاستهداف للفئة الإعلانية الحساسة ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION".

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

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

تفاصيل خيار استهداف التبادل المعيّن ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_EXCHANGE".

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

enum (Exchange)

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

SubExchangeAssignedTargetingOptionDetails

تفاصيل خيار استهداف التبادل الفرعي الذي تم تعيينه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_SUB_EXCHANGE".

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

string

مطلوبة. السمة targetingOptionId لـ TargetingOption من النوع TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

تفاصيل خيار الاستهداف المخصّص لأداة التحقّق التابعة لجهة خارجية. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_THIRD_PARTY_VERIFIER".

تمثيل JSON 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
الحقول
حقل الاتحاد verifier يمكن استهداف إحدى أدوات التحقّق التابعة لجهة خارجية من أجل فرض حدود أمان العلامة التجارية لمرات الظهور. يمكن أن يكون الحقل "verifier" واحدًا فقط مما يلي:
adloox

object (Adloox)

أداة التحقق من العلامات التجارية التابعة لجهة خارجية -- Adloox
doubleVerify

object (DoubleVerify)

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

object (IntegralAdScience)

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

Adloox

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

تمثيل JSON 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
الحقول
excludedAdlooxCategories[]

enum (AdlooxCategory)

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

AdlooxCategory

خيارات Adloox محتملة.

عمليات التعداد
ADLOOX_UNSPECIFIED هذا التعداد هو فقط عنصر نائب ولا يحدد أي خيار في Adloox.
ADULT_CONTENT_HARD المحتوى المخصّص للبالغين (الصعب)
ADULT_CONTENT_SOFT محتوى للبالغين (محتوى خفيف)
ILLEGAL_CONTENT محتوى غير قانوني.
BORDERLINE_CONTENT المحتوى القريب من مخالفة السياسات
DISCRIMINATORY_CONTENT المحتوى الذي ينطوي على تمييز:
VIOLENT_CONTENT_WEAPONS المحتوى الذي يتضمّن عنفًا وأسلحة
LOW_VIEWABILITY_DOMAINS نطاقات إمكانية العرض المنخفضة:
FRAUD الاحتيال

DoubleVerify

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

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

object (BrandSafetyCategories)

عناصر التحكّم في أمان العلامة التجارية على DV
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 الكارثة: مركبة.
ALCOHOL العقاقير/الكحول/المواد الخاضعة للرقابة: الكحول.
SMOKING العقاقير/الكحول/المواد الخاضعة للرقابة: التدخين.
NEGATIVE_NEWS_FINANCIAL الأخبار السلبية: المالية.
NON_ENGLISH المحتوى غير القياسي: بالإنجليزية
PARKING_PAGE محتوى غير قياسي: صفحة موقف السيارات
UNMODERATED_UGC المحتوى الذي ينشئه المستخدمون غير الخاضع للإشراف: المنتديات والصور والفيديوهات
INFLAMMATORY_POLITICS_AND_NEWS المواضيع المثيرة للجدل: سياسة وأخبار تحريضية.
NEGATIVE_NEWS_PHARMACEUTICAL أخبار سلبية: المستحضرات الصيدلانية

AgeRating

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

عمليات التعداد
AGE_RATING_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات للتقييم حسب الفئة العمرية.
APP_AGE_RATE_UNKNOWN التطبيقات التي لها تقييم عمر غير معروف
APP_AGE_RATE_4_PLUS التطبيقات التي تم تقييمها للجميع (بعمر 4 سنوات أو أكثر)
APP_AGE_RATE_9_PLUS التطبيقات التي تم تقييمها للجميع (بعمر 9 سنوات أو أكثر)
APP_AGE_RATE_12_PLUS التطبيقات التي تم تقييمها للمراهقين (بعمر 12 عامًا وما فوق)
APP_AGE_RATE_17_PLUS التطبيقات المصنّفة للبالغين (17 عامًا وما فوق)
APP_AGE_RATE_18_PLUS التطبيقات التي تم تقييمها للبالغين فقط (بعمر 18 عامًا وما فوق)

AppStarRating

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

تمثيل JSON 
{
  "avoidedStarRating": enum (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

تفاصيل إعدادات إمكانية العرض في DoubleClick Display.

تمثيل 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)

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

VideoIAB

الخيارات المتاحة لنسبة IAB القابلة للعرض

عمليات التعداد
VIDEO_IAB_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمعدل العرض القابل للعرض في مكتب IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة% 80 أو أعلى.
IAB_VIEWABILITY_75_PERCENT_HIGHER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 75% أو أعلى.
IAB_VIEWABILITY_70_PERCENT_HIGHER استهدف مستودعًا إعلانيًا على الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 70% أو أعلى.
IAB_VIEWABILITY_65_PERCENT_HIHGER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة% 65 أو أعلى.
IAB_VIEWABILITY_60_PERCENT_HIGHER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 60% أو أعلى.
IAB_VIEWABILITY_55_PERCENT_HIHGER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 55% أو أعلى.
IAB_VIEWABILITY_50_PERCENT_HIGHER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 50% أو أعلى.
IAB_VIEWABILITY_40_PERCENT_HIHGER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 40% أو أعلى.
IAB_VIEWABILITY_30_PERCENT_HIHGER استهدف مستودع إعلانات الويب والتطبيقات لزيادة نسبة إمكانية العرض لمكتب الإعلانات التفاعلية (IAB) بنسبة 30% أو أعلى.

VideoViewableRate

الخيارات الممكنة لنسبة العرض بالكامل

عمليات التعداد
VIDEO_VIEWABLE_RATE_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمعدل إمكانية عرض الفيديو.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض بالكامل بنسبة 40% أو أعلى.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 35% أو أعلى.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 30% أو أعلى.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER استهدف مستودعًا على الويب لزيادة نسبة إمكانية العرض بالكامل بنسبة 25% أو أعلى.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 20% أو أعلى.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER استهدف مستودعًا على الويب لزيادة نسبة العرض الكامل للعرض إلى أقصى حد بنسبة 10% أو أعلى.

PlayerImpressionRate

الخيارات المحتملة لمرات الظهور.

عمليات التعداد
PLAYER_SIZE_400X300_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات لمرات الظهور.
PLAYER_SIZE_400X300_95 المواقع التي حققت أكثر من 95%من مرات الظهور.
PLAYER_SIZE_400X300_70 المواقع التي حققت أكثر من 70%من مرات الظهور.
PLAYER_SIZE_400X300_25 المواقع التي يزيد عدد مرات ظهورها عن 25%.
PLAYER_SIZE_400X300_5 المواقع التي يزيد عدد مرات ظهورها عن 5%.

FraudInvalidTraffic

إعدادات DoubleClick Search لالاحتيال والزيارات غير الصالحة

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

enum (FraudOption)

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

boolean

إحصاءات غير كافية حول الاحتيال والزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT)

FraudOption

الخيارات المتاحة للمعدّل السابق للاحتيال والإحالات الناجحة غير الصالحة (IVT)

عمليات التعداد
FRAUD_UNSPECIFIED وهذا التعداد هو مجرد عنصر نائب ولا يحدّد أي خيارات للاحتيال أو الزيارات غير الصالحة.
AD_IMPRESSION_FRAUD_100 الاحتيال ونسبة الزيارات غير الصالحة بالكامل
AD_IMPRESSION_FRAUD_50 50% أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT).
AD_IMPRESSION_FRAUD_25 %25 أو عمليات احتيال أو زيارات غير صالحة ناشئة عن تقنيات معروفة (IVT).
AD_IMPRESSION_FRAUD_10 10% أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT).
AD_IMPRESSION_FRAUD_8 8% أو ارتفاع نسبة الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT).
AD_IMPRESSION_FRAUD_6 6% أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT)
AD_IMPRESSION_FRAUD_4 4% أو ارتفاع نسبة الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT).
AD_IMPRESSION_FRAUD_2 زيادة بنسبة% 2 أو معدّل أعلى من الاحتيال أو الزيارات غير الصالحة الناشئة عن تقنيات معروفة (IVT).

IntegralAdScience

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

تمثيل JSON 
{
  "traqScoreOption": enum (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
  ]
}
الحقول
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، بشكل شامل.

TRAQScore

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

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

للبالغين

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

عمليات التعداد
ADULT_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات للبالغين.
ADULT_HR الأشخاص البالغون - استثناء المخاطر العالية
ADULT_HMR الأشخاص البالغون - استبعاد المخاطر العالية والمعتدلة.

المشروبات الكحولية

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

عمليات التعداد
ALCOHOL_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات للكحول.
ALCOHOL_HR الكحول - استبعد المخاطر العالية.
ALCOHOL_HMR الكحول - استبعِد المخاطر العالية والمعتدلة.

IllegalDownloads

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

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

مخدرات

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

عمليات التعداد
DRUGS_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدد أي خيارات للأدوية.
DRUGS_HR الأدوية - باستثناء المخاطر العالية
DRUGS_HMR الأدوية - استبعِد المخاطر العالية والمعتدلة.

HateSpeech

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

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

OffensiveLanguage

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

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

العنف

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

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

المقامرة

خيارات المقامرة الممكنة في علوم الإعلانات المتكاملة.

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

AdFraudPrevention

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

عمليات التعداد
SUSPICIOUS_ACTIVITY_UNSPECIFIED هذا التعداد هو مجرد عنصر نائب ولا يحدِّد أي خيارات لمنع الاحتيال الإعلاني.
SUSPICIOUS_ACTIVITY_HR الاحتيال الإعلاني - استبعاد المخاطر العالية
SUSPICIOUS_ACTIVITY_HMR الاحتيال الإعلاني: استبعاد المخاطر العالية والمعتدلة

DisplayViewability

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

عمليات التعداد
PERFORMANCE_VIEWABILITY_UNSPECIFIED هذا التعداد هو فقط عنصر نائب ولا يحدِّد أي خيارات لإمكانية العرض.
PERFORMANCE_VIEWABILITY_40 استهداف إمكانية العرض بنسبة% 40 أو معدّل أعلى
PERFORMANCE_VIEWABILITY_50 استهداف إمكانية العرض بنسبة 50% أو أعلى:
PERFORMANCE_VIEWABILITY_60 يمكنك استهداف إمكانية العرض بنسبة% 60 أو قيمة أعلى.
PERFORMANCE_VIEWABILITY_70 يمكنك استهداف إمكانية العرض بنسبة% 70 أو معدّل أعلى.

VideoViewability

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

عمليات التعداد
VIDEO_VIEWABILITY_UNSPECIFIED هذا التعداد هو فقط عنصر نائب ولا يحدد أي خيارات لإمكانية عرض الفيديو.
VIDEO_VIEWABILITY_40 +40%في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB).
VIDEO_VIEWABILITY_50 نسبة%50 أو أكثر في العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB).
VIDEO_VIEWABILITY_60 +60%في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB)
VIDEO_VIEWABILITY_70 +70%في إطار العرض (معيار إمكانية عرض الفيديو الصادر عن مكتب IAB).

PoiAssignedTargetingOptionDetails

تفاصيل خيار استهداف نقطة الاهتمام الذي تم تخصيصه ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "targetingType" مضبوطة على "TARGETING_TYPE_POI".

تمثيل JSON 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (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

تفاصيل لخيار استهداف سلسلة الأنشطة التجارية المحدّد ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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

يُمثِّل ذلك نوع مستودع تمّ تفعيل ميزة "القياس المفتوح" عليه ويمكن استهدافه. ستتم تعبئة هذا الحقل في حقل التفاصيل ضِمن خيار استهداف إسناده عندما تكون قيمة الحقل "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 الانطباع الأول عن الجلسة.

الطُرق

get

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

list

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