DocumentaçãoTargetGuia do desenvolvedor do Target

Relatórios do Analytics for Target (A4T)

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor

O Adobe Target oferece suporte aos relatórios do A4T para atividades de decisão no dispositivo e 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 de análise para Adobe Analytics ou
  • O usuário solicita a carga de análise de Adobe Target. (Adobe Target retorna a carga Adobe Analytics para o chamador.)
NOTE
A decisão no dispositivo só oferece suporte aos relatórios do A4T, dos quais o Adobe Target encaminha automaticamente a carga de análise para Adobe Analytics. Não há suporte para a recuperação da carga de análise de Adobe Target.

Pré-requisitos

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

Adobe Target encaminha automaticamente a carga Analytics

Adobe Target pode encaminhar automaticamente a carga de análise para Adobe Analytics se os seguintes identificadores forem fornecidos:

  1. supplementalDataId: A ID usada para compilar entre Adobe Analytics e Adobe Target. Para que Adobe Target e Adobe Analytics compilem os dados corretamente, o mesmo supplementalDataId precisa ser passado para Adobe Target e Adobe Analytics.
  2. trackingServer: O Servidor 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);

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

Um usuário pode recuperar a carga Adobe Analytics de determinada mbox e enviá-la para Adobe Analytics por meio da API de Inserção de Dados. Quando uma solicitação Adobe Target for acionada, passe client_side para o campo logging na solicitação. Esta solicitação retorna uma carga se a mbox especificada estiver presente em uma atividade que usa Analytics como a 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 de Target contiver qualquer item na propriedade analytics -> payload, encaminhe-a como está para Adobe Analytics. Adobe Analytics sabe como processar esta carga. Isso pode ser feito em uma solicitação GET usando o seguinte 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 e variáveis da sequência de consulta

Nome do campo
Obrigatório
Descrição
rsid
Sim
A ID do conjunto de relatórios
content_type_num
Sim
Sempre definir como "0"
code_ver
Sim
Sempre definida como "MOBILE-1.0"
session
Sim
Sempre definir como "0"
pe
Sim
Evento de página. Sempre definida como tnt
tnta
Sim
Analytics carga retornada pelo servidor Target em analytics -> payload -> tnta
sessionId
Sim
Target ID da sessão em andamento
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 (ex.: adobeags421.sc.omtrdc.net)

Exemplo de inserção de dados do A4T com chamada HTTP Get

Versão não codificada em URL para legibilidade (o formato não deve ser usado para chamadas de 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

Versão codificada por URL (formato a ser usado para chamadas de 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