DokumentationTarget Developer Guide

Analyser för målrapportering (A4T)

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

Skapat för:

  • Utvecklare

Adobe Target har stöd för A4T-rapportering för både enhetsbeslut och Target-aktiviteter på serversidan. Det finns två konfigurationsalternativ för att aktivera A4T-rapportering:

  • Adobe Target skickar analysens nyttolast automatiskt till Adobe Analytics, eller
  • Användaren begär analysnyttolasten från Adobe Target. (Adobe Target returnerar Adobe Analytics nyttolast tillbaka till anroparen.)
NOTE
Enhetsbeslut stöder endast A4T-rapportering där Adobe Target skickar analysens nyttolast automatiskt till Adobe Analytics. Hämtar analysens nyttolast från Adobe Target stöds inte.

Krav

  1. Konfigurera aktiviteten i Adobe Target Gränssnitt med Adobe Analytics som rapportkälla och kontrollera att konton är aktiverade för A4T.
  2. API-användaren genererar Adobe Marketing Cloud Visitor-ID:t och ser till att detta ID är tillgängligt när Target-begäran körs.

Adobe Target vidarebefordrar Analytics-nyttolasten automatiskt

Adobe Target kan automatiskt vidarebefordra analysnyttolasten till Adobe Analytics om följande identifierare anges:

  1. supplementalDataId: Det ID som används för att sammanfoga Adobe Analytics och Adobe Target. För att Adobe Target och Adobe Analytics för att sammanfoga data på ett korrekt sätt supplementalDataId måste skickas till båda Adobe Target och Adobe Analytics.
  2. trackingServer: 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);

Användaren hämtar analysnyttolast från Adobe Target

En användare kan hämta Adobe Analytics nyttolast för en given mbox och skicka den sedan till Adobe Analytics via API för datainfogning. När en Adobe Target begäran utlöses, skickas client_side till logging i begäran. Detta returnerar en nyttolast om den angivna rutan finns i en aktivitet som använder Analytics som rapportkälla.

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

När du har angett logging = client_sidefår du nyttolasten i mbox-fältet.

Om svaret från Target innehåller något i analytics -> payload egenskap, vidarebefordra den som den är till Adobe Analytics. Adobe Analytics kan bearbeta den här nyttolasten. Detta kan göras i en GET-begäran i följande format:

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

Frågesträngsparametrar och variabler

Fältnamn
Obligatoriskt
Beskrivning
rsid
Ja
Rapportsvitens ID
pe
Ja
Sidhändelse. Alltid inställt på tnt
tnta
Ja
Analysnyttolasten som returnerats av målservern i analytics -> payload -> tnta
mid
Ja
Marketing Cloud Visitor-ID

Obligatoriska rubrikvärden

Rubriknamn
Huvudvärde
Värd
Server för insamling av analysdata (t.ex.: adobeags421.sc.omtrdc.net)

Exempel på A4T-datainmatning HTTP - Hämta anrop

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