DokumentationTargetTarget Developer Guide

Analytics for Target (A4T)-rapportering

Last update: Mon Aug 18 2025 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 vidarebefordrar automatiskt analysnyttolasten till Adobe Analytics, eller
  • Användaren begär analysnyttolasten från Adobe Target. (Adobe Target returnerar Adobe Analytics-nyttolasten till anroparen.)
NOTE
Enhetsbeslut stöder bara A4T-rapportering där Adobe Target automatiskt vidarebefordrar analysnyttolasten till Adobe Analytics. Hämtning av analysnyttolasten från Adobe Target stöds inte.

Krav

  1. Konfigurera aktiviteten i Adobe Target-gränssnittet med Adobe Analytics som rapportkälla och kontrollera att kontona är aktiverade för A4T.
  2. API-användaren genererar Adobe Marketing Cloud Visitor ID och ser till att det här ID:t ä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 mellan Adobe Analytics och Adobe Target. För att Adobe Target och Adobe Analytics ska kunna sammanfoga data på rätt sätt måste samma supplementalDataId skickas till både Adobe Target och Adobe Analytics.
  2. trackingServer: Servern 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);

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

En användare kan hämta Adobe Analytics-nyttolasten för en given mbox och sedan skicka den till Adobe Analytics via API:t för datainmatning. När en Adobe Target-begäran har utlösts skickar du client_side till fältet logging i begäran. Denna begäran returnerar en nyttolast om den angivna mbox 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_side får du nyttolasten i mbox-fältet.

Om svaret från Target innehåller något i egenskapen analytics -> payload vidarebefordrar du det som det är till Adobe Analytics. Adobe Analytics vet hur den här nyttolasten behandlas. Detta kan göras i en GET-begäran i följande format:

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}

Fråga strängparametrar och variabler

Fältnamn
Obligatoriskt
Beskrivning
rsid
Ja
Rapportsvitens ID
content_type_num
Ja
Alltid inställd på "0"
code_ver
Ja
Ställ alltid in på "MOBILE-1.0"
session
Ja
Alltid inställd på "0"
pe
Ja
Sidhändelse. Alltid inställd på tnt
tnta
Ja
Analytics nyttolast returnerades av Target-servern i analytics -> payload -> tnta
sessionId
Ja
Target sessions-ID för den pågående sessionen
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å infogning av A4T-data HTTP Get call

Icke-URL-kodad version För läsbarhet (format som inte ska användas för API-anrop):

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-kodad version (format för API-anrop):

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