Rapports Analytics for Target (A4T)

Adobe Target prend en charge les rapports A4T pour la prise de décision sur les appareils et les activités Target côté serveur. Il existe deux options de configuration pour activer les rapports A4T :

  • Adobe Target transfère automatiquement la charge utile analytics vers Adobe Analytics, ou
  • L’utilisateur demande la charge utile Analytics à partir de Adobe Target. (Adobe Target renvoie la variable Adobe Analytics payload vers l’appelant.)
NOTE
La prise de décision sur les appareils ne prend en charge que les rapports A4T pour lesquels Adobe Target transfère automatiquement la charge utile analytics vers Adobe Analytics. Récupération de la charge utile Analytics depuis Adobe Target n’est pas prise en charge.

Conditions requises

  1. Configurez l’activité dans la Adobe Target Interface utilisateur avec Adobe Analytics comme source de création de rapports et assurez-vous que les comptes sont activés pour A4T.
  2. L’utilisateur de l’API génère l’identifiant visiteur Adobe Marketing Cloud et s’assure que cet identifiant est disponible lors de l’exécution de la requête Target.

Adobe Target transfère automatiquement la charge utile Analytics

Adobe Target peut transférer automatiquement la charge utile analytics vers Adobe Analytics si les identifiants suivants sont fournis :

  1. supplementalDataId: identifiant utilisé pour se regrouper entre les Adobe Analytics et Adobe Target. Pour Adobe Target et Adobe Analytics pour regrouper correctement les données, la même supplementalDataId doit être transmis aux deux Adobe Target et Adobe Analytics.
  2. trackingServer: la variable Adobe Analytics Serveur.
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’utilisateur récupère la payload d’analyse depuis Adobe Target

Un utilisateur peut récupérer la variable Adobe Analytics charge utile pour une mbox donnée, puis l’envoyer à Adobe Analytics via le API d’insertion de données. Lorsqu’une Adobe Target est déclenchée, passe client_side à la fonction logging dans la requête. Cela renverra un payload si la mbox spécifiée est présente dans une activité qui utilise Analytics comme source de création de rapports.

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

Une fois que vous avez spécifié logging = client_side, vous recevrez la charge utile dans le champ de mbox.

Si la réponse de Target contient quelque chose dans la variable analytics -> payload propriété, transférez-la tel qu’il est à Adobe Analytics. Adobe Analytics sait comment traiter cette payload. Vous pouvez le faire dans une requête de GET au format suivant :

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

Paramètres et variables de chaîne de requête

Nom du champ
Requis
Description
rsid
Oui
Identifiant de la suite de rapports
pe
Oui
Événement de page. Toujours définie sur tnt
tnta
Oui
Charge utile Analytics renvoyée par le serveur Target dans analytics -> payload -> tnta
mid
Oui
Identifiant visiteur Marketing Cloud

Valeurs d’en-tête requises

Nom de l'en-tête
Valeur de l'en-tête
Hôte
Serveur de collecte de données Analytics (par exemple : adobeags421.sc.omtrdc.net)

Exemple d’appel de récupération HTTP pour l’insertion de données 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