文档Target开发人员指南

Analytics for Target (A4T) 报表

Last update: Thu Jul 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

Adobe Target 支持对设备上决策和服务器端Target活动进行A4T报告。 启用A4T报表的配置选项有两种：

  • Adobe Target 自动将分析有效负载转发到 Adobe Analytics，或
  • 用户从请求分析有效负载 Adobe Target. (Adobe Target 返回 Adobe Analytics 有效负荷返回给调用方。)
NOTE
设备上决策仅支持以下对象的A4T报表： Adobe Target 自动将分析有效负载转发到 Adobe Analytics. 正在从检索分析有效负载 Adobe Target 不受支持。

先决条件

  1. 在中配置活动 Adobe Target UI与 Adobe Analytics 作为报表源，并确保已为A4T启用帐户。
  2. API用户会生成Adobe Marketing Cloud访客ID，并确保此ID在执行Target请求时可用。

Adobe Target 自动转发分析有效负载

Adobe Target 可自动将分析有效负载转发到 Adobe Analytics 如果提供了以下标识符：

  1. supplementalDataId：用于拼合的ID Adobe Analytics 和 Adobe Target. 为了 Adobe Target 和 Adobe Analytics 要正确地将数据拼合在一起，请相同 supplementalDataId 需要传递给两者 Adobe Target 和 Adobe Analytics.
  2. trackingServer：和 Adobe Analytics 服务器。
Node.js
code language-js line-numbers 
const TargetClient = require("@adobe/target-nodejs-sdk");

const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@AdobeOrg"
};

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@AdobeOrg")
  .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);

用户从以下位置检索分析有效负载 Adobe Target

用户可以检索 Adobe Analytics 给定mbox的有效负载，然后将其发送到 Adobe Analytics 通过 数据插入API. 当 Adobe Target 请求已触发，通过 client_side 到 logging 字段。 如果在使用Analytics作为报表源的活动中存在指定的mbox，则将返回有效负载。

Node.js
code language-js line-numbers 
const TargetClient = require("@adobe/target-nodejs-sdk");
const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@AdobeOrg"
};
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@AdobeOrg")
  .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，您将在mbox字段中接收有效负载。

如果来自Target的响应包含 analytics -> payload 属性，按原样转发到 Adobe Analytics. Adobe Analytics 知道如何处理此有效负载。 这可以在GET请求中完成，可使用以下格式：

https://{datacollectionhost.sc.omtrdc.net}/b/ss/{rsid}/0/CODEVERSION?pe=tnt&tnta={payload}&mid={mid}&vid={vid}&aid={aid}

查询字符串参数和变量

字段名称
必需
描述
rsid
是
点击
pe
是
页面事件。 始终设置为 tnt
tnta
是
Target服务器返回的分析有效负载位于 analytics -> payload -> tnta
mid
是
Marketing Cloud 访客 ID

必需的标头值

标题名称
标头值
主机
Analytics数据收集服务器(如： adobeags421.sc.omtrdc.net)

示例A4T数据插入HTTP Get调用

https://demo.sc.omtrdc.net/b/ss/myCustomRsid/0/MOBILE-1.0?pe=tnt&tnta=285408:0:0|2&mid=2304820394812039
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3