یک لیست کاربری ایجاد کنید

شما می‌توانید از فهرست‌های کاربران در کمپین‌های بازاریابی مجدد خود برای تعامل مجدد با کاربرانی که اقدامات خاصی را در وب‌سایت یا برنامه شما انجام داده‌اند، استفاده کنید. API گوگل ادز از انواع مختلفی از فهرست‌های کاربر پشتیبانی می‌کند. این راهنما بر ایجاد فهرست‌های کاربر مبتنی بر قانون با استفاده از گروه‌های آیتم قانون تعریف شده در بخش «ایجاد گروه‌های آیتم قانون» تمرکز دارد.

فهرست‌های کاربران مبتنی بر قانون

فهرست‌های کاربری مبتنی بر قانون که با flexible_rule_user_list ساخته می‌شوند، می‌توانند شامل چندین قانون ( inclusive_rule و exclusive_rule که توسط inclusive_rule_operator به هم متصل شده‌اند) باشند. هر قانون توسط یک پیام UserListRuleInfo نمایش داده می‌شود که دارای یک فیلد rule_type است که نحوه ترکیب آیتم‌های قانون در گروه‌های آیتم قانون را تعیین می‌کند.

اگرچه UserListRuleTypeEnum هم OR_OF_ANDS (فرم نرمال فصلی) و هم AND_OF_ORS (فرم نرمال عطفی) را تعریف می‌کند، OR_OF_ANDS تنها rule_type پشتیبانی شده برای FlexibleRuleUserListInfo است (تنظیم AND_OF_ORS UserListError.RULE_TYPE_IS_NOT_SUPPORTED را برمی‌گرداند). با OR_OF_ANDS ، توابع AND در گوگل ادز تمام آیتم‌های قانون را در یک گروه آیتم قانون با هم جمع می‌کنند، به این معنی که برای یک قانون مشخص، هر آیتم قانون در حداقل یک گروه آیتم قانون باید مطابقت داشته باشد تا قانون برقرار باشد.

پس از تعریف دو شیء UserListRuleItemGroupInfo در Create rule item groups ، آنها را در یک لیست کاربر جدید ترکیب کنید. مثال کد زیر نوع قانون پیش‌فرض OR_OF_ANDS را حفظ می‌کند، هر دو گروه آیتم قانون را به یک FlexibleRuleOperandInfo روی FlexibleRuleUserListInfo اضافه می‌کند و لیست کاربر را تغییر می‌دهد:

جاوا

FlexibleRuleUserListInfo flexibleRuleUserListInfo =
    FlexibleRuleUserListInfo.newBuilder()
        .setInclusiveRuleOperator(UserListFlexibleRuleOperator.AND)
        .addInclusiveOperands(
            FlexibleRuleOperandInfo.newBuilder()
                .setRule(
                    // The default rule_type for a UserListRuleInfo object is OR of ANDs
                    // (disjunctive normal form). That is, rule items will be ANDed together
                    // within rule item groups and the groups themselves will be ORed together.
                    UserListRuleInfo.newBuilder()
                        .addRuleItemGroups(checkoutDateRuleGroup)
                        .addRuleItemGroups(checkoutAndCartSizeRuleGroup))
                // Optional: includes a lookback window for this rule, in days.
                .setLookbackWindowDays(7L))
        .build();
      

سی شارپ

FlexibleRuleUserListInfo flexibleRuleUserListInfo = new FlexibleRuleUserListInfo();
FlexibleRuleOperandInfo flexibleRuleOperandInfo = new FlexibleRuleOperandInfo() {
    Rule = new UserListRuleInfo()
};
flexibleRuleOperandInfo.Rule.RuleItemGroups.Add(checkoutAndCartSizeRuleGroup);
flexibleRuleOperandInfo.Rule.RuleItemGroups.Add(checkoutDateRuleGroup);
flexibleRuleUserListInfo.InclusiveOperands.Add(flexibleRuleOperandInfo);
      

پی اچ پی

