使用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应用交叉推广及对移动营销广告进行高效的优化管理，为开发者带来更高的广告收入。