DokumentationTarget-Entwicklerhandbuch

Berichterstellung von Analytics for Target (A4T)

Last update: Tue Dec 31 2024 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-Aktivitäten. 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-Besucher-ID und stellt sicher, dass diese ID verfügbar ist, wenn die Target-Anfrage 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 " an Adobe Analytics. Wenn eine Adobe Target-Anfrage ausgelöst wird, übergeben Sie client_side an das Feld 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);

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

Wenn die Target-Antwort 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}/0/CODEVERSION?pe=tnt&tnta={payload}&mid={mid}&vid={vid}&aid={aid}

Parameter und Variablen von Abfragezeichenfolgen

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

Erforderliche Kopfzeilenwerte

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

HTTP-GET-Aufruf zum Einfügen von Beispiel-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