使用AdWords API设置再营销方法添加移动聚合平台教程

一:设置用户列表和转化跟踪代码
设置再营销的第一步是将您的用户归入一个用户列表（即再营销列表），随后您可以利用该列表将广告定位到整个网络或者在Google上进行搜索的用户。为了完成这一步操作，您需要设置API中的BasicUserList，具体如下所示：

//创建转化类型（HTML/JS代码）。
UserListConversionType conversionType =new UserListConversionType();
conversionType.setName("Mars cruise customers #" +System.currentTimeMillis());


//创建基本用户列表。
BasicUserList userList = new BasicUserList();
userList.setName("Mars cruise customers #" +
System.currentTimeMillis());
userList.setDescription(
"A list of mars cruise customers in the last year");
userList.setMembershipLifeSpan(365L);
userList.setConversionTypes(
new UserListConversionType[] {conversionType});
userList.setStatus(UserListMembershipStatus.OPEN);


//创建操作。
UserListOperation operation= new UserListOperation();
operation.setOperand(userList);
operation.setOperator(Operator.ADD);
UserListOperation[] operations=new UserListOperation[] {operation};


//添加用户列表。
UserListReturnValue result= adWordsUserListService.mutate(operations);


//获取用户列表。
BasicUserList userList = result.getValue().get(0);
请注意，该列表中附加了UserListConversionType。这将会触发生成转化跟踪代码（即转化像素，也就是包含您网站上所放置的JavaScript代码的一段HTML代码）的操作。访问者只要访问包含这段代码的页面，就会被添加到您的列表中。如果您已经设置了转化跟踪，那么您可以通过在创建列表时提供现有跟踪代码的ID来重复使用现有的跟踪代码。


您需要考虑的其他重要的BasicUserList属性还有membershipLifeSpan和status。membershipLifeSpan可以让您定义用户属于该列表的有效期（以天为单位）。status可以定义该列表是否接受新用户。不过，封闭的列表仍然可以用于定位。


BasicUserList还包括一个非常有用的只读字段，即size，您可以通过该字段查询该列表的估算大小。通过该字段，您可以了解该列表实际上能否吸收用户。


第二步是获取您将要放置到网页上的转化跟踪器代码段。以下代码段将向您展示如何完成这一步骤：
//从用户列表创建操作中获取跟踪器ID。
String conversionId = userList.getConversionTypes().get(0)
.getId().toString();


//创建谓词和选择器。
Predicate predicate = new Predicate();
predicate.setField("Id");
predicate.setOperator(PredicateOperator.IN);
predicate.setValues(new String [] { conversionId });
Selector selector = new Selector();
selector.setFields(new String[] {"Id"});
selector.setPredicates(new Predicate[] {predicate});


//获取所有转化跟踪代码。
Map<Long, AdWordsConversionTracker> conversionTrackers =
new HashMap<Long, AdWordsConversionTracker>();
ConversionTrackerPage page =conversionTrackerService.get(selector);


//输出转化跟踪代码的代码段。
System.out.println(page.getEntries().get(0).getSnippet());


二:定位用户列表
现在，列表和跟踪代码已准备就绪，您可以使用列表来定位广告了。使用用户列表进行定位与API中其他类型的定位条件大同小异。以下代码将向您展示如何使用CriterionUserList来完成此项任务：
//创建用户列表定位条件。
CriterionUserList userListCriterion = new CriterionUserList();
userListCriterion.setUserListId(userListId);


//创建可出价的广告组定位条件。
BiddableAdGroupCriterion biddableCriterion =
new BiddableAdGroupCriterion();
biddableCriterion.setAdGroupId(adGroupId);
biddableCriterion.setCriterion(userListCriterion);


//创建操作。
AdGroupCriterionOperation operation = new AdGroupCriterionOperation();
operation.setOperand(biddableCriterion);
operation.setOperator(Operator.ADD);
AdGroupCriterionOperation[] operations =
new AdGroupCriterionOperation[] {operation};


//添加关键字。
AdGroupCriterionReturnValue result =
adGroupCriterionService.mutate(operations);
与其他类型的条件类似，您可以为BiddableAdGroupCriterion对象指定其他属性，例如出价覆盖。


三:综合用户列表
除基本用户列表外，您还可以使用LogicalUserList来构建用户列表的自定义组合。使用UserListLogicalRule，即可将一系列UserLists和UserInterest组合在一起。LogicalUserList中不同规则之间是“且”的关系，因此用户必须符合每条规则才能归入该列表。但是，每条规则可以让您将操作数指定为“且”或者“或”。换句话说，您可以指定，用户必须满足规则的所有操作数还是只需满足其中之一。

此外，规则还允许您将其他LogicalUserList指定为操作数，这样就可以方便您创建一个树状图。如您所见，LogicalUserList是一个非常强大的工具，可以帮助您在定位时为再营销分组定义复杂的层次结构。

以下代码将向您展示如何创建包含BasicUserList和UserInterest的LogicalUserList：
//包含Google Mars客户的基本用户列表。
BasicUserList basicList = new BasicUserList();
basicList.setId(basicUserList.getId());

UserInterest userInterest = new UserInterest();
userInterest.setId(668L);

UserListLogicalRule rule = new UserListLogicalRule(
UserListLogicalRuleOperator.ANY,
new LogicalUserListOperand[] {
new LogicalUserListOperand(null, basicList),
new LogicalUserListOperand(userInterest, null)});


//创建逻辑用户列表。
LogicalUserList combinationList = new LogicalUserList();
combinationList.setName("My combination list of Mars customers #"
+ System.currentTimeMillis());
combinationList.setRules(new UserListLogicalRule[] {rule});


//创建操作。
UserListOperation operation = new UserListOperation();
operation.setOperand(combinationList);
operation.setOperator(Operator.ADD);

UserListOperation[] operations =new UserListOperation[] {operation};


//添加逻辑用户列表。
UserListReturnValue result = userListService.mutate(operations);


四:获取再营销统计数据
AUDIENCE_PERFORMANCE_REPORT可显示收集用户列表和用户兴趣的效果报告所需的字段。


KeyMob移动聚合平台是基于专业的移动应用广告管理工具,是目前比较优秀的移动聚合平台,旨在为广大开发者提供安卓应用推广与IOS应用交叉推广及对移动营销广告进行高效的优化管理，为开发者带来更高的广告收入。