إنشاء قائمة مستخدمين

يمكنك استخدام قوائم المستخدمين في حملات تجديد النشاط التسويقي لإعادة التفاعل مع المستخدمين الذين نفّذوا إجراءات معيّنة على موقعك الإلكتروني أو تطبيقك. تتيح 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، يربط AND"إعلانات Google" جميع عناصر القاعدة معًا في مجموعة عناصر القاعدة، ما يعني أنّه بالنسبة إلى قاعدة معيّنة، يجب أن يتطابق كل عنصر قاعدة في مجموعة عناصر قاعدة واحدة على الأقل حتى يتم استيفاء القاعدة.

بعد تحديد عنصرَي UserListRuleItemGroupInfo في إنشاء مجموعات عناصر القواعد، ادمجهما في قائمة مستخدمين جديدة. يترك مثال الرمز البرمجي التالي نوع القاعدة التلقائي OR_OF_ANDS في مكانه، ويضيف مجموعتَي عناصر القاعدة إلى FlexibleRuleOperandInfo على FlexibleRuleUserListInfo، ويغيّر قائمة المستخدمين:

جافا

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

curl

ملاحظة: على الرغم من عدم توفّر عينة تعليمات برمجية لـ REST مباشرة لهذه الخطوة هنا، يمكنك تنفيذ ذلك باستخدام طلب REST يدوي.

يُرجى الرجوع إلى مستندات واجهة REST في Google Ads API والصفحات المرجعية الخاصة بالطريقة. عليك إنشاء حمولة JSON استنادًا إلى تعريفات proto.

المَراجع الرئيسية:

• باستخدام REST
• بنية واجهة REST
• عمليات ربط حقول JSON
• يُرجى الرجوع إلى مرجع REST API للخدمة والطريقة المحدّدة.

تضمين المستخدمين السابقين في قائمة مستندة إلى قواعد

يمكنك أيضًا تضمين زوّار الموقع الإلكتروني أو مستخدمي التطبيق السابقين في قائمة مستخدمين مستندة إلى القواعد (متاحة على الشبكة الإعلانية فقط) من خلال ضبط prepopulation_status لقائمة المستخدمين على REQUESTED، ومراقبة مستوى تقدّم عملية التعبئة المسبقة غير المتزامنة من خلال التحقّق بشكل دوري من حالة هذا الحقل.

تضيف التعبئة التلقائية المستخدمين السابقين من آخر 30 يومًا فقط، وذلك حسب membership_life_span للقائمة (من يوم واحد إلى 540 يومًا) وتاريخ إضافة علامة تجديد النشاط التسويقي. يتم تعديل الحالة إلى FINISHED بعد معالجة الطلب، أو FAILED في حال تعذُّر معالجة الطلب.

ملاحظة: لا تنطبق ميزة "التعبئة التلقائية" إلا على "الشبكة الإعلانية"، وتتطلّب توفُّر علامة تتبُّع من Google نشطة على موقعك الإلكتروني تُشغِّل المَعلمات المخصّصة المُشار إليها في قواعدك. إذا تغيّرت القيمة prepopulation_status إلى FAILED، تأكَّد من تثبيت علامة التتبُّع من Google بشكل صحيح ومن أنّها تجمع بيانات المَعلمات، ثم أرسِل تعديلاً جديدًا يغيّر القيمة prepopulation_status إلى REQUESTED.

استهداف قائمة المستخدمين وتعديل عروض الأسعار

بعد إنشاء UserList، أرفِق اسم المورد الخاص به بـ AdGroupCriterion أو CampaignCriterion واضبط bid_modifier (على سبيل المثال، 1.25 لزيادة عرض السعر بنسبة %25). للاطّلاع على أمثلة على الرموز البرمجية توضّح كيفية استهداف قائمة مستخدمين وتعديل عروض الأسعار، يُرجى الاطّلاع على استهداف القائمة.