$flexibleRuleUserListInfo = new FlexibleRuleUserListInfo(
    [
    'inclusive_rule_operator' => UserListFlexibleRuleOperator::PBAND,
    'inclusive_operands' => [
        new FlexibleRuleOperandInfo(
            [
            'rule' => new UserListRuleInfo(
                [
                // The default rule_type for a UserListRuleInfo object is OR of ANDs
                // (disjunctive normal form). That is, rule items will be ANDed together
                // within rule item groups and the groups themselves will be ORed together.
                'rule_item_groups' => [
                    $checkoutAndCartSizeRuleGroup,
                    $checkoutDateRuleGroup
                ]
                ]
            ),
            // Optionally add a lookback window for this rule, in days.
            'lookback_window_days' => 7
            ]
        )
    ],
    'exclusive_operands' => []
    ]
);
      

پایتون

# Create a FlexibleRuleUserListInfo object, or a flexible rule
# representation of visitors with one or multiple actions.
# FlexibleRuleUserListInfo wraps UserListRuleInfo in a
# FlexibleRuleOperandInfo object that represents which user lists to
# include or exclude.
flexible_rule_user_list_info: FlexibleRuleUserListInfo = (
    rule_based_user_list_info.flexible_rule_user_list
)
flexible_rule_user_list_info.inclusive_rule_operator = (
    client.enums.UserListFlexibleRuleOperatorEnum.AND
)
# The default rule_type for a UserListRuleInfo object is OR of
# ANDs (disjunctive normal form). That is, rule items will be
# ANDed together within rule item groups and the groups
# themselves will be ORed together.
rule_operand: FlexibleRuleOperandInfo = client.get_type(
    "FlexibleRuleOperandInfo"
)
rule_operand.rule.rule_item_groups.extend(
    [
        checkout_and_cart_size_rule_group,
        checkout_date_rule_group,
    ]
)
rule_operand.lookback_window_days = 7
flexible_rule_user_list_info.inclusive_operands.append(rule_operand)
      

روبی

r.flexible_rule_user_list = client.resource.flexible_rule_user_list_info do |frul|
  frul.inclusive_rule_operator = :AND
  frul.inclusive_operands << client.resource.flexible_rule_operand_info do |froi|
    froi.rule = client.resource.user_list_rule_info do |info|
      info.rule_item_groups += [checkout_date_rule_group, checkout_and_cart_size_rule_group]
    end
    # Optionally include a lookback window for this rule, in days.
    froi.lookback_window_days = 7
  end
end
      

پرل

my $flexible_rule_user_list_info =
  Google::Ads::GoogleAds::V25::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V25::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V25::Common::UserListRuleInfo->new({
              # The default rule_type for a UserListRuleInfo object is OR of
              # ANDs (disjunctive normal form). That is, rule items will be
              # ANDed together within rule item groups and the groups
              # themselves will be ORed together.
              ruleItemGroups => [
                $checkout_date_rule_group, $checkout_and_cart_size_rule_group
              ]}
          ),
          # Optionally include a lookback window for this rule, in days.
          lookback_window_days => 7
        })
    ],
    exclusiveOperands => []});
      

حلقه زدن

کاربران قبلی را در یک لیست مبتنی بر قانون قرار دهید

همچنین می‌توانید بازدیدکنندگان قبلی وب‌سایت یا کاربران برنامه را در یک لیست کاربر مبتنی بر قانون (که فقط در شبکه نمایش پشتیبانی می‌شود) با تنظیم prepopulation_status لیست کاربران به REQUESTED قرار دهید و با بررسی دوره‌ای وضعیت این فیلد، پیشرفت فرآیند prepopulation ناهمزمان را رصد کنید.

پیش-جمعیت فقط کاربرانی را که در ۳۰ روز گذشته بوده‌اند، بسته به membership_life_span (از ۱ تا ۵۴۰ روز) لیست و تاریخ اضافه شدن برچسب بازاریابی مجدد، اضافه می‌کند. وضعیت پس از پردازش درخواست به «تمام شده» یا در صورت عدم موفقیت درخواست به FAILED FINISHED می‌شود.

لیست کاربران را هدف قرار دهید و پیشنهادات را تنظیم کنید

پس از ایجاد UserList خود، نام منبع آن را به یک AdGroupCriterion یا CampaignCriterion پیوست کنید و bid_modifier تنظیم کنید (برای مثال، 1.25 برای افزایش ۲۵ درصدی پیشنهاد). برای نمونه‌های کد که نحوه هدف قرار دادن یک فهرست کاربری و تغییر پیشنهادها را نشان می‌دهند، به Target the list مراجعه کنید.