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

Adobe Target admite la creación de informes de A4T tanto para la toma de decisiones en el dispositivo como para las actividades de 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 desde Adobe Target. (Adobe Target devuelve el Adobe Analytics carga útil de vuelta al llamador).
NOTE
La toma de decisiones en el dispositivo solo admite informes de A4T de los cuales Adobe Target reenvía automáticamente la carga útil de analytics a Adobe Analytics. Recuperación de la carga útil de Analytics de Adobe Target no es compatible.

Requisitos previos

  1. Configure la actividad en Adobe Target IU 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: ID que se utiliza para vincular entre Adobe Analytics y Adobe Target. Para que Adobe Target y Adobe Analytics para unir correctamente los datos, siga el mismo procedimiento supplementalDataId debe pasarse a ambos Adobe Target y Adobe Analytics.
  2. trackingServer: La Adobe Analytics Servidor.
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);

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

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

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

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

Si la respuesta de Target contiene algo en analytics -> payload propiedad, reenvíela tal como está 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
La ID del grupo de informes
pe
Evento de página. Siempre establecido en tnt
tnta
Carga útil de Analytics devuelta por el servidor de Target en analytics -> payload -> tnta
mid
ID de visitante de Marketing Cloud

Valores de encabezado obligatorios

Nombre del encabezado
Valor de 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