文件TargetTarget開發人員指南

Analytics for Target (A4T)報告

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

建立對象：

  • 開發人員

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 Visitor ID，並確保此ID在執行Target要求時可供使用。

Adobe Target自動轉送Analytics裝載

如果提供了以下識別碼，Adobe Target可以自動將分析裝載轉送至Adobe Analytics：

  1. supplementalDataId：用來在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擷取分析裝載

使用者可以擷取特定mbox的Adobe Analytics裝載，然後透過Adobe Analytics資料插入API傳送給。 觸發Adobe 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@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}/{content_type_num}/{code_ver}/{session}?pe=tnt&tnta={payload}&c.&a.&target.&sessionId={sessionId}&.target&.a&.c&mid={mid}

查詢字串引數和變數

欄位名稱
必要
說明
rsid
是
報表套裝 ID
content_type_num
是
一律設為"0"
code_ver
是
一律設為「MOBILE-1.0」
session
是
一律設為"0"
pe
是
頁面事件。 一律設為tnt
tnta
是
Analytics中的Target伺服器傳回的analytics -> payload -> tnta裝載
sessionId
是
進行中工作階段的Target工作階段識別碼
mid
是
Marketing Cloud 訪客 ID

必要的標頭值

標頭名稱
標頭值
主機
Analytics資料收集伺服器（如： adobeags421.sc.omtrdc.net）

範例A4T資料插入HTTP Get呼叫

非URL編碼版本的可讀性（格式不用於API呼叫）：

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

URL編碼版本（用於API呼叫的格式）：

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