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)
  },
  "lookalikeUserList": {
    object (LookalikeUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
زمینه های
resourceName

string

تغییرناپذیر. نام منبع لیست کاربران نام منابع لیست کاربر به شکل زیر است:

customers/{customerId}/userLists/{userListId}

membershipStatus

enum ( UserListMembershipStatus )

وضعیت عضویت این لیست کاربر. باز یا فعال بودن لیست کاربران را نشان می دهد. فقط لیست های باز کاربر می توانند کاربران بیشتری را جمع آوری کنند و می توان آنها را هدف قرار داد.

sizeRangeForDisplay

enum ( UserListSizeRange )

فقط خروجی محدوده اندازه بر حسب تعداد کاربران لیست کاربران، در شبکه نمایش گوگل.

این فیلد فقط خواندنی است.

type

enum ( UserListType )

فقط خروجی نوع این لیست

این فیلد فقط خواندنی است.

closingReason

enum ( UserListClosingReason )

نشان دادن دلیل بسته شدن وضعیت عضویت در لیست کاربر. فقط در لیست هایی که به دلیل عدم فعالیت به طور خودکار بسته شده اند پر می شود و پس از باز شدن وضعیت عضویت در لیست پاک می شود.

accessReason

enum ( AccessReason )

فقط خروجی دلیل دسترسی این حساب به لیست را نشان می دهد. دلیل می تواند به اشتراک گذاشته شده، متعلق به، دارای مجوز یا مشترک باشد.

این فیلد فقط خواندنی است.

accountUserListStatus

enum ( UserListAccessStatus )

نشان می دهد که آیا این اشتراک هنوز فعال است یا خیر. هنگامی که یک UserList با کاربر به اشتراک گذاشته می شود، این فیلد روی فعال تنظیم می شود. بعداً مالک userList می‌تواند تصمیم بگیرد که اشتراک را لغو کند و آن را غیرفعال کند. مقدار پیش فرض این فیلد روی ENABLED تنظیم شده است.

id

string ( int64 format)

فقط خروجی شناسه لیست کاربران

readOnly

boolean

فقط خروجی گزینه ای که نشان می دهد آیا کاربر می تواند یک لیست را ویرایش کند. بستگی به مالکیت لیست و نوع لیست دارد. به عنوان مثال، لیست های کاربران بازاریابی مجدد خارجی قابل ویرایش نیستند.

این فیلد فقط خواندنی است.

name

string

نام این لیست کاربران. بسته به accessReason آن، نام لیست کاربر ممکن است منحصر به فرد نباشد (به عنوان مثال، اگر accessReason=SHARED)

description

string

شرح این لیست کاربران

integrationCode

string

شناسه از سیستم خارجی توسط فروشندگان لیست کاربران برای مرتبط کردن شناسه ها در سیستم هایشان استفاده می شود.

membershipLifeSpan

string ( int64 format)

تعداد روزهایی که کوکی کاربر از آخرین افزوده شدن آن به لیست در لیست شما باقی می ماند. این فیلد باید بین 0 تا 540 باشد. با این حال، برای لیست های کاربری مبتنی بر CRM، این فیلد را می توان روی 10000 تنظیم کرد که به معنای عدم انقضا است.

این فیلد برای انواع logicalUserList و ruleBasedUserList نادیده گرفته می شود. عضویت در لیست هایی از این نوع به قوانین تعریف شده توسط لیست ها بستگی دارد.

sizeForDisplay

string ( int64 format)

فقط خروجی تعداد تخمینی کاربران در این فهرست کاربری، در شبکه نمایش گوگل. اگر تعداد کاربران هنوز مشخص نشده باشد، این مقدار صفر است.

این فیلد فقط خواندنی است.

eligibleForDisplay

boolean

فقط خروجی نشان می‌دهد که این فهرست کاربران برای Google Display Network واجد شرایط است.

این فیلد فقط خواندنی است.

matchRatePercentage

integer

فقط خروجی نرخ تطابق را برای لیست های مطابقت مشتری نشان می دهد. محدوده این فیلد [0-100] است. برای سایر انواع لیست یا زمانی که امکان محاسبه نرخ تطابق وجود نداشته باشد، این مورد باطل خواهد بود.

این فیلد فقط خواندنی است.

user_list فیلد اتحادیه . لیست کاربران

دقیقاً یکی باید تنظیم شود. user_list تنها می تواند یکی از موارد زیر باشد:

crmBasedUserList

object ( CrmBasedUserListInfo )

لیست کاربری کاربران CRM ارائه شده توسط تبلیغ کننده.

similarUserList

object ( SimilarUserListInfo )

فقط خروجی لیست کاربرانی که مشابه کاربرانی از UserList دیگر هستند. این لیست ها فقط خواندنی هستند و به طور خودکار توسط گوگل ایجاد می شوند.

ruleBasedUserList

object ( RuleBasedUserListInfo )

لیست کاربر ایجاد شده توسط یک قانون.

logicalUserList

object ( LogicalUserListInfo )

لیست کاربر که ترکیبی سفارشی از لیست های کاربر و علایق کاربر است.

basicUserList

object ( BasicUserListInfo )

هدف گذاری لیست کاربران به عنوان مجموعه ای از اقدامات تبدیل یا بازاریابی مجدد.

lookalikeUserList

object ( LookalikeUserListInfo )

تغییرناپذیر. لیست کاربران شبیه به ظاهر.

UserListMembershipStatus

فهرست شامل وضعیت های احتمالی عضویت در لیست کاربران.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
OPEN وضعیت باز - لیست در حال جمع آوری اعضا است و می توان آنها را هدف قرار داد.
CLOSED وضعیت بسته - هیچ عضو جدیدی اضافه نشده است. نمی توان برای هدف گیری استفاده کرد.

UserListSizeRange

Enum حاوی محدوده اندازه لیست کاربر ممکن است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
LESS_THAN_FIVE_HUNDRED لیست کاربران کمتر از 500 کاربر دارد.
LESS_THAN_ONE_THOUSAND لیست کاربران دارای تعداد کاربر در محدوده 500 تا 1000 است.
ONE_THOUSAND_TO_TEN_THOUSAND لیست کاربران دارای تعداد کاربر در محدوده 1000 تا 10000 است.
TEN_THOUSAND_TO_FIFTY_THOUSAND لیست کاربران دارای تعداد کاربر در محدوده 10000 تا 50000 است.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND لیست کاربران دارای تعداد کاربر در محدوده 50000 تا 100000 است.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND لیست کاربران دارای تعداد کاربر در محدوده 100000 تا 300000 است.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND لیست کاربران دارای تعداد کاربر در محدوده 300000 تا 500000 است.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION لیست کاربران دارای تعداد کاربر در محدوده 500000 تا 1 میلیون است.
ONE_MILLION_TO_TWO_MILLION لیست کاربران دارای تعداد کاربر در محدوده 1 تا 2 میلیون است.
TWO_MILLION_TO_THREE_MILLION لیست کاربران دارای تعداد کاربر در محدوده 2 تا 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

Enum حاوی انواع لیست کاربر ممکن است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
REMARKETING UserList به عنوان مجموعه ای از انواع تبدیل نمایش داده می شود.
LOGICAL UserList به عنوان ترکیبی از سایر لیست ها / علایق کاربران نشان داده می شود.
EXTERNAL_REMARKETING لیست کاربری ایجاد شده در پلتفرم Google Ad Manager.
RULE_BASED لیست کاربری مرتبط با یک قانون.
SIMILAR UserList با کاربرانی مشابه کاربران یک UserList دیگر.
CRM_BASED فهرست کاربری داده‌های CRM شخص اول که توسط تبلیغ‌کننده در قالب ایمیل یا فرمت‌های دیگر ارائه می‌شود.
LOOKALIKE LookalikeUserlist، متشکل از کاربرانی شبیه به کاربران یک seed قابل تنظیم (مجموعه UserLists)

UserListClosingReason

Enum دلایل بسته شدن لیست کاربران احتمالی را توضیح می دهد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
UNUSED لیست کاربری به دلیل عدم استفاده بیش از یک سال بسته شد.

AccessReason

Enum دلایل دسترسی احتمالی را شرح می دهد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
OWNED منبع متعلق به کاربر است.
SHARED منبع با کاربر به اشتراک گذاشته می شود.
LICENSED این منبع دارای مجوز برای کاربر است.
SUBSCRIBED کاربر در منبع مشترک شد.
AFFILIATED منبع در دسترس کاربر است.

UserListAccessStatus

Enum حاوی وضعیت دسترسی به لیست کاربران احتمالی است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ENABLED دسترسی فعال است
DISABLED دسترسی غیرفعال است

CrmBasedUserListInfo

لیست کاربری از کاربران CRM ارائه شده توسط تبلیغ کننده.

نمایندگی JSON
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
زمینه های
uploadKeyType

enum ( CustomerMatchUploadKeyType )

مطابق با نوع کلید لیست. انواع داده های مختلط در یک لیست مجاز نیستند. این فیلد برای عملیات ADD مورد نیاز است.

dataSourceType

enum ( UserListCrmDataSourceType )

منبع داده لیست مقدار پیش‌فرض FIRST_PARTY است. فقط مشتریان موجود در لیست مجاز می توانند لیست های CRM منبع شخص ثالث را ایجاد کنند.

appId

string

رشته ای که به طور منحصر به فرد یک برنامه تلفن همراه را که داده ها از آن جمع آوری شده است، شناسایی می کند. برای iOS، رشته ID رشته 9 رقمی است که در انتهای URL فروشگاه App ظاهر می شود (به عنوان مثال، "476943146" برای "Flood-It! 2" که لینک App Store آن http://itunes.apple.com است. /us/app/flood-it!-2/id476943146) . برای Android، رشته ID نام بسته برنامه است (به عنوان مثال، "com.labpixies.colordrips" برای "Color Drips" با لینک Google Play https://play.google.com/store/apps/details?id=com .labpixies.colordrips) . هنگام ایجاد CrmBasedUserList برای آپلود شناسه های تبلیغاتی تلفن همراه مورد نیاز است.

CustomerMatchUploadKeyType

Enum که انواع کلیدهای آپلود مطابقت احتمالی مشتری را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
CONTACT_INFO اعضا از طریق اطلاعات مشتری مانند آدرس ایمیل، شماره تلفن یا آدرس فیزیکی مطابقت داده می شوند.
CRM_ID اعضا از طریق شناسه کاربری که توسط تبلیغ‌کننده ایجاد و تخصیص داده می‌شود مطابقت داده می‌شوند.
MOBILE_ADVERTISING_ID اعضا از شناسه های تبلیغاتی تلفن همراه مطابقت داده می شوند.

UserListCrmDataSourceType

Enum که نوع منبع داده crm لیست کاربر احتمالی را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
FIRST_PARTY داده های آپلود شده، داده های شخص اول هستند.
THIRD_PARTY_CREDIT_BUREAU داده های آپلود شده از یک دفتر اعتباری شخص ثالث است.
THIRD_PARTY_VOTER_FILE داده های آپلود شده از یک فایل رای دهنده شخص ثالث است.

SimilarUserListInfo

SimilarUserList لیستی از کاربرانی است که مشابه کاربران یک UserList دیگر هستند. این لیست ها فقط خواندنی هستند و به طور خودکار توسط Google ایجاد می شوند.

نمایندگی JSON
{
  "seedUserList": string
}
زمینه های
seedUserList

string

Seed UserList که این لیست از آن مشتق شده است.

RuleBasedUserListInfo

نمایش یک لیست کاربری که توسط یک قانون ایجاد می شود.

نمایندگی JSON
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
زمینه های
prepopulationStatus

enum ( UserListPrepopulationStatus )

وضعیت پیش از جمعیت. این فیلد در صورت تنظیم نشدن به طور پیش‌فرض روی NONE است که به این معنی است که کاربران قبلی در نظر گرفته نمی‌شوند. اگر روی REQUESTED تنظیم شود، بازدیدکنندگان قبلی سایت یا کاربران برنامه که با تعریف فهرست مطابقت دارند، در لیست گنجانده می‌شوند (فقط در Display Network کار می‌کند). این کار بسته به مدت زمان عضویت در لیست و تاریخی که برچسب بازاریابی مجدد اضافه می‌شود، فقط کاربران گذشته را از 30 روز گذشته اضافه می‌کند. پس از پردازش درخواست، وضعیت به FINISHED به‌روزرسانی می‌شود، یا در صورت عدم موفقیت درخواست، به FAILED به‌روزرسانی می‌شود.

flexibleRuleUserList

object ( FlexibleRuleUserListInfo )

نمایش قانون انعطاف پذیر بازدیدکنندگان با یک یا چند اقدام. لیست کاربر انعطاف پذیر با دو لیست از عملوندها - inclusiveOperands و exclusiveOperands تعریف می شود. هر عملوند مجموعه ای از کاربران را بر اساس اقداماتی که در یک بازه زمانی معین انجام داده اند نشان می دهد. این لیست از عملوندها با عملگر AND_NOT ترکیب می شوند، به طوری که کاربرانی که توسط عملوندهای فراگیر نشان داده می شوند، در لیست کاربر قرار می گیرند، منهای کاربرانی که توسط عملوندهای انحصاری نشان داده می شوند.

UserListPrepopulationStatus

Enum وضعیت پیش جمعیت لیست کاربر احتمالی را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
REQUESTED پیشجمعیت درخواست می شود.
FINISHED پیش جمعیت به پایان رسیده است.
FAILED پیش جمعیت ناموفق بود.

FlexibleRuleUserListInfo

نمایش قانون انعطاف پذیر بازدیدکنندگان با یک یا چند اقدام. لیست کاربر انعطاف پذیر با دو لیست از عملوندها - inclusiveOperands و exclusiveOperands تعریف می شود. هر عملوند مجموعه ای از کاربران را بر اساس اقداماتی که در یک بازه زمانی معین انجام داده اند نشان می دهد. این لیست از عملوندها با عملگر 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

Enum که عملگرهای قوانین ترکیبی فهرست کاربران ممکن را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AND الف و ب.
OR A OR 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ها تنها نوع پشتیبانی شده برای FlexibleRuleUserList است.

ruleItemGroups[]

object ( UserListRuleItemGroupInfo )

لیستی از گروه های آیتم قانون که این قانون را تعریف می کنند. گروه های آیتم های قانون با هم بر اساس ruleType گروه بندی می شوند.

UserListRuleType

Enum که انواع قوانین لیست کاربر ممکن را توصیف می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AND_OF_ORS فرم طبیعی ربطی.
OR_OF_ANDS فرم نرمال منفصل

UserListRuleItemGroupInfo

گروهی از موارد قانون

نمایندگی JSON
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
زمینه های
ruleItems[]

object ( UserListRuleItemInfo )

آیتم های قانون که بر اساس ruleType با هم گروه بندی می شوند.

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

نام متغیر قانون. باید با نام کلید مربوطه که توسط پیکسل اجرا می شود مطابقت داشته باشد. نام باید با حروف US-ascii یا زیرخط یا کد UTF8 بزرگتر از 127 شروع شود و شامل حروف یا ارقام US-ascii یا زیرخط یا کد 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

Enum که عملگرهای آیتم قانون شماره لیست کاربر احتمالی را توصیف می کند.

Enums
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 غیرقانونی مانند خطوط جدید، نقل قول، برگه‌ها یا پرانتز باشد. این فیلد مورد نیاز است و باید هنگام ایجاد یک مورد قانون رشته جدید پر شود.

UserListStringRuleItemOperator

Enum که عملگرهای مورد قانون رشته لیست کاربر ممکن را توصیف می کند.

Enums
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

Enum که عملگرهای آیتم قانون تاریخ لیست کاربر احتمالی را توصیف می کند.

Enums
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

Enum که عملگرهای قانون منطقی لیست کاربر ممکن را توصیف می کند.

Enums
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

یک اقدام بازاریابی مجدد

LookalikeUserListInfo

LookalikeUserlist، متشکل از کاربرانی شبیه به کاربران یک seed قابل تنظیم (مجموعه UserLists)

نمایندگی JSON
{
  "seedUserListIds": [
    string
  ],
  "expansionLevel": enum (LookalikeExpansionLevel),
  "countryCodes": [
    string
  ]
}
زمینه های
seedUserListIds[]

string ( int64 format)

شناسه Seed UserList که این لیست از آن مشتق شده است، ارائه شده توسط کاربر.

expansionLevel

enum ( LookalikeExpansionLevel )

سطح گسترش، منعکس کننده اندازه مخاطب مشابه است

countryCodes[]

string

کشورهای هدف Lookalike. کد کشور دو حرفی که توسط ISO-3166 تعریف شده است

LookalikeExpansionLevel

سطح گسترش، منعکس کننده اندازه مخاطب مشابه است

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN سطح گسترش نامعتبر است.
NARROW گسترش به مجموعه کوچکی از کاربران که شبیه به لیست های اولیه هستند
BALANCED گسترش به یک مجموعه متوسط ​​از کاربران که شبیه به لیست های اولیه هستند. شامل همه کاربران EXPANSION_LEVEL_NARROW و بیشتر است.
BROAD گسترش به مجموعه بزرگی از کاربران که شبیه به لیست های اولیه هستند. شامل همه کاربران EXPANSION_LEVEL_BALANCED و بیشتر است.