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 öğe grupları oluşturma bölümünde tanımlanan kural öğe gruplarını kullanarak kural tabanlı kullanıcı listeleri oluşturma konusu ele alınmaktadır.

Kural tabanlı kullanıcı listeleri

flexible_rule_user_list ile oluşturulan kural tabanlı kullanıcı listeleri birden fazla kural içerebilir (inclusive_rule ve exclusive_rule, inclusive_rule_operator ile birleştirilir). Her kural, kural öğesi gruplarındaki kural öğelerinin nasıl birleştirileceğini belirleyen bir rule_type alanına sahip olan bir UserListRuleInfo mesajıyla temsil edilir.

UserListRuleTypeEnum hem OR_OF_ANDS (ayrık normal biçim) hem de AND_OF_ORS (birleşik normal biçim) tanımlasa da FlexibleRuleUserListInfo için desteklenen tek OR_OF_ANDS rule_type'dir (AND_OF_ORS ayarlanırsa UserListError.RULE_TYPE_IS_NOT_SUPPORTED döndürülür). OR_OF_ANDS ile Google Ads, bir kural öğesi grubundaki tüm kural öğelerini AND'ler. Bu da 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.

UserListRuleItemGroupInfo nesnelerini Kural öğe grupları oluşturma bölümünde tanımladıktan sonra bunları yeni bir kullanıcı listesinde birleştirin. Aşağıdaki kod örneğinde varsayılan OR_OF_ANDS kural türü olduğu gibi bırakılır, her iki kural öğesi grubu da FlexibleRuleOperandInfo üzerinde FlexibleRuleUserListInfo'a eklenir ve kullanıcı listesi değiştirilir:

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

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ş web sitesi ziyaretçilerini veya uygulama kullanıcılarını kural tabanlı bir kullanıcı listesine (yalnızca Görüntülü Reklam Ağı'nda desteklenir) ekleyebilir ve bu alanın durumunu düzenli olarak kontrol ederek eşzamansız önceden doldurma sürecinin ilerleme durumunu izleyebilirsiniz.

Önceden doldurma, yalnızca listenin membership_life_span (1 ila 540 gün) ve yeniden pazarlama etiketinin eklendiği tarihe bağlı olarak son 30 gün içindeki geçmiş kullanıcıları ekler. İstek işlendikten sonra durum FINISHED olarak güncellenir. İstek başarısız olursa durum FAILED olarak güncellenir.

Kullanıcı listesini hedefleme ve teklifleri ayarlama

UserList oluşturduktan sonra kaynak adını bir AdGroupCriterion veya CampaignCriterion öğesine ekleyin ve bid_modifier değerini ayarlayın (örneğin, %25'lik bir teklif artışı için 1.25). Kullanıcı listesini nasıl hedefleyeceğinizi ve teklifleri nasıl değiştireceğinizi gösteren kod örnekleri için Listeyi hedefleme başlıklı makaleyi inceleyin.

Önceki
Kural öğesi grupları oluşturma