UserList

قائمة مستخدمين هذه قائمة بالمستخدمين الذين قد يستهدفهم العميل.

تمثيل JSON 
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
الحقول
resourceName

string

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

customers/{customerId}/userLists/{userListId}
membershipStatus

enum (UserListMembershipStatus)

حالة العضوية لقائمة المستخدمين هذه. يشير إلى ما إذا كانت قائمة المستخدمين مفتوحة أو نشطة. يمكن أن تؤدي قوائم المستخدمين المفتوحة فقط إلى تجميع المزيد من المستخدمين واستهدافهم.
sizeRangeForDisplay

enum (UserListSizeRange)

النتائج فقط. نطاق الحجم من حيث عدد مستخدمي قائمة المستخدمين على شبكة Google الإعلانية

هذا الحقل للقراءة فقط.
type

enum (UserListType)

النتائج فقط. نوع هذه القائمة

هذا الحقل للقراءة فقط.
closingReason

enum (UserListClosingReason)

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

enum (AccessReason)

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

هذا الحقل للقراءة فقط.
accountUserListStatus

enum (UserListAccessStatus)

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

string (int64 format)

النتائج فقط. رقم تعريف قائمة المستخدمين.
readOnly

boolean

النتائج فقط. خيار يشير إلى ما إذا كان بإمكان المستخدم تعديل قائمة. تعتمد على ملكية القائمة ونوع القائمة. على سبيل المثال، لا يمكن تعديل قوائم مستخدمي تجديد النشاط التسويقي الخارجي.

هذا الحقل للقراءة فقط.
name

string

اسم قائمة المستخدمين هذه. قد لا يكون اسم قائمة المستخدمين فريدًا بناءً على سبب الوصول إليه (على سبيل المثال، إذا كانت accessreason=SHARED)
description

string

وصف قائمة المستخدمين هذه.
integrationCode

string

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

string (int64 format)

عدد أيام بقاء ملف تعريف ارتباط المستخدم في قائمتك منذ آخر إضافة له إلى القائمة. يجب أن تتراوح قيمة هذا الحقل بين 0 و540 بشكل شامل. ومع ذلك، بالنسبة إلى قوائم المستخدمين المستندة إلى إدارة علاقات العملاء، يمكن ضبط هذا الحقل على 10,000، ما يعني عدم انتهاء صلاحية.

يتم تجاهل هذا الحقل لنوعَي logicalUserList وRuleBaseUserList. تعتمد العضوية في قوائم من هذه الأنواع على القواعد التي تحددها القوائم.
sizeForDisplay

string (int64 format)

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

هذا الحقل للقراءة فقط.
eligibleForDisplay

boolean

النتائج فقط. يشير إلى أن قائمة المستخدمين هذه مؤهَّلة لشبكة Google الإعلانية.

هذا الحقل للقراءة فقط.
matchRatePercentage

integer

النتائج فقط. يشير إلى نسبة المطابقة لقوائم مطابقة العملاء. نطاق هذا الحقل هو [0-100]. وسيكون هذا الحقل فارغًا لأنواع القوائم الأخرى أو عندما لا يكون من الممكن حساب نسبة المطابقة.

هذا الحقل للقراءة فقط.

حقل الاتحاد user_list قائمة المستخدمين

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

object (CrmBasedUserListInfo)

قائمة مستخدمي نظام إدارة علاقات العملاء (CRM) المقدَّمة من المعلِن.
similarUserList

object (SimilarUserListInfo)

النتائج فقط. قائمة مستخدمين مشابهة لمستخدمين من قائمة مستخدمين أخرى. هذه القوائم للقراءة فقط وتنشئها Google تلقائيًا.
ruleBasedUserList

object (RuleBasedUserListInfo)

قائمة المستخدمين التي تم إنشاؤها من خلال قاعدة.
logicalUserList

object (LogicalUserListInfo)

قائمة المستخدمين وهي مجموعة مخصّصة من قوائم المستخدمين واهتماماتهم.
basicUserList

object (BasicUserListInfo)

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

UserListMembershipStatus

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
OPEN الحالة "مفتوح" - تجمع القائمة أعضاء ويمكن استهدافها.
CLOSED الحالة "مغلق" - لا تتم إضافة أعضاء جدد. ولا يمكن استخدامه للاستهداف.

UserListSizeRange

