DocumentationGuide du développeur de Target

Rapports Analytics for Target (A4T)

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

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 d’analyse vers Adobe Analytics, ou
  • L’utilisateur demande la charge utile Analytics à Adobe Target. (Adobe Target renvoie la charge utile Adobe Analytics à l’appelant.)
NOTE
La prise de décision sur les appareils ne prend en charge que les rapports A4T dont Adobe Target transfère automatiquement la charge d’analyse vers Adobe Analytics. La récupération de la charge utile Analytics à partir de Adobe Target n’est pas prise en charge.

Conditions requises

  1. Configurez l’activité dans l’interface utilisateur de Adobe Target 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 d’analyse vers Adobe Analytics si les identifiants suivants sont fournis :

  1. supplementalDataId : ID utilisé pour assembler entre Adobe Analytics et Adobe Target. Pour que Adobe Target et Adobe Analytics réunissent correctement les données, le même supplementalDataId doit être transmis à la fois à Adobe Target et Adobe Analytics.
  2. trackingServer : le serveur 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’utilisateur récupère la charge utile Analytics de Adobe Target

Un utilisateur peut récupérer la charge utile Adobe Analytics pour une mbox donnée, puis l’envoyer à Adobe Analytics via l’ API d’insertion de données. Lorsqu’une requête Adobe Target est déclenchée, transmettez client_side au champ logging de 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 mbox.

Si la réponse de Target contient quoi que ce soit dans la propriété analytics -> payload, transmettez-la telle quelle à 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