יצירת רשימת המשתמשים

עבור expression_rule_user_list, יש הבחנה נוספת. כברירת מחדל, מערכת Google Ads AND תקבץ את כל הפריטים של הכללים בקבוצת פריטים של כללים. כלומר, כל פריט של כלל בקבוצת פריטים אחת לפחות של כללים חייב להתאים כדי שהכלל יוסיף מבקר לרשימה. מצב זה נקרא "disjunctive normal form", או OR_OF_ANDS.

לחלופין, אפשר להגדיר את הרשימה כך שיתווסף מבקר לרשימה רק אם לפחות פריט אחד של כלל בכל קבוצת פריטים של כללים תואם. השיטה הזו נקראת 'צורה רגילה חפיפה', או AND_OF_ORS, והיא זמינה עבור expression_rule_user_list באמצעות השדה rule_type. ניסיון להשתמש ב-AND_OF_ORS ב-date_specific_rule_user_list יגרום לשגיאה.

כל מה שנשאר זה לשלב את קבוצות הפריטים של הכללים שלמעלה לרשימת משתמשים חדשה. במקרה כזה, נשאיר את פונקציונליות ברירת המחדל OR_OF_ANDS כמו שצריך, כי לשם כך פיתחנו את הכללים.

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

הגבלה לפי טווח תאריכים של ביקורים באתר

expression_rule_user_list שלמעלה עונה על הצרכים שלכם, אבל מה קורה אם רוצים לכלול רק את המשתמשים שעונים על הכלל שברשימה הזו ולהיכנס לאתר בין 1 באוקטובר ל-31 בדצמבר? שימוש ב-date_specific_rule_user_list.

תהליך היצירה של date_specific_rule_user_list זהה לתהליך של expression_rule_user_list. במקום להגדיר את השדה expression_rule_user_list באובייקט RuleBasedUserListInfo, צריך להגדיר את השדה date_specific_rule_user_list עם אובייקט DateSpecificRuleUserListInfo. האובייקט הזה יכיל שדות עבור start_date ו-end_date.

DateSpecificRuleUserListInfo dateSpecificRuleUserListInfo =
    DateSpecificRuleUserListInfo.newBuilder()
        .setRule(
            UserListRuleInfo.newBuilder()
                .addAllRuleItemGroups(
                    ImmutableList.of(checkoutAndCartSizeRuleGroup, checkoutDateRuleGroup)))
        .setStartDate(StringValue.of("2019-10-01"))
        .setEndDate(StringValue.of("2019-12-31"))
        .build();

הרשימה החדשה תכלול את כל המשתמשים שעומדים באותם כללים כמו הרשימה הקודמת, אבל רק אם הם נכנסו לאתר בין התאריכים start_date (כולל) לבין end_date (כולל).

כלול ברשימה משתמשים קודמים

אפשר גם לכלול משתמשים קודמים ברשימת משתמשים מבוססת-כללים על ידי הגדרת הערך prepopulation_status של רשימת המשתמשים כ-REQUESTED, ולעקוב אחרי ההתקדמות של תהליך אכלוס מראש אסינכרוני על ידי בדיקה תקופתית של הסטטוס של השדה הזה.

הפעולה הזו תגרום רק להוספה של משתמשים קודמים ב-30 הימים האחרונים, בהתאם למשך החברות ברשימה ולתאריך שבו נוסף התג של הרימרקטינג. הסטטוס יתעדכן ל-FINISHED אחרי עיבוד הבקשה, או ל-FAILED אם הבקשה נכשלה.