DokumentationTarget Developer Guide

Analyser för målrapportering (A4T)

Last update: Sat Jul 20 2024 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 målaktiviteter 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:t och ser till att detta ID är tillgängligt när Target-begäran körs.

Adobe Target vidarebefordrar automatiskt Analytics-nyttolasten

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. 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_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}/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älld på tnt
tnta
Ja
Analysnyttolasten returnerades 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