DocumentazioneGuida per gli sviluppatori di Target

Reporting di Analytics for Target (A4T)

Last update: Sat Jul 20 2024 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’ID visitatore di Adobe Marketing Cloud e si assicura che sia disponibile quando viene eseguita la richiesta di Target.

Adobe Target inoltra automaticamente il payload di 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. Questo restituirà 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 qualcosa 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}/0/CODEVERSION?pe=tnt&tnta={payload}&mid={mid}&vid={vid}&aid={aid}

Parametri e variabili della stringa di query

Nome campo
Obbligatorio
Descrizione
rsid
Sì
ID suite di rapporti
pe
Sì
Evento pagina. Sempre impostato su tnt
tnta
Sì
Payload di Analytics restituito dal server di Target in analytics -> payload -> tnta
mid
Sì
ID visitatore di Marketing Cloud

Valori intestazione richiesti

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

Esempio di chiamata HTTP Get di inserimento dati A4T

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