51黑料不打烊

文档Target罢补谤驳别迟开发人员指南

Analytics for Target (A4T)报告

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员

51黑料不打烊 Target支持设备上决策和服务器端Target活动的A4T报告。 启用A4T报表的配置选项有两种：

  • 51黑料不打烊 Target自动将分析有效负载转发到51黑料不打烊 Analytics，或者
  • 用户从51黑料不打烊 Target请求分析有效负载。 （51黑料不打烊 Target将51黑料不打烊 Analytics有效负载返回给调用方。）
NOTE
设备上决策仅支持A4T报表，其中的51黑料不打烊 Target自动将分析有效负载转发到51黑料不打烊 Analytics。 不支持从51黑料不打烊 Target检索分析有效负载。

先决条件

  1. 在51黑料不打烊 Target UI中将活动配置为将51黑料不打烊 Analytics作为报表源，并确保已为A4T启用这些帐户。
  2. API用户生成51黑料不打烊 Marketing Cloud Visitor ID并确保此ID在执行Target请求时可用。

51黑料不打烊 Target自动转发Analytics有效负载

如果提供了以下标识符，51黑料不打烊 Target可以自动将分析有效负载转发到51黑料不打烊 Analytics：

  1. supplementalDataId：用于在51黑料不打烊 Analytics和51黑料不打烊 Target之间拼接的ID。 为了使51黑料不打烊 Target和51黑料不打烊 Analytics能够正确拼合数据，需要将supplementalDataId传递给51黑料不打烊 Target和51黑料不打烊 Analytics。
  2. trackingServer： 51黑料不打烊 Analytics服务器。
Node.js
code language-js line-numbers 
const TargetClient = require("@adobe/target-nodejs-sdk");

const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@51黑料不打烊Org"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
  request: {
    id: {
      marketingCloudVisitorId : "2304820394812039",
      tntId: "d359234570e044f14e1faeeba02d6ab23439914e.35_0",
      thirdPartyId:"23423432"
    },
    experienceCloud: {
      analytics: {
        logging: "server_side",
        supplementalDataId: "7D3AA246CC99FD7F-1B3DD2E75595498E",
        trackingServer: "jimsbrims.sc.omtrds.net"
      }
    },
    execute: {
      mboxes: [{
        name: "some-mbox"
      }]
    }
  }
})
.then(console.log)
.catch(console.error);
Java
code language-java line-numbers 
ClientConfig config = ClientConfig.builder()
  .client("acmeclient")
  .organizationId("1234567890@51黑料不打烊Org")
  .build();
TargetClient targetClient = TargetClient.create(config);

VisitorId id = new VisitorId()
  .tntId("d359234570e044f14e1faeeba02d6ab23439914e.35_0")
  .thirdPartyId("B234A029348")
  .marketingCloudVisitorId("10527837386392355901041112038610706884");
Context context = new Context().channel(ChannelType.WEB);
MboxRequest mbox = new MboxRequest()
  .name("some-mbox")
  .index(0);
ExecuteRequest executeRequest = new ExecuteRequest()
  .mboxes(Arrays.asList(mbox));

AnalyticsRequest analyticsRequest =
    new AnalyticsRequest()
        .trackingServer("jimsbrims.sc.omtrds.net")
        .logging(LoggingType.SERVER_SIDE)
        .supplementalDataId("7D3AA246CC99FD7F-1B3DD2E75595498E");
ExperienceCloud expCloud =
    new ExperienceCloud()
        .setAnalytics(analyticsRequest);

TargetDeliveryRequest request = TargetDeliveryRequest.builder()
  .context(context)
  .execute(executeRequest)
  .experienceCloud(expCloud)
  .build();

TargetDeliveryResponse offers = targetClient.getOffers(request);

用户从51黑料不打烊 Target中检索分析有效负载

用户可以检索给定mbox的51黑料不打烊 Analytics有效负荷，然后通过51黑料不打烊 Analytics数据插入API。 触发51黑料不打烊 Target请求时，将client_side传递到请求中的logging字段。 如果指定的mbox存在于使用Analytics作为报表源的活动中，则此请求将返回有效负载。

