ایجاد فهرست کاربر

می‌توانید از فهرست‌های کاربر در کمپین‌های بازاریابی مجددتان استفاده کنید تا دوباره با کاربرانی که کنش‌های خاصی را در وب‌سایت یا برنامه‌تان انجام داده‌اند تعامل کنید. Google Ads 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، Google Ads همه موارد قانون را در یک گروه مورد قانون باهم AND می‌کند، که به این معنی است که برای یک قانون معین، هر مورد قانون در حداقل یک گروه مورد قانون باید مطابقت داشته باشد تا قانون برآورده شود.

پس‌از تعریف دو شیء UserListRuleItemGroupInfo در ایجاد گروه‌های مورد قانون، آن‌ها را در فهرست کاربر جدیدی ترکیب کنید. نمونه کد زیر نوع قانون پیش‌فرض 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();
      

C#‎

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);
      

PHP

$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' => []
    ]
);
      

Python

# 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)
      

Ruby

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::V26::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V26::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V26::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 => []});
      

curl

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

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

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

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

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