리마케팅 캠페인에서 사용자 목록을 사용하여 웹사이트 또는 앱에서 특정 작업을 수행한 사용자의 재참여를 유도할 수 있습니다. 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는 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::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로 설정하여 규칙 기반 사용자 목록(디스플레이 네트워크에서만 지원됨)에 이전 웹사이트 방문자 또는 앱 사용자를 포함하고 이 필드의 상태를 주기적으로 확인하여 비동기 사전 입력 프로세스의 진행 상황을 모니터링할 수도 있습니다.
사전 입력은 목록의 membership_life_span (1~540일) 및 리마케팅 태그가 추가된 날짜에 따라 지난 30일 이내의 이전 사용자만 추가합니다. 요청이 처리되면 상태가 FINISHED로 업데이트되고 요청이 실패하면 FAILED로 업데이트됩니다.
사용자 목록 타겟팅 및 입찰가 조정
UserList를 만든 후에는 리소스 이름을
AdGroupCriterion 또는
CampaignCriterion에 연결하고 bid_modifier를 설정합니다(예:
입찰가를 25% 높이려면 1.25). 사용자 목록을 타겟팅하고 입찰가를 수정하는 방법을 보여주는 코드 예는 목록 타겟팅을 참고하세요.