CampaignCriterion

معيار حملة.

تمثيل JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "campaign": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "adSchedule": {
    object (AdScheduleInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "proximity": {
    object (ProximityInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "listingScope": {
    object (ListingScopeInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "ipBlock": {
    object (IpBlockInfo)
  },
  "contentLabel": {
    object (ContentLabelInfo)
  },
  "carrier": {
    object (CarrierInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "operatingSystemVersion": {
    object (OperatingSystemVersionInfo)
  },
  "mobileDevice": {
    object (MobileDeviceInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "keywordTheme": {
    object (KeywordThemeInfo)
  },
  "localServiceId": {
    object (LocalServiceIdInfo)
  },
  "brandList": {
    object (BrandListInfo)
  }
  // End of list of possible types for union field criterion.
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لمعيار الحملة. تكون أسماء موارد معايير الحملة على النحو التالي:

customers/{customerId}/campaignCriteria/{campaignId}~{criterionId}
displayName

string

النتائج فقط. الاسم المعروض للمعيار.

يتم تجاهل هذا الحقل لعمليات التبديل.
type

enum (CriterionType)

النتائج فقط. نوع المعيار.
status

enum (CampaignCriterionStatus)

حالة المعيار.
campaign

string

غير قابل للتغيير. الحملة التي ينتمي إليها المعيار.
criterionId

string (int64 format)

النتائج فقط. رقم تعريف المعيار.

يتم تجاهل هذا الحقل أثناء عملية التبديل.
bidModifier

number

معدِّل عروض الأسعار عندما يتطابق المعيار. يجب أن يكون المعدَّل ضمن النطاق: 0.1 - 10.0. تتوافق معظم أنواع المعايير القابلة للاستهداف مع المعدِّلات. استخدِم 0 لإيقاف نوع جهاز.
negative

boolean

غير قابل للتغيير. تحديد ما إذا كان سيتم استهداف (false) أو استبعاد (true) المعيار.

حقل الاتحاد criterion معيار الحملة.

يجب ضبط واحد بالضبط. يمكن أن يكون الحقل "criterion" واحدًا فقط مما يلي:
keyword

object (KeywordInfo)

غير قابل للتغيير. الكلمة الرئيسية.
placement

object (PlacementInfo)

غير قابل للتغيير. الموضع:
mobileAppCategory

object (MobileAppCategoryInfo)

غير قابل للتغيير. فئة تطبيقات الأجهزة الجوّالة.
mobileApplication

object (MobileApplicationInfo)

غير قابل للتغيير. تطبيق للأجهزة الجوّالة.
location

object (LocationInfo)

غير قابل للتغيير. الموقع الجغرافي.
device

object (DeviceInfo)

غير قابل للتغيير. الجهاز.
adSchedule

object (AdScheduleInfo)

غير قابل للتغيير. جدول عرض الإعلانات.
ageRange

object (AgeRangeInfo)

غير قابل للتغيير. الفئة العمرية.
gender

object (GenderInfo)

غير قابل للتغيير. الجنس.
incomeRange

object (IncomeRangeInfo)

غير قابل للتغيير. نطاق الدخل.
parentalStatus

object (ParentalStatusInfo)

غير قابل للتغيير. الحالة الأبوية.
userList

object (UserListInfo)

غير قابل للتغيير. قائمة المستخدمين.
youtubeVideo

object (YouTubeVideoInfo)

غير قابل للتغيير. فيديو YouTube
youtubeChannel

object (YouTubeChannelInfo)

غير قابل للتغيير. قناة YouTube
proximity

object (ProximityInfo)

غير قابل للتغيير. التقارب.
topic

object (TopicInfo)

غير قابل للتغيير. الموضوع.
listingScope

object (ListingScopeInfo)

غير قابل للتغيير. نطاق بطاقة البيانات
language

object (LanguageInfo)

غير قابل للتغيير. اللغة
ipBlock

object (IpBlockInfo)

غير قابل للتغيير. IpBlock.
contentLabel

object (ContentLabelInfo)

غير قابل للتغيير. تصنيف المحتوى
carrier

object (CarrierInfo)

غير قابل للتغيير. مشغّل شبكة الجوّال
userInterest

object (UserInterestInfo)

غير قابل للتغيير. اهتمام المستخدم
webpage

object (WebpageInfo)

غير قابل للتغيير. صفحة ويب
operatingSystemVersion

object (OperatingSystemVersionInfo)

غير قابل للتغيير. إصدار نظام التشغيل
mobileDevice

object (MobileDeviceInfo)

غير قابل للتغيير. جهاز جوّال.
locationGroup

object (LocationGroupInfo)

غير قابل للتغيير. مجموعة المواقع الجغرافية
customAffinity

object (CustomAffinityInfo)

غير قابل للتغيير. الجمهور المخصّص ذو اهتمامات مشتركة.
customAudience

object (CustomAudienceInfo)

غير قابل للتغيير. الجمهور المخصّص
combinedAudience

object (CombinedAudienceInfo)

غير قابل للتغيير. الجمهور المشترك.
keywordTheme

object (KeywordThemeInfo)

غير قابل للتغيير. موضوع الكلمات الرئيسية للحملة الذكية
localServiceId

object (LocalServiceIdInfo)

غير قابل للتغيير. معيار حملة خدمة GLS.
brandList

object (BrandListInfo)

غير قابل للتغيير. معيار حملة قائمة العلامات التجارية.

CampaignCriterionStatus

الحالات المحتملة لمعيار الحملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
ENABLED معيار الحملة مفعّل.
PAUSED معيار الحملة متوقف مؤقتًا.
REMOVED تمت إزالة معيار الحملة.

ListingScopeInfo

معيار نطاق البيانات.

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

object (ListingDimensionInfo)

نطاق معيار الحملة.

CarrierInfo

يمثّل معيار مشغِّل شبكة الجوّال.

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

string

اسم المورد الثابت لدى مشغّل شبكة الجوّال

OperatingSystemVersionInfo

يمثّل هذا النوع إصدار نظام التشغيل المستهدَف.

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

string

اسم المورد الثابت لإصدار نظام التشغيل

MobileDeviceInfo

معيار جهاز جوّال.

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

string

اسم المورد الثابت في جهاز الجوّال.

LocationGroupInfo

نطاق جغرافي حول قائمة مواقع جغرافية محدّدة من خلال خلاصة أو assetSet.

تمثيل JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "locationGroupAssetSets": [
    string
  ],
  "feed": string,
  "radius": string,
  "enableCustomerLevelLocationAssetSet": boolean
}
الحقول
geoTargetConstants[]

string

ثوابت الاستهداف الجغرافي التي تفرض قيودًا على نطاق المنطقة الجغرافية في الخلاصة في الوقت الحالي، يُسمح باستخدام ثابت واحد فقط للاستهداف الجغرافي. لا يمكن الضبط باستخدام حقول AssetSet.
radiusUnits

enum (LocationGroupRadiusUnits)

وحدة النطاق الجغرافي يمكن استخدام الأميال والأمتار لثوابت الهدف الجغرافي. يُسمح بالمللي الأميال والمترات لمجموعات عناصر الخلاصة ومجموعات مواد العرض. هذا مطلوب ويجب تعيينه في عمليات CREATE.
feedItemSets[]

string

FeedItemSets الذي تم استهداف عناصر FeedItems به. في حال تحديد أرقام تعريف متعددة، سيتم استهداف جميع العناصر التي تظهر في مجموعة واحدة على الأقل. لا يمكن استخدام هذا الحقل مع geoTargetConstants. هذا الإجراء اختياري ولا يمكن ضبطه إلا في عمليات CREATE. لا يمكن الضبط باستخدام حقول AssetSet.
locationGroupAssetSets[]

string

مجموعات مواد العرض التي يتم استهداف مواد العرض الخاصة بها. في حال تحديد أرقام تعريف متعددة، سيتم استهداف جميع العناصر التي تظهر في مجموعة واحدة على الأقل. لا يمكن استخدام هذا الحقل مع الخلاصة أو ثوابت الاستهداف الجغرافي أو مجموعات عناصر الخلاصة. عند استخدام مجموعات مواد العرض، يجب تحديد هذا الحقل أوenableCustomerLevelLocationAssetSet. ولا يمكن استخدام كليهما في الوقت نفسه. لا يمكن تعيين هذا إلا في عمليات CREATE.
feed

string

خلاصة تحدّد المواقع الجغرافية للاستهداف. لا يمكن الضبط باستخدام حقول AssetSet. هذا مطلوب ويجب تعيينه في عمليات CREATE.
radius

string (int64 format)

المسافة بالوحدات التي تحدد النطاق الجغرافي حول المواقع المستهدفة. هذا مطلوب ويجب تعيينه في عمليات CREATE.
enableCustomerLevelLocationAssetSet

boolean

تشير إلى أنّ أحدث مجموعة مواد عرض على مستوى العميل تُستخدَم للاستهداف. تُستخدم مع radius وradiusUnits. لا يمكن استخدامه مع الخلاصة أو ثوابت الاستهداف الجغرافي أو مجموعات عناصر الخلاصة. عند استخدام مجموعات مواد العرض، يجب تحديد هذا الحقل أو locationGroupAssetSets. ولا يمكن استخدام كليهما في الوقت نفسه. لا يمكن تعيين هذا إلا في عمليات CREATE.

LocationGroupRadiusUnits

وحدة مسافة النطاق الجغرافي في مجموعة المواقع الجغرافية (على سبيل المثال، MILES)

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
METERS متر
MILES ميل
MILLI_MILES ملي ميل

LocalServiceIdInfo

رقم تعريف خدمة في "إعلانات الخدمات المحلّية". يُمثِّل هذا النوع نوع خدمة (مثل install_faucet) يمكن أن تستهدِفه "حملة خدمات محلية".

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

string

اسم مورد المعيار.

BrandListInfo

يُستخدم معيار قائمة العلامات التجارية لتحديد قائمة من العلامات التجارية. يتم تمثيل القائمة على هيئة نوع معرّف SharedSet BRAND_HINT. يمكن استهداف معيار من هذا النوع أو استبعاده.

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

string

اسم مورد المجموعة المشتركة لقائمة العلامات التجارية.