DokumentationTargetTarget-Entwicklerhandbuch

Analytics for Target (A4T)-Reporting

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

Erstellt für:

  • Entwickler

Adobe Target unterstützt A4T-Reporting sowohl für die geräteinterne Entscheidungsfindung als auch für Server-seitige Target. Es gibt zwei Konfigurationsoptionen zum Aktivieren von A4T-Berichten:

  • Adobe Target leitet die Analytics-Payload automatisch an Adobe Analytics weiter oder
  • Der Benutzer fordert die Analytics-Payload von Adobe Target an. (Adobe Target gibt die Adobe Analytics Payload an den Aufrufer zurück.)
NOTE
Die geräteinterne Entscheidungsfindung unterstützt nur A4T-Berichte, von denen Adobe Target die Analytics-Payload automatisch an Adobe Analytics weiterleitet. Das Abrufen der Analytics-Payload aus Adobe Target wird nicht unterstützt.

Voraussetzungen

  1. Konfigurieren Sie die Aktivität in der Adobe Target-Benutzeroberfläche mit Adobe Analytics als Berichtsquelle und stellen Sie sicher, dass die Konten für A4T aktiviert sind.
  2. Der API-Benutzer generiert die Adobe-Marketing Cloud Visitor ID und stellt sicher, dass diese ID verfügbar ist, wenn die Target ausgeführt wird.

Adobe Target leitet die Analytics Payload automatisch weiter

Adobe Target können die Analytics-Payload automatisch an Adobe Analytics weiterleiten, wenn die folgenden Kennungen bereitgestellt werden:

  1. supplementalDataId: Die ID, die verwendet wird, um zwischen Adobe Analytics und Adobe Target zuzuordnen. Damit Adobe Target und Adobe Analytics Daten korrekt zusammenfügen können, muss dieselbe supplementalDataId sowohl an Adobe Target als auch an Adobe Analytics übergeben werden.
  2. trackingServer: Der 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);

Benutzer ruft Analytics-Payload von Adobe Target ab

Ein Benutzer kann die Adobe Analytics Payload für eine bestimmte Mbox abrufen und dann über die „Data Insertion Adobe Analytics" an 🔗. Wenn eine Adobe Target-Anfrage ausgelöst wird, übergeben Sie client_side an das Feld logging in der Anfrage. Diese Anfrage gibt eine Payload zurück, wenn die angegebene Mbox in einer Aktivität vorhanden ist, die Analytics als Berichtsquelle verwendet.

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);

Nachdem Sie logging = client_side angegeben haben, erhalten Sie die Payload im mbox-Feld.

Wenn die Antwort von Target etwas in der analytics -> payload-Eigenschaft enthält, leiten Sie sie so weiter, wie sie ist, an Adobe Analytics. Adobe Analytics weiß, wie diese Payload verarbeitet wird. Dies kann in einer GET-Anfrage im folgenden Format erfolgen:

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}

Parameter und Variablen von Abfragezeichenfolgen

Feldname
Erforderlich
Beschreibung
rsid
Ja
Die Report Suite-ID
content_type_num
Ja
Immer auf „0“ festgelegt
code_ver
Ja
Immer auf „MOBILE-1.0“ eingestellt
session
Ja
Immer auf „0“ festgelegt
pe
Ja
Seitenereignis. Immer auf tnt gesetzt
tnta
Ja
Analytics Payload, die von Target Server in analytics -> payload -> tnta zurückgegeben wird
sessionId
Ja
Target Sitzungs-ID der aktuellen Sitzung
mid
Ja
Marketing Cloud-Besucher-ID

Erforderliche Kopfzeilenwerte

Header-Name
Header-Wert
Host
Analytics-Datenerfassungs-Server (z. B.: adobeags421.sc.omtrdc.net)

Beispiel für HTTP-GET-Aufruf zum Einfügen von A4T-Daten

Nicht URL-kodierte Version für bessere Lesbarkeit (Format für API-Aufrufe nicht zu verwenden):

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-codierte Version (für API-Aufrufe zu verwendendes Format):

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