DocumentaciónTargetGuía para desarrolladores de Target

Informes Analytics for Target (A4T)

Last update: Mon Aug 18 2025 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 Target del 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 API genera el Adobe Marketing Cloud Visitor ID y garantiza que este identificador esté disponible cuando se ejecute la solicitud Target.

Adobe Target reenvía automáticamente la carga útil 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. Esta solicitud devuelve una carga útil si el mbox especificado está presente en una actividad que usa 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 petición GET utilizando el siguiente 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}

Parámetros y variables de cadena de consulta

Nombre del campo
Requerido
Descripción
rsid
Sí
La ID del grupo de informes
content_type_num
Sí
Siempre se establece en "0"
code_ver
Sí
Siempre establecido en "MOBILE-1.0"
session
Sí
Siempre se establece en "0"
pe
Sí
Evento de página. Siempre establecido en tnt
tnta
Sí
Carga útil Analytics devuelta por el servidor Target en analytics -> payload -> tnta
sessionId
Sí
Target ID de sesión de la sesión en curso
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 Get HTTP de inserción de datos de A4T

Versión sin codificación URL para legibilidad (formato que no se utilizará para las llamadas a la 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

Versión con codificación URL (formato que se utilizará para las llamadas 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