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

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

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

فهرست‌های کاربر مبتنی بر قانون که با 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 => []});
      

فر کردن

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

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

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

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

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