사용자 목록 만들기

리마케팅 캠페인에서 사용자 목록을 사용하여 웹사이트 또는 앱에서 특정 작업을 수행한 사용자와 다시 참여를 유도할 수 있습니다. Google Ads API는 여러 유형의 사용자 목록을 지원합니다. 이 가이드에서는 규칙 기반 사용자 목록을 만드는 데 중점을 둡니다.

규칙 기반 사용자 목록

flexible_rule_user_list 로 빌드된 규칙 기반 사용자 목록에는 여러 규칙이 포함될 수 있습니다. 각 규칙은 규칙 항목 그룹 내에서 규칙 항목이 결합되는 방식을 결정하는 rule_type이 있는 UserListRuleInfo 메시지로 표시됩니다.

rule_type이 OR_OF_ANDS (기본값)인 경우 Google Ads는 규칙 항목 그룹의 모든 규칙 항목을 AND로 결합합니다. 즉, 지정된 규칙의 경우 규칙이 충족되려면 하나 이상의 규칙 항목 그룹 의 모든 규칙 항목 이 일치해야 합니다. 이를 '선언적 정규 형식'이라고 합니다.

또는 rule_type 을 AND_OF_ORS로 설정하면 규칙이 충족되려면 각 규칙 항목 그룹 의 하나 이상의 규칙 항목 이 일치해야 합니다. 이를 '결합적 정규 형식'이라고 합니다.

이제 위의 규칙 항목 그룹을 새 사용자 목록으로 결합하기만 하면 됩니다. 이 경우 이러한 규칙을 빌드한 기본 OR_OF_ANDS 기능을 그대로 둡니다.

자바

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

규칙 기반 목록에 과거 사용자 포함

사용자 목록의 prepopulation_status 를 REQUESTED로 설정하여 규칙 기반 사용자 목록에 과거 사용자를 포함할 수도 있습니다. 이 필드의 상태를 주기적으로 확인하여 비동기 사전 채우기 프로세스의 진행 상황을 모니터링합니다.

이렇게 하면 목록의 포함 기간과 리마케팅 태그가 추가된 날짜에 따라 지난 30일 이내의 과거 사용자만 추가됩니다. 요청이 처리되면 상태가 FINISHED 로 업데이트되고 요청이 실패하면 FAILED 로 업데이트됩니다.

이전
규칙 항목 그룹 만들기