يشير هذا المقياس إلى التعداد الذي يتضمّن نطاقات حجم قائمة المستخدمين المحتمَلة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
LESS_THAN_FIVE_HUNDRED تتضمّن قائمة المستخدمين أقل من 500 مستخدم.
LESS_THAN_ONE_THOUSAND تتضمّن قائمة المستخدمين عدد مستخدمين يتراوح بين 500 و1000 مستخدم.
ONE_THOUSAND_TO_TEN_THOUSAND تضم قائمة المستخدمين عدد مستخدمين يتراوح بين 1000 و10,000 مستخدم.
TEN_THOUSAND_TO_FIFTY_THOUSAND تضم قائمة المستخدمين عدد مستخدمين يتراوح بين 10,000 و50,000 مستخدم.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND تضم قائمة المستخدمين عدد من المستخدمين يتراوح بين 50,000 و100,000.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND تضم قائمة المستخدمين عدد من المستخدمين يتراوح بين 100,000 و300,000.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND تضم قائمة المستخدمين عدد من المستخدمين يتراوح بين 300,000 و500,000.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION تضم قائمة المستخدمين عدد مستخدمين يتراوح بين 500,000 ومليون.
ONE_MILLION_TO_TWO_MILLION تضم قائمة المستخدمين عدد من المستخدمين في نطاق يتراوح بين مليون و2 مليون.
TWO_MILLION_TO_THREE_MILLION تضم قائمة المستخدمين عدد مستخدمين في نطاق يتراوح بين مليونين و3 ملايين.
THREE_MILLION_TO_FIVE_MILLION تضم قائمة المستخدمين عدد من المستخدمين يتراوح بين 3 و5 ملايين.
FIVE_MILLION_TO_TEN_MILLION تضم قائمة المستخدمين عدد مستخدمين يتراوح بين 5 و10 ملايين.
TEN_MILLION_TO_TWENTY_MILLION تضم قائمة المستخدمين عدد مستخدمين يتراوح بين 10 و20 مليون مستخدم.
TWENTY_MILLION_TO_THIRTY_MILLION تضم قائمة المستخدمين عدد من المستخدمين يتراوح بين 20 و30 مليونًا.
THIRTY_MILLION_TO_FIFTY_MILLION تضم قائمة المستخدمين عدد مستخدمين يتراوح بين 30 و50 مليون مستخدم.
OVER_FIFTY_MILLION تضم قائمة المستخدمين أكثر من 50 مليون مستخدم.

UserListType

يتضمن التعداد أنواع قوائم المستخدمين المحتملة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
REMARKETING يتم تمثيل قائمة المستخدمين كمجموعة من أنواع الإحالات الناجحة.
LOGICAL يتم تمثيل قائمة المستخدمين كمجموعة من قوائم/اهتمامات المستخدمين الأخرى.
EXTERNAL_REMARKETING قائمة المستخدمين التي تم إنشاؤها في منصة "مدير إعلانات Google".
RULE_BASED UserList المرتبطة بقاعدة.
SIMILAR قائمة مستخدمين تتضمن مستخدمين مشابهين لمستخدمي قائمة مستخدمين أخرى.
CRM_BASED قائمة المستخدمين ببيانات إدارة علاقات العملاء بالطرف الأول المقدمة من المعلن في شكل رسائل إلكترونية أو تنسيقات أخرى.

UserListClosingReason

يصف التعداد الأسباب المحتملة لإغلاق قائمة المستخدمين.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
UNUSED تم إغلاق قائمة المستخدمين بسبب عدم استخدامها لأكثر من عام.

AccessReason

يصف التعداد أسباب الوصول المُحتمَلة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
OWNED يملك المستخدم المورد.
SHARED تتم مشاركة المورد مع المستخدم.
LICENSED تم ترخيص المورد للمستخدم.
SUBSCRIBED اشترك المستخدم في المورد.
AFFILIATED يمكن للمستخدم الوصول إلى المورد.

UserListAccessStatus

يشير هذا المقياس إلى التعداد الذي يتضمّن حالات الوصول المحتمَلة إلى قائمة المستخدمين.

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

CrmBasedUserListInfo

قائمة مستخدمي نظام إدارة علاقات العملاء (CRM) المقدَّمة من المعلِن.

تمثيل JSON 
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
الحقول
uploadKeyType

enum (CustomerMatchUploadKeyType)

تم مطابقة النوع الرئيسي للقائمة. غير مسموح بأنواع البيانات المختلطة في القائمة نفسها. هذا الحقل مطلوب لعملية "إضافة".
dataSourceType

enum (UserListCrmDataSourceType)

مصدر بيانات القائمة القيمة التلقائية هي FIRST_PARTY. يمكن فقط للعملاء المدرَجين في القائمة المسموح بها إنشاء قوائم إدارة علاقات العملاء (CRM) الصادرة عن جهات خارجية.
appId

