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

אתם יכולים להשתמש ברשימות משתמשים בקמפיינים של רימרקטינג כדי לעודד משתמשים שביצעו פעולות ספציפיות באתר או באפליקציה שלכם לאינטראקציה חוזרת. Google Ads API תומך בכמה סוגים של רשימות משתמשים. המדריך הזה מתמקד ביצירת רשימות משתמשים מבוססות-כללים באמצעות קבוצות פריטים של כללים שמוגדרות בקטע יצירת קבוצות פריטים של כללים.

רשימות משתמשים שמבוססות על כללים

רשימות משתמשים שמבוססות על כללים ונוצרו באמצעות 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, ורשימת המשתמשים משתנה:

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

curl

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

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

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

טירגוט רשימת המשתמשים והתאמת הצעות המחיר

אחרי שיוצרים את UserList, מצרפים את שם המשאב שלו אל AdGroupCriterion או אל CampaignCriterion ומגדירים את bid_modifier (לדוגמה, 1.25 להגדלת הצעת המחיר ב-25%). בקטע הזה יש דוגמאות לקוד שמראות איך לטרגט רשימת משתמשים ולשנות הצעות מחיר.

הקודם
יצירה של קבוצות פריטים לכלל