리마케팅 캠페인에서 사용자 목록을 사용하여 웹사이트 또는 앱에서 특정 작업을 수행한 사용자의 재참여를 유도할 수 있습니다. Google Ads API는 여러 유형의 사용자 목록을 지원합니다. 이 가이드에서는 규칙 기반 사용자 목록을 만드는 데 중점을 둡니다.
규칙 기반 사용자 목록
flexible_rule_user_list로 빌드된 규칙 기반 사용자 목록에는 여러 규칙이 포함될 수 있습니다. 각 규칙은 UserListRuleInfo 메시지로 표현되며, 이 메시지에는 규칙 항목 그룹 내의 규칙 항목이 결합되는 방식을 지정하는 rule_type이 있습니다.
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::V22::Common::FlexibleRuleUserListInfo->new({ inclusiveRuleOperator => AND, inclusiveOperands => [ Google::Ads::GoogleAds::V22::Common::FlexibleRuleOperandInfo->new({ rule => Google::Ads::GoogleAds::V22::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 => []});
규칙 기반 목록에 과거 사용자 포함하기
사용자 목록의 prepopulation_status을 REQUESTED로 설정하여 규칙 기반 사용자 목록에 이전 사용자를 포함할 수도 있으며, 이 필드의 상태를 주기적으로 확인하여 비동기 자동 입력 프로세스의 진행 상황을 모니터링할 수 있습니다.
이는 목록의 회원 기간과 리마케팅 태그가 추가된 날짜에 따라 지난 30일 이내의 과거 사용자만 추가합니다. 요청이 처리되면 상태가 FINISHED로 업데이트되고, 요청이 실패하면 FAILED로 업데이트됩니다.