DocumentaçãoGuia do desenvolvedor do Target

Relatórios do Analytics for Target (A4T)

Last update: Thu Jul 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Developer

Adobe Target O oferece suporte aos relatórios do A4T para decisões no dispositivo e atividades do Target do lado do servidor. Há duas opções de configuração para ativar os relatórios do A4T:

  • Adobe Target encaminha automaticamente a carga do analytics para Adobe Analyticsou
  • O usuário solicita a carga de análise de Adobe Target. (Adobe Target retorna o Adobe Analytics para o chamador.)
NOTE
A decisão no dispositivo só oferece suporte aos relatórios do A4T, dos quais Adobe Target encaminha automaticamente a carga do analytics para Adobe Analytics. Recuperação da carga de análise de Adobe Target não é compatível.

Pré-requisitos

  1. Configure a atividade no Adobe Target Interface com o Adobe Analytics como fonte de relatórios e verifique se as contas estão habilitadas para o A4T.
  2. O usuário da API gera a ID de visitante da Adobe Marketing Cloud e garante que essa ID esteja disponível quando a solicitação do Target for executada.

Adobe Target encaminha automaticamente a carga do Analytics

Adobe Target pode encaminhar automaticamente a carga do analytics para Adobe Analytics se os seguintes identificadores forem fornecidos:

  1. supplementalDataId: a ID usada para compilar entre Adobe Analytics e Adobe Target. A fim de Adobe Target e Adobe Analytics para compilar os dados corretamente, o mesmo supplementalDataId precisa ser passado para ambos Adobe Target e Adobe Analytics.
  2. trackingServer: A variável 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);

O usuário recupera a carga de análise de Adobe Target

Um usuário pode recuperar a variável Adobe Analytics para uma determinada mbox, depois envie-a para Adobe Analytics por meio da API de inserção de dados. Quando um Adobe Target solicitação foi acionada, aprovado client_side para o logging na solicitação. Isso retornará uma carga se a mbox especificada estiver presente em uma atividade que usa o Analytics como fonte de relatórios.

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

Depois de especificar logging = client_side, você receberá a carga no campo mbox.

Se a resposta do Target contiver qualquer informação no analytics -> payload propriedade, encaminhe-a como está para Adobe Analytics. Adobe Analytics O sabe como processar essa carga. Isso pode ser feito em uma solicitação GET usando o seguinte formato:

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

Parâmetros e variáveis da string de consulta

Nome do campo
Obrigatório
Descrição
rsid
Sim
A ID do conjunto de relatórios
pe
Sim
Evento de página. Sempre definida como tnt
tnta
Sim
A carga do Analytics retornada pelo servidor do Target em analytics -> payload -> tnta
mid
Sim
ID de visitante da Marketing Cloud

Valores de cabeçalho obrigatórios

Nome do cabeçalho
Valor do cabeçalho
Host
Servidor de coleta de dados do Analytics (por exemplo: adobeags421.sc.omtrdc.net)

Exemplo de chamada Get HTTP da Inserção de dados 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