DokumentationTarget-Entwicklerhandbuch

Berichterstellung von Analytics for Target (A4T)

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

Erstellt für:

  • Developer

Adobe Target unterstützt A4T-Berichte für Entscheidungen auf dem Gerät und für serverseitige Target-Aktivitäten. Es gibt zwei Konfigurationsoptionen für die Aktivierung der A4T-Berichterstellung:

  • Adobe Target leitet die Analytics-Nutzlast automatisch an Adobe Analyticsoder
  • Der Benutzer fordert die Analytics-Nutzlast von Adobe Target. (Adobe Target gibt die Adobe Analytics Nutzlast an den Aufrufer zurück.)
NOTE
Die Entscheidungsfindung auf dem Gerät unterstützt nur A4T-Berichte, von denen Adobe Target leitet die Analytics-Nutzlast automatisch an Adobe Analytics. Analytics-Nutzlast abrufen von Adobe Target wird nicht unterstützt.

Voraussetzungen

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

Adobe Target leitet die Analytics-Payload automatisch weiter

Adobe Target kann die Analyse-Payload automatisch an weiterleiten Adobe Analytics wenn die folgenden Kennungen angegeben sind:

  1. supplementalDataId: Die ID, die zum Zuordnen zwischen verwendet wird Adobe Analytics und Adobe Target. Zur Adobe Target und Adobe Analytics zum korrekten Zusammenfügen von Daten, das gleiche supplementalDataId muss an beide übergeben werden Adobe Target und Adobe Analytics.
  2. trackingServer: Die Adobe Analytics Server.
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 die Analytics-Nutzlast von ab Adobe Target

Ein Benutzer kann die Adobe Analytics Nutzlast für eine bestimmte Mbox und anschließender Versand an Adobe Analytics über die Dateneinfüge-API. Wenn ein Adobe Target Anfrage wird ausgelöst, Übergeben client_side der logging in der Anfrage. Dadurch wird eine Payload zurückgegeben, 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);

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

Wenn die Antwort von Target etwas im analytics -> payload -Eigenschaft, leiten Sie sie wie gewünscht 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}/0/CODEVERSION?pe=tnt&tnta={payload}&mid={mid}&vid={vid}&aid={aid}

Abfragezeichenfolgenparameter und Variablen

Feldname
Erforderlich
Beschreibung
rsid
Ja
Die Report Suite-ID
pe
Ja
Seitenereignis. Immer auf tnt
tnta
Ja
Analytics-Nutzlast, die vom Target-Server in zurückgegeben wird analytics -> payload -> tnta
mid
Ja
Marketing Cloud-Besucher-ID

Erforderliche Kopfzeilenwerte

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

Beispiel für einen HTTP-Abruf zum Einfügen von A4T-Daten

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