DocumentatieDoelontwikkelaarsgids

Analyses voor doelrapportage (A4T)

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

Gemaakt voor:

  • Developer

Adobe Target steunt A4T rapportering voor zowel op-apparatenbesluit als server-zijactiviteiten van het Doel. Er zijn twee configuratieopties voor het inschakelen van A4T-rapporten:

  • Adobe Target stuurt de analytische lading automatisch door naar Adobe Analytics, of
  • De gebruiker vraagt de analytische lading van Adobe Target. (Adobe Target retourneert de Adobe Analytics nuttige lading terug naar de bezoeker.)
NOTE
Besluiten op een apparaat ondersteunen alleen A4T-rapporten waarvan Adobe Target stuurt de analytische lading automatisch door naar Adobe Analytics. De analytische lading ophalen uit Adobe Target wordt niet ondersteund.

Voorwaarden

  1. Vorm de activiteit in Adobe Target UI met Adobe Analytics als de bron van de rapportage en ervoor zorgen dat de accounts zijn ingeschakeld voor A4T.
  2. De API-gebruiker genereert de Adobe Marketing Cloud Visitor-id en zorgt ervoor dat deze id beschikbaar is wanneer de aanvraag voor het doel wordt uitgevoerd.

Adobe Target De lading van Analytics automatisch doorsturen

Adobe Target kan de analytische lading automatisch doorsturen naar Adobe Analytics indien de volgende identificatiecodes worden verstrekt:

  1. supplementalDataId: De id die wordt gebruikt om te schakelen tussen Adobe Analytics en Adobe Target. Om Adobe Target en Adobe Analytics om gegevens correct aan elkaar te binden, het zelfde supplementalDataId moet worden doorgegeven aan beide Adobe Target en Adobe Analytics.
  2. trackingServer: De 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);

Gebruiker haalt analytische lading op van Adobe Target

Een gebruiker kan de Adobe Analytics lading voor een bepaalde mbox, dan verzend het naar Adobe Analytics via de API voor gegevensinvoer. Wanneer een Adobe Target aanvraag is geactiveerd, doorgeven client_side aan de logging in de aanvraag. Dit zal een lading terugkeren als gespecificeerde mbox in een activiteit aanwezig is die Analytics als rapporteringsbron gebruikt.

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

Wanneer u logging = client_side, ontvangt u de lading in het mbox gebied.

Als de reactie van Doel iets in bevat analytics -> payload eigenschap, doorsturen naar de volgende Adobe Analytics. Adobe Analytics weet hoe deze lading moet worden verwerkt. Dit kan in een verzoek van de GET worden gedaan gebruikend het volgende formaat:

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

Parameters en variabelen voor queryreeks

Veldnaam
Vereist
Beschrijving
rsid
Ja
De rapportsuite-id
pe
Ja
Pagina-gebeurtenis. Altijd instellen op tnt
tnta
Ja
Analyselading die door de server van het Doel in wordt geretourneerd analytics -> payload -> tnta
mid
Ja
Bezoeker-id Marketing Cloud

Vereiste koptekstwaarden

Naam koptekst
Waarde koptekst
Host
Server voor gegevensverzameling voor analyse (bijv. adobeags421.sc.omtrdc.net)

Voorbeeld A4T Data Insertion HTTP Get Call

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