사용자 목록 만들기

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

규칙 기반 사용자 목록

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

UserListRuleTypeEnum는 OR_OF_ANDS (논리합 표준형)과 AND_OF_ORS (논리곱 표준형)을 모두 정의하지만 OR_OF_ANDS은 FlexibleRuleUserListInfo에 지원되는 유일한 rule_type입니다(AND_OF_ORS 설정 시 UserListError.RULE_TYPE_IS_NOT_SUPPORTED 반환). OR_OF_ANDS를 사용하면 Google Ads에서 규칙 항목 그룹의 모든 규칙 항목을 함께 AND하므로 규칙이 충족되려면 하나 이상의 규칙 항목 그룹에 있는 모든 규칙 항목이 일치해야 합니다.

규칙 항목 그룹 만들기에서 두 UserListRuleItemGroupInfo 객체를 정의한 후 이를 새 사용자 목록으로 결합합니다. 다음 코드 예시에서는 기본 OR_OF_ANDS 규칙 유형을 그대로 두고, FlexibleRuleUserListInfo의 FlexibleRuleOperandInfo에 두 규칙 항목 그룹을 모두 추가하고 사용자 목록을 변경합니다.

자바

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로 설정하여 규칙 기반 사용자 목록 (디스플레이 네트워크에서만 지원)에 이전 웹사이트 방문자 또는 앱 사용자를 포함하고 이 필드의 상태를 주기적으로 확인하여 비동기 사전 채우기 프로세스의 진행 상황을 모니터링할 수도 있습니다.

사전 입력은 목록의 membership_life_span (1~540일) 및 리마케팅 태그가 추가된 날짜에 따라 지난 30일 이내의 과거 사용자만 추가합니다. 요청이 처리되면 상태가 FINISHED로 업데이트되고, 요청이 실패하면 FAILED로 업데이트됩니다.

사용자 목록을 타겟팅하고 입찰가 조정

UserList를 만든 후 리소스 이름을 AdGroupCriterion 또는 CampaignCriterion에 연결하고 bid_modifier을 설정합니다 (예: 25% 입찰가 인상의 경우 1.25). 사용자 목록을 타겟팅하고 입찰가를 수정하는 방법을 보여주는 코드 예시는 목록 타겟팅을 참고하세요.

이전
규칙 항목 그룹 만들기