Kullanıcı listesi oluşturma

Web sitenizde veya uygulamanızda belirli işlemleri gerçekleştiren kullanıcılarla yeniden etkileşim kurmak için yeniden pazarlama kampanyalarınızda kullanıcı listelerini kullanabilirsiniz. Google Ads API, çeşitli kullanıcı listesi türlerini destekler. Bu kılavuzda, kural tabanlı kullanıcı listeleri oluşturma üzerinde durulmaktadır.

Kural tabanlı kullanıcı listeleri

flexible_rule_user_list ile oluşturulan kural tabanlı kullanıcı listeleri birden fazla kural içerebilir. Her kural, kural öğe gruplarındaki kural öğelerinin nasıl birleştirileceğini belirleyen bir rule_type öğesine sahip olan bir UserListRuleInfo mesajıyla temsil edilir.

rule_type OR_OF_ANDS (varsayılan) ise Google Ads, bir kural öğesi grubundaki tüm kural öğelerini AND. Bu, belirli bir kuralın karşılanması için en az bir kural öğesi grubundaki her kural öğesinin eşleşmesi gerektiği anlamına gelir. Buna "ayrık normal biçim" denir.

Alternatif olarak, rule_type değerini AND_OF_ORS olarak ayarlarsanız kuralın karşılanması için her kural öğesi grubundaki en az bir kural öğesinin eşleşmesi gerekir. Buna "bağlaçlı normal biçim" denir.

Geriye kalan tek şey yukarıdaki kural öğesi gruplarını yeni bir kullanıcı listesinde birleştirmektir. Bu durumda, bu kuralları oluşturma amacımız doğrultusunda varsayılan OR_OF_ANDS işlevini kullanacağız.

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();
SetUpAdvancedRemarketing.java

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);
SetUpAdvancedRemarketing.cs

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' => []
]);
SetUpAdvancedRemarketing.php

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)
set_up_advanced_remarketing.py

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
set_up_advanced_remarketing.rb

Perl

my $flexible_rule_user_list_info =
  Google::Ads::GoogleAds::V22::Common::FlexibleRuleUserListInfo->new({
    inclusiveRuleOperator => AND,
    inclusiveOperands     => [
      Google::Ads::GoogleAds::V22::Common::FlexibleRuleOperandInfo->new({
          rule => Google::Ads::GoogleAds::V22::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 => []});
set_up_advanced_remarketing.pl

Geçmişteki kullanıcıları kural tabanlı bir listeye dahil etme

Ayrıca, kullanıcı listesinin prepopulation_status ayarını REQUESTED olarak belirleyerek geçmiş kullanıcıları kurala dayalı kullanıcı listesine ekleyebilir ve bu alanın durumunu düzenli olarak kontrol ederek eşzamansız önceden doldurma sürecinin ilerleme durumunu izleyebilirsiniz.

Bu işlem, listenin üyelik süresine ve yeniden pazarlama etiketinin eklendiği tarihe bağlı olarak yalnızca son 30 gün içindeki eski kullanıcıları ekler. İstek işleme alındığında durum FINISHED, istek başarısız olduğunda ise FAILED olarak güncellenir.

Önceki
Kural öğesi grupları oluşturma