DocumentazioneTargetGuida per gli sviluppatori di Target

Generazione rapporti per Analytics for Target (A4T)

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Adobe Target supporta il reporting A4T sia per le attività di decisioning sul dispositivo che per le attività Target lato server. Esistono due opzioni di configurazione per abilitare il reporting A4T:

  • Adobe Target inoltra automaticamente il payload di analytics a Adobe Analytics, oppure
  • L'utente richiede il payload di Analytics da Adobe Target. (Adobe Target restituisce il payload Adobe Analytics al chiamante.)
NOTE
Il decisioning sul dispositivo supporta solo il reporting A4T, di cui Adobe Target inoltra automaticamente il payload di Analytics a Adobe Analytics. Il recupero del payload di Analytics da Adobe Target non è supportato.

Prerequisiti

  1. Configurare l'attività nell'interfaccia utente di Adobe Target con Adobe Analytics come origine per la generazione di rapporti e assicurarsi che gli account siano abilitati per A4T.
  2. L'utente API genera l'Adobe Marketing Cloud Visitor ID e garantisce che questo ID sia disponibile quando viene eseguita la richiesta Target.

Adobe Target inoltra automaticamente il payload Analytics

Adobe Target può inoltrare automaticamente il payload di Analytics a Adobe Analytics se vengono forniti i seguenti identificatori:

  1. supplementalDataId: ID utilizzato per unire tra Adobe Analytics e Adobe Target. Affinché Adobe Target e Adobe Analytics possano unire correttamente i dati, è necessario passare lo stesso supplementalDataId a Adobe Target e Adobe Analytics.
  2. trackingServer: Il Server 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);

L'utente recupera il payload di Analytics da Adobe Target

Un utente può recuperare il payload Adobe Analytics per una data mbox, quindi inviarlo a Adobe Analytics tramite l'API di inserimento dati. Quando viene attivata una richiesta Adobe Target, passare client_side al campo logging nella richiesta. Questa richiesta restituisce un payload se la mbox specificata è presente in un'attività che utilizza Analytics come origine per la generazione di rapporti.

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

Dopo aver specificato logging = client_side, riceverai il payload nel campo mbox.

Se la risposta di Target contiene elementi nella proprietà analytics -> payload, inoltrarla così com'è a Adobe Analytics. Adobe Analytics sa come elaborare questo payload. Questa operazione può essere eseguita in una richiesta GET utilizzando il seguente formato:

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}

Parametri e variabili della stringa di query

Nome campo
Obbligatorio
Descrizione
rsid
Sì
ID suite di rapporti
content_type_num
Sì
Sempre impostato su "0"
code_ver
Sì
Sempre impostato su "MOBILE-1.0"
session
Sì
Sempre impostato su "0"
pe
Sì
Evento pagina. Sempre impostato su tnt
tnta
Sì
Payload Analytics restituito dal server Target in analytics -> payload -> tnta
sessionId
Sì
ID sessione Target della sessione in corso
mid
Sì
ID visitatore di Marketing Cloud

Valori di intestazione richiesti

Nome intestazione
Valore intestazione
Host
Server di raccolta dati di Analytics (esempio: adobeags421.sc.omtrdc.net)

Esempio di chiamata HTTP Get per inserimento dati A4T

Versione non codificata URL per la leggibilità (formato non da utilizzare per le chiamate API):

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

Versione con codifica URL (formato da utilizzare per le chiamate API):

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