获取选件(.NET)

描述

GetOffers()用于执行决策并从Adobe Target检索体验。

方法

TargetClient.GetOffers方法签名。

.NET

TargetDeliveryResponse TargetClient.GetOffers(TargetDeliveryRequest request)

TargetDeliveryRequest是使用TargetDeliveryRequest.Builder创建的。

.NET

TargetDeliveryRequest.Builder TargetDeliveryRequest.Builder()

参数

TargetDeliveryRequest.Builder对象具有以下结构:

名称
类型
必需
描述
上下文
上下文
指定请求的上下文
sessionId
字符串
用于链接多个Target请求
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投放API请求规范。

响应

TargetClient.GetOffers()返回的TargetDeliveryResponse具有以下结构:

名称
类型
描述
请求
TargetDeliveryRequest​
Target投放API请求
响应
DeliveryResponse​
Target投放API*响应
状态
HttpStatusCode
响应HTTP状态代码
消息
字符串
响应状态消息或错误消息
位置
位置
Target位置名称,包括全局mbox名称和mbox/视图,仅对此位置提供远程决策
GetCookies
词典
返回此用户的会话元数据的字典。 此用户需要在下一个Target请求中传递。
访客状态
IDictionary
要在客户端为访客API Javascript库初始化设置的访客状态

用于保存用户会话数据的TargetCookie对象具有以下结构:

名称
类型
描述
名称
字符串
Cookie 名称
字符串
Cookie值
MaxAge
int
使用MaxAge选项可以方便地设置相对于当前时间(以秒为单位)的过期时间

你不必担心Cookie会过期。 Target处理SDK中的MaxAge

示例

.NET

var targetClientConfig = new TargetClientConfig.Builder("acmeClient", "ABCDEF012345677890ABCDEF0@AdobeOrg")
    .Build();

var targetClient = TargetClient.Create(targetClientConfig);

var mboxRequests = new List<MboxRequest> { new (index: 1, name: "a1-serverside-ab") };

var targetDeliveryRequest = new TargetDeliveryRequest.Builder()
    .SetExecute(new ExecuteRequest(mboxes: mboxRequests))
    .Build();

var targetResponse = targetClient.GetOffers(targetDeliveryRequest);
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3