DocumentaciónGuía para desarrolladores de Target

Creación de informes en Analytics for Target (A4T)

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

Creado para:

  • Desarrollador

Adobe Target admite informes de A4T tanto para la toma de decisiones en el dispositivo como para las actividades de Target en el lado del servidor. Existen dos opciones de configuración para activar la creación de informes de A4T:

  • Adobe Target reenvía automáticamente la carga útil de analytics a Adobe Analytics, o
  • El usuario solicita la carga útil de Analytics de Adobe Target. (Adobe Target devuelve la carga útil Adobe Analytics al llamador).
NOTE
La toma de decisiones en el dispositivo solo admite la creación de informes de A4T, de los cuales Adobe Target reenvía automáticamente la carga útil de Analytics a Adobe Analytics. No se admite recuperar la carga útil de Analytics de Adobe Target.

Requisitos previos

  1. Configure la actividad en la interfaz de usuario Adobe Target con Adobe Analytics como fuente de informes y asegúrese de que las cuentas estén habilitadas para A4T.
  2. El usuario de la API genera el ID de visitante de Adobe Marketing Cloud y garantiza que este ID esté disponible cuando se ejecuta la solicitud de Target.

Adobe Target reenvía automáticamente la carga útil de Analytics

Adobe Target puede reenviar automáticamente la carga útil de Analytics a Adobe Analytics si se proporcionan los siguientes identificadores:

  1. supplementalDataId: el identificador que se utiliza para unir Adobe Analytics y Adobe Target. Para que Adobe Target y Adobe Analytics unan correctamente los datos, se debe pasar el mismo supplementalDataId a Adobe Target y a Adobe Analytics.
  2. trackingServer: el servidor Adobe Analytics.
Nodo.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);

El usuario recupera la carga útil de Analytics de Adobe Target

Un usuario puede recuperar la carga útil de Adobe Analytics para un mbox determinado y luego enviarla a Adobe Analytics a través de la API de inserción de datos. Cuando se activa una solicitud Adobe Target, pase client_side al campo logging de la solicitud. Esto devolverá una carga útil si el mbox especificado está presente en una actividad que utiliza Analytics como fuente de informes.

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

Una vez que haya especificado logging = client_side, recibirá la carga útil en el campo de mbox.

Si la respuesta de Target contiene algo en la propiedad analytics -> payload, reenvíela tal cual a Adobe Analytics. Adobe Analytics sabe cómo procesar esta carga útil. Esto se puede hacer en una solicitud de GET con el siguiente formato:

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

Parámetros y variables de cadena de consulta

Nombre del campo
Requerido
Descripción
rsid
Sí
La ID del grupo de informes
pe
Sí
Evento de página. Siempre establecido en tnt
tnta
Sí
Carga útil de Analytics devuelta por el servidor de Target en analytics -> payload -> tnta
mid
Sí
ID de visitante de Marketing Cloud

Valores de encabezado obligatorios

Nombre del encabezado
Valor del encabezado
Host
Servidor de recopilación de datos de Analytics (p. ej.: adobeags421.sc.omtrdc.net)

Ejemplo de llamada de obtención HTTP de inserción de datos de 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