string

سلسلة تُحدِّد بشكلٍ فريد تطبيق الأجهزة الجوّالة الذي تم جمع البيانات منه. بالنسبة إلى نظام التشغيل iOS، سلسلة رقم التعريف هي السلسلة المكوَّنة من 9 أرقام التي تظهر في نهاية عنوان URL لمتجر التطبيقات (على سبيل المثال، "476943146" بدلاً من "Flood-It! 2" الذي يكون رابط App Store الخاص به هو http://itunes.apple.com/us/app/flood-it!-2/id476943146). بالنسبة إلى نظام التشغيل Android، تكون سلسلة المعرّف هي اسم حزمة التطبيق (مثلاً، "com.labpixies.colordrips" لـ "Color Drips" وفقًا لرابط Google Play https://play.google.com/store/apps/details?id=com.labpixies.colordrips). مطلوب عند إنشاء CrmBasedUserList لتحميل المعرّفات الإعلانية على الأجهزة الجوّالة.

CustomerMatchUploadKeyType

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

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
CONTACT_INFO تتم مطابقة المشتركين من خلال معلومات العميل، مثل عنوان البريد الإلكتروني أو رقم الهاتف أو العنوان الجغرافي.
CRM_ID تتم مطابقة الأعضاء من رقم تعريف مستخدم أنشأه المعلِن وعيّنه له.
MOBILE_ADVERTISING_ID تتم مطابقة الأعضاء من معرّفات إعلانات الأجهزة الجوّالة.

UserListCrmDataSourceType

يشير التعداد إلى وصف نوع مصدر بيانات "إدارة علاقات العملاء" في قائمة المستخدمين المحتمَل.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
FIRST_PARTY البيانات التي يتم تحميلها هي بيانات الطرف الأول.
THIRD_PARTY_CREDIT_BUREAU البيانات التي تم تحميلها واردة من مكتب ائتمان تابع لجهة خارجية.
THIRD_PARTY_VOTER_FILE إنّ البيانات التي تم تحميلها مصدرها ملف ناخب تابع لجهة خارجية.

SimilarUserListInfo

شبه قائمة المستخدمين هذه هي قائمة تضم مستخدمين مشابهين لمستخدمين من قائمة مستخدمين أخرى. هذه القوائم للقراءة فقط وتنشئها Google تلقائيًا.

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

string

قائمة المستخدمين الأساسية التي يتم اشتقاق هذه القائمة منها.

RuleBasedUserListInfo

تمثيل لقائمة مستخدمين تم إنشاؤها من خلال قاعدة.

تمثيل JSON 
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
الحقول
prepopulationStatus

enum (UserListPrepopulationStatus)

حالة التعبئة المسبقة. يتم ضبط الحقل تلقائيًا على "بدون" في حال عدم ضبطه، ما يعني أنّه لن يتم أخذ المستخدمين السابقين في الاعتبار. في حال ضبط هذه السياسة على "مطلوب"، سيتم في القائمة تضمين زوّار الموقع الإلكتروني أو مستخدمي التطبيق السابقين الذين يتطابقون مع تعريف القائمة (يعمل على "الشبكة الإعلانية" فقط). وسيؤدي ذلك إلى إضافة المستخدمين السابقين من آخر 30 يومًا فقط، استنادًا إلى مدة عضوية القائمة وتاريخ إضافة علامة تجديد النشاط التسويقي. سيتم تحديث الحالة إلى FINISHED بعد معالجة الطلب، أو فشله إذا فشل الطلب.
flexibleRuleUserList

object (FlexibleRuleUserListInfo)

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

UserListPrepopulationStatus

يشير عمود التعداد إلى حالة التعبئة التلقائية لقائمة المستخدمين.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
REQUESTED جارٍ طلب التعبئة المسبقة.
FINISHED انتهت عملية التعبئة التلقائية.
FAILED تعذّرت التعبئة تلقائيًا.

FlexibleRuleUserListInfo

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

تمثيل JSON 
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
الحقول
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

يشير ذلك المصطلح إلى عامل تشغيل يحدِّد كيفية دمج المعاملات الشاملة.
inclusiveOperands[]

object (FlexibleRuleOperandInfo)

قواعد تمثِّل المستخدمين الذين يجب تضمينهم في قائمة المستخدمين. تقع هذه المعامل على الجانب الأيسر من عامل التشغيل AND_NOT، ويتم ضمها معًا بواسطة AND/OR كما هو محدد بواسطة عامل التشغيل inclusiveRuleOperator.
exclusiveOperands[]

object (FlexibleRuleOperandInfo)

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

UserListFlexibleRuleOperator

يشير التعداد إلى عوامل تشغيل القواعد المجمّعة المحتملة لقوائم المستخدمين.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
AND "أ" و"ب".
OR A أو B.

FlexibleRuleOperandInfo

قاعدة مرنة تضم القاعدة المشتركة وفترة معاينة إعلان.

تمثيل JSON 
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
الحقول
rule

object (UserListRuleInfo)

قائمة بمجموعات عناصر القواعد التي تحدِّد هذه القاعدة. يتم تجميع مجموعات عناصر القاعدة معًا.
lookbackWindowDays

string (int64 format)

فترة معاينة الإعلان لهذه القاعدة بالأيام. من الآن وحتى X من الأيام.

UserListRuleInfo

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

تمثيل JSON 
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
الحقول
ruleType

enum (UserListRuleType)

يتم استخدام نوع القاعدة لتحديد كيفية تجميع عناصر القاعدة.

الإعداد الافتراضي هو OR (أو) (شكل عادي فاصل). وهذا يعني أنّه سيتم ربط عناصر القاعدة باستخدام AND معًا داخل مجموعات عناصر القاعدة، وسيتم ربط المجموعات نفسها باستخدام OR.

OR من AND هي النوع الوحيد المتاح لـ مرونةRuleUserList.
ruleItemGroups[]

object (UserListRuleItemGroupInfo)

قائمة بمجموعات عناصر القواعد التي تحدِّد هذه القاعدة. يتم تجميع مجموعات عناصر القاعدة معًا استنادًا إلى baseType.

UserListRuleType

يشير قيم التعداد إلى أنواع قواعد قوائم المستخدمين المحتملة.

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

UserListRuleItemGroupInfo

مجموعة من عناصر القاعدة.

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

object (UserListRuleItemInfo)

عناصر القاعدة التي سيتم تجميعها معًا استنادًا إلى baseType.

UserListRuleItemInfo

عنصر قاعدة ذرية.

تمثيل JSON 
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
الحقول
name

string

اسم متغيّر القاعدة ويجب أن يتطابق مع اسم المفتاح المقابل الذي يطلقه وحدة البكسل. يجب أن يبدأ الاسم بأحرف ASCII-acii أو شرطة سفلية أو رمز UTF8 أكبر من 127 ويتألف من أحرف أو أرقام من نوع US-acii أو رمز شرطة سفلية أو رمز UTF8 أكبر من 127. بالنسبة إلى مواقع الويب، هناك عنوانان URL متغيّر مضمّن (الاسم = 'url__') وعنوان URL المُحيل (الاسم = 'ref_url__'). يجب تعبئة هذا الحقل عند إنشاء عنصر قاعدة جديد.
حقل الاتحاد rule_item عنصر قاعدة ذرية. يمكن أن يكون الحقل "rule_item" واحدًا فقط مما يلي:
numberRuleItem

object (UserListNumberRuleItemInfo)

يشير ذلك المصطلح إلى عنصر قاعدة ذرية يتألّف من عملية رقم.
stringRuleItem

object (UserListStringRuleItemInfo)

يشير ذلك المصطلح إلى عنصر قاعدة صغيرة يتألّف من عملية سلسلة.
dateRuleItem

object (UserListDateRuleItemInfo)

يشير ذلك المصطلح إلى عنصر قاعدة صغيرة يتكوّن من عملية تاريخ.

UserListNumberRuleItemInfo

يشير ذلك المصطلح إلى عنصر قاعدة مؤلف من عملية رقم.

تمثيل JSON 
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
الحقول
operator

enum (UserListNumberRuleItemOperator)

عامل تشغيل مقارنة الأرقام. هذا الحقل مطلوب ويجب ملؤه عند إنشاء عنصر قاعدة أرقام جديد.
value

number

قيمة الرقم المطلوب مقارنتها بالمتغير. هذا الحقل مطلوب ويجب ملؤه عند إنشاء عنصر قاعدة أرقام جديد.

UserListNumberRuleItemOperator

يشير التعداد إلى عوامل التشغيل المحتمَلة لعناصر قاعدة أرقام قائمة المستخدمين.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
GREATER_THAN أكبر من.
GREATER_THAN_OR_EQUAL أكبر من أو يساوي.
EQUALS يساوي.
NOT_EQUALS غير متساوين.
LESS_THAN أقل من.
LESS_THAN_OR_EQUAL أقل من أو يساوي.

UserListStringRuleItemInfo

يشير ذلك المصطلح إلى عنصر قاعدة يتألف من عملية سلسلة.

تمثيل JSON 
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
الحقول
operator

enum (UserListStringRuleItemOperator)

عامل تشغيل مقارنة السلاسل. هذا الحقل مطلوب ويجب ملؤه عند إنشاء عنصر قاعدة سلسلة جديد.
value

string

الجانب الأيمن لعنصر قاعدة السلسلة. بالنسبة إلى عناوين URL أو عناوين URL المُحيلة، لا يمكن أن تحتوي القيمة على أحرف عنوان URL غير قانونية مثل السطور الجديدة أو علامات الاقتباس أو علامات التبويب أو الأقواس. هذا الحقل مطلوب ويجب ملؤه عند إنشاء عنصر قاعدة سلسلة جديد.

UserListStringRuleItemOperator

يشير قيم التعداد إلى عوامل التشغيل المحتمَلة لعناصر قاعدة سلسلة قائمة المستخدمين.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
CONTAINS يحتوي على
EQUALS يساوي.
STARTS_WITH تبدأ بـ.
ENDS_WITH ينتهي بـ.
NOT_EQUALS غير متساوين.
NOT_CONTAINS لا يحتوي على.
NOT_STARTS_WITH لا تبدأ بـ.
NOT_ENDS_WITH لا ينتهي بـ.

UserListDateRuleItemInfo

يشير ذلك المصطلح إلى عنصر قاعدة يتألف من عملية تاريخ.

تمثيل JSON 
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
الحقول
operator

enum (UserListDateRuleItemOperator)

عامل تشغيل مقارنة التواريخ. هذا الحقل مطلوب ويجب ملؤه عند إنشاء عنصر قاعدة تاريخ جديد.
value

string

سلسلة تمثِّل قيمة التاريخ المطلوب مقارنتها بمتغيّر القاعدة تنسيق التاريخ المتاح هو YYYY-MM-DD. يتم عرض الأوقات وفقًا للمنطقة الزمنية للعميل.
offsetInDays

string (int64 format)

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

UserListDateRuleItemOperator

يشير التعداد إلى عوامل التشغيل المحتمَلة لعناصر قاعدة تاريخ قائمة المستخدمين.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
EQUALS يساوي.
NOT_EQUALS لا يساوي.
BEFORE من قبل.
AFTER بعد.

LogicalUserListInfo

يمثل هذا التمثيل قائمة مستخدمين تمثل مجموعة مخصصة من قوائم المستخدمين.

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

object (UserListLogicalRuleInfo)

قواعد القائمة المنطقية التي تحدد قائمة المستخدمين هذه. يتم تعريف القواعد كعامل تشغيل منطقي (ALL/ANY/NONE) وقائمة بقوائم المستخدمين. يتم ربط جميع القواعد باستخدام AND عند تقييمها.

مطلوب لإنشاء قائمة مستخدمين منطقية.

UserListLogicalRuleInfo

قاعدة منطقية لقائمة المستخدمين. تحتوي القاعدة على عامل تشغيل منطقي (و/أو/لا) وقائمة من قوائم المستخدمين كمعاملات.

تمثيل JSON 
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
الحقول
operator

enum (UserListLogicalRuleOperator)

العامل المنطقي للقاعدة.
ruleOperands[]

object (LogicalUserListOperandInfo)

قائمة معاملات القاعدة.

UserListLogicalRuleOperator

يشير قيم التعداد إلى عوامل تشغيل القواعد المنطقية لقائمة المستخدمين المحتمَلة.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
ALL و- جميع المعاملات.
ANY أو - أحد المعاملات على الأقل.
NONE ليس - لا شيء من المعاملات.

LogicalUserListOperandInfo

خاص بقائمة مستخدمين منطقية تتكون من قائمة مستخدمين.

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

string

اسم مورد قائمة المستخدمين كمعامل.

BasicUserListInfo

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

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

object (UserListActionInfo)

الإجراءات المرتبطة بقائمة المستخدمين هذه.

UserListActionInfo

يمثل نوع إجراء يُستخدم لإنشاء قوائم مستخدمي تجديد النشاط التسويقي.

تمثيل JSON 
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
الحقول
حقل الاتحاد user_list_action هي أنواع فرعية من إجراءات قائمة المستخدمين. يمكن أن يكون الحقل "user_list_action" واحدًا فقط مما يلي:
conversionAction

string

إجراء إحالة ناجحة لا يتم إنشاؤه من تجديد النشاط التسويقي.
remarketingAction

string

إجراء تجديد النشاط التسويقي.