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

אתם יכולים להשתמש ברשימות משתמשים בקמפיינים לרימרקטינג כדי לעודד לאינטראקציה חוזרת משתמשים שביצעו פעולות ספציפיות באתר או באפליקציה שלכם. 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 של הרשימה (מ-1 עד 540 ימים) ולתאריך שבו נוסף תג הרימרקטינג. הסטטוס מתעדכן ל-FINISHED אחרי שהבקשה מעובדת, או ל-FAILED אם הבקשה נכשלת.

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

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