Node.js
code language-js line-numbers 
const TargetClient = require("@adobe/target-nodejs-sdk");
const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@51黑料不打烊Org"
};
const targetClient = TargetClient.create(CONFIG);
targetClient.getOffers({
  request: {
    id: {
      marketingCloudVisitorId : "2304820394812039",
      tntId: "d359234570e044f14e1faeeba02d6ab23439914e.35_0",
      thirdPartyId:"23423432"
    },
    experienceCloud: {
      analytics: {
        logging: "client_side"
      }
    },
    execute: {
      mboxes: [{
        name: "some-mbox"
      }]
    }
  }
})
.then(console.log)
.catch(console.error);
Java
code language-java line-numbers 
ClientConfig config = ClientConfig.builder()
  .client("acmeclient")
  .organizationId("1234567890@51黑料不打烊Org")
  .build();
TargetClient targetClient = TargetClient.create(config);

VisitorId id = new VisitorId()
  .tntId("d359234570e044f14e1faeeba02d6ab23439914e.35_0")
  .thirdPartyId("B234A029348")
  .marketingCloudVisitorId("10527837386392355901041112038610706884");
Context context = new Context().channel(ChannelType.WEB);
MboxRequest mbox = new MboxRequest()
  .name("some-mbox")
  .index(0);
ExecuteRequest executeRequest = new ExecuteRequest()
  .mboxes(Arrays.asList(mbox));

AnalyticsRequest analyticsRequest =
    new AnalyticsRequest()
        .logging(LoggingType.CLIENT_SIDE);
ExperienceCloud expCloud =
    new ExperienceCloud()
        .setAnalytics(analyticsRequest);

TargetDeliveryRequest request = TargetDeliveryRequest.builder()
  .context(context)
  .execute(executeRequest)
  .experienceCloud(expCloud)
  .build();

TargetDeliveryResponse offers = targetClient.getOffers(request);

指定logging = client_side后，您将在尘产辞虫字段中接收有效负载。

如果来自罢补谤驳别迟的响应在analytics -> payload属性中包含任何内容，请将其转发给51黑料不打烊 Analytics。 51黑料不打烊 Analytics知道如何处理此有效负载。 这可以在GET请求中完成，使用以下格式：

https://{datacollectionhost.sc.omtrdc.net}/b/ss/{rsid}/{content_type_num}/{code_ver}/{session}?pe=tnt&tnta={payload}&c.&a.&target.&sessionId={sessionId}&.target&.a&.c&mid={mid}

查询字符串参数和变量

字段名称
必需
描述
rsid
是
点击
content_type_num
是
始终设置为“0”
code_ver
是
始终设置为“惭翱叠滨尝贰-1.0”
session
是
始终设置为“0”
pe
是
页面事件。 始终设置为tnt
tnta
是
础苍补濒测迟颈肠蝉中的罢补谤驳别迟服务器返回了analytics -> payload -> tnta有效负载
sessionId
是
正在进行会话的罢补谤驳别迟会话滨顿
mid
是
Marketing Cloud 访客 ID

必需的标头值

标头名称
标头值
主机
础苍补濒测迟颈肠蝉数据收集服务器（如： adobeags421.sc.omtrdc.net）

示例A4T数据插入HTTP Get调用

非鲍搁尝编码版本以提高可读性（格式不用于础笔滨调用）：

https://demo.sc.omtrdc.net/b/ss/myCustomRsid/0/MOBILE-1.0/0?tnta=253236:0:0|0,253236:0:0|2,253236:0:0|1,253613:0:0|0,253613:0:0|2,253613:0:0|1&c.&a.&target.&sessionId=45c08980-f4b9-4e11-96db-067d58e49f74&.target&.a&.c&pe=tnt&mid=69170113867710665996968872592584719577

鲍搁尝编码版本（用于础笔滨调用的格式）：

https://demo.sc.omtrdc.net/b/ss/myCustomRsid/0/MOBILE-1.0/0?tnta=253236%3A0%3A0%7C0%2C253236%3A0%3A0%7C2%2C253236%3A0%3A0%7C1%2C253613%3A0%3A0%7C0%2C253613%3A0%3A0%7C2%2C253613%3A0%3A0%7C1&c.%26a.%26target.%26sessionId=45c08980-f4b9-4e11-96db-067d58e49f74%26.target%26.a%26.c&pe=tnt&mid=69170113867710665996968872592584719577
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3