获取选件(Java)
描述
getOffers()用于执行决策并从Adobe Target检索体验。
方法
getOffers
TargetClient.getOffers方法签名如下所示。
请求
TargetDeliveryResponse TargetClient.getOffers(TargetDeliveryRequest request)
TargetDeliveryRequest是使用TargetDeliveryRequest.builder创建的。
响应
TargetDeliveryRequestBuilder TargetDeliveryRequest.builder()
参数
TargetDeliveryRequestBuilder对象具有以下结构：
名称
类型
必需
描述
上下文
上下文
是
指定请求的上下文
sessionId
字符串
否
thirdPartyId
字符串
否
可随每次调用发送的用户的公司标识符
cookie
列表
否
同一用户的前Target个请求中返回的Cookie列表。
customerIds
地图
否
采用与VisitorId兼容格式的客户ID
执行
ExecuteRequest
否
要执行的PageLoad或mbox请求。 将立即在服务器端进行评估
预取
PrefetchRequest
否
Views、PageLoad或mbox请求进行预获取。 会返回转换时要返回的带有通知令牌的标记。
通知
列表
否
用于发送有关所显示预取内容的通知
requestid
字符串
否
将在响应中返回的请求ID。 如果未出现，则自动生成。
impressionId
字符串
否
如果存在，则具有相同ID的第二个和后续请求将不会增加活动/量度的展示次数。 如果未出现，则自动生成。
environmentId
长
否
有效的客户端环境ID。 如果未指定，则将根据提供的主机确定主机。
属性
属性
否
通过令牌字段指定at_property。 它可用于控制投放的范围。
trace
跟踪
否
启用投放API的跟踪。
qaMode
QAMode
否
使用此对象可在请求中启用QA模式。
locationHint
字符串
否
Target边缘群集位置提示。 用于为此请求定位给定的边缘群集。
visitor
访客
否
用于提供自定义访客API对象。
ID
VisitorId
否
包含访客标识符的对象。 例如 tntId、thirdParyId、mcId、customerIds。
experienceCloud
ExperienceCloud
否
指定与Audience Manager和Analytics的集成。 如果未提供，则使用Cookie自动填充。
tntId
字符串
否
Target中用户的主要标识符。 已从targetCookies获取。 如果未提供，则自动生成。
mcId
字符串
否
用于在不同的Adobe解决方案(ECID)之间合并和共享数据。 已从targetCookies获取。 如果未提供，则自动生成。
trackingServer
字符串
否
Adobe Analytics服务器，以便Adobe Target和Adobe Analytics将数据正确拼合在一起。
trackingServerSecure
字符串
否
为了Adobe Target和Adobe Analytics将数据正确拼合在一起，请使用Adobe Analytics Secure Server。
决策方法
决策方法
否
可用于为设备上决策明确设置ON_DEVICE或HYBRID决策方法
每个字段的值应符合 Target View Delivery API 请求规范。 若要了解有关 Target View Delivery API 的更多信息，请参阅http://developers.adobetarget.com/api/#view-delivery-overview
响应
TargetClient.getOffers(返回的TargetDeliveryResponse具有以下结构：
名称
类型
描述
request
TargetDeliveryRequest
Target 请求
响应
DeliveryResponse
Target 个回应
cookie
列表
此用户的会话元数据列表。 需要在此用户的下一个目标请求中传递。
visitorState
地图
要在客户端设置的访客状态，供访客API使用
responsestatus
响应状态
表示响应状态的对象
响应中的ResponseStatus包含以下字段：
名称
类型
描述
status
int
从Target返回的HTTP状态
message
字符串
如果HTTP状态不是200，则显示状态消息
remoteMbox
字符串列表
用于设备上决策。 包含具有无法完全在设备上决定的远程活动的mbox列表。
remoteView
字符串列表
用于设备上决策。 包含具有无法完全在设备上决定的远程活动的视图列表。
用于保存用户会话数据的TargetCookie对象具有以下结构：
名称
类型
描述
name
字符串
Cookie 名称
value
字符串
Cookie值，该值将转换为字符串
maxAge
数值
通过maxAge选项，可以方便地设置相对于当前时间（以秒为单位）的过期时间
你不必担心Cookie会过期。 Target处理SDK中的maxAge。
示例
请求
ClientConfig clientConfig = ClientConfig.builder()
.client("acmeclient")
.organizationId("1234567890@AdobeOrg")
.build();
TargetClient targetJavaClient = TargetClient.create(clientConfig);
List<MboxRequest> mboxRequests = new ArrayList<>();
mboxRequests.add((MboxRequest) new MboxRequest().name("a1-serverside-ab").index(1));
TargetDeliveryRequest targetDeliveryRequest = TargetDeliveryRequest.builder()
.context(new Context().channel(ChannelType.WEB))
.execute(new ExecuteRequest().setMboxes(mboxRequests))
.build();
响应
TargetDeliveryResponse targetResponse = targetJavaClient.getOffers(targetDeliveryRequest);
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3