Membuat daftar pengguna

Anda dapat menggunakan daftar pengguna dalam kampanye pemasaran ulang untuk berinteraksi kembali dengan pengguna yang telah melakukan tindakan tertentu di situs atau aplikasi Anda. Google Ads API mendukung beberapa jenis daftar pengguna. Panduan ini berfokus pada pembuatan daftar pengguna berbasis aturan menggunakan kelompok item aturan yang ditentukan di Membuat kelompok item aturan.

Daftar pengguna berbasis aturan

Daftar pengguna berbasis aturan yang dibuat dengan flexible_rule_user_list dapat berisi beberapa aturan (inclusive_rule dan exclusive_rule, yang digabungkan oleh inclusive_rule_operator). Setiap aturan diwakili oleh pesan UserListRuleInfo, yang memiliki kolom rule_type yang menentukan cara item aturan dalam kelompok item aturan digabungkan.

Meskipun UserListRuleTypeEnum menentukan OR_OF_ANDS (bentuk normal disjungtif) dan AND_OF_ORS (bentuk normal konjungtif), OR_OF_ANDS adalah rule_type yang didukung untuk FlexibleRuleUserListInfo (menetapkan AND_OF_ORS akan menampilkan UserListError.RULE_TYPE_IS_NOT_SUPPORTED). Dengan OR_OF_ANDS, Google Ads AND semua item aturan dalam kelompok item aturan, yang berarti bahwa untuk aturan tertentu, setiap item aturan dalam setidaknya satu kelompok item aturan harus cocok agar aturan terpenuhi.

Setelah menentukan dua objek UserListRuleItemGroupInfo di Membuat kelompok item aturan, gabungkan keduanya ke dalam daftar pengguna baru. Contoh kode berikut membiarkan jenis aturan OR_OF_ANDS default tetap ada, menambahkan kedua kelompok item aturan ke FlexibleRuleOperandInfo di FlexibleRuleUserListInfo, dan mengubah daftar pengguna:

Java

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

Perl

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

curl

Menyertakan pengguna sebelumnya dalam daftar berbasis aturan

Anda juga dapat menyertakan pengunjung situs atau pengguna aplikasi sebelumnya dalam daftar pengguna berbasis aturan (didukung di Jaringan Display saja) dengan menetapkan prepopulation_status daftar pengguna ke REQUESTED, dan memantau progres proses prapengisian asinkron dengan memeriksa status kolom ini secara berkala.

Pengisian otomatis hanya menambahkan pengguna lama dari 30 hari terakhir, bergantung pada membership_life_span daftar (dari 1 hingga 540 hari) dan tanggal saat tag pemasaran ulang ditambahkan. Status diperbarui menjadi FINISHED setelah permintaan diproses, atau FAILED jika permintaan gagal.

Menargetkan daftar pengguna dan menyesuaikan bid

Setelah membuat UserList, lampirkan nama resource-nya ke AdGroupCriterion atau CampaignCriterion dan tetapkan bid_modifier (misalnya, 1.25 untuk peningkatan bid 25%). Untuk contoh kode yang menunjukkan cara menargetkan daftar pengguna dan mengubah bid, lihat Menargetkan daftar.

Sebelumnya
Membuat grup item aturan