설명서Target 개발자 안내서

A4T (Analytics for Target) 보고

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

작성 대상:

  • Developer

Adobe Target 는 온디바이스 의사 결정 및 서버측 Target 활동 모두에 대한 A4T 보고를 지원합니다. A4T 보고를 활성화하는 두 가지 구성 옵션이 있습니다.

  • Adobe Target analytics 페이로드를 로 자동 전달 Adobe Analytics, 또는
  • 사용자가 Analytics 페이로드를 요청한 위치 Adobe Target. (Adobe Target 반환: Adobe Analytics 페이로드를 호출자에게 되돌립니다.)
NOTE
온디바이스 의사 결정은 다음에 대한 A4T 보고만 지원합니다. Adobe Target analytics 페이로드를 로 자동 전달 Adobe Analytics. 에서 분석 페이로드 검색 Adobe Target 은(는) 지원되지 않습니다.

전제 조건

  1. 에서 활동 구성 Adobe Target 이 있는 UI Adobe Analytics 를 보고 소스로 사용하고 계정이 A4T에 대해 활성화되었는지 확인합니다.
  2. API 사용자는 Adobe Marketing Cloud 방문자 ID를 생성하고, Target 요청이 실행될 때 이 ID를 사용할 수 있도록 합니다.

Adobe Target analytics 페이로드를 자동으로 전달합니다

Adobe Target analytics 페이로드를 다음 위치에 자동으로 전달 Adobe Analytics 다음 식별자가 제공되는 경우:

  1. supplementalDataId: 결합 시 사용되는 ID입니다 Adobe Analytics 및 Adobe Target. 주문 Adobe Target 및 Adobe Analytics 를 사용하여 데이터를 정확하게 결합하려면 supplementalDataId 은(는) 두 모두에 전달되어야 합니다. Adobe Target 및 Adobe Analytics.
  2. trackingServer: 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);

사용자가 다음 위치에서 분석 페이로드를 검색합니다. Adobe Target

사용자는 Adobe Analytics 주어진 mbox에 대한 페이로드를 보낸 다음 로 보냅니다. Adobe Analytics 를 통해 데이터 삽입 API. 다음의 경우 Adobe Target 요청이 실행됨, 전달 client_side (으)로 logging 요청의 필드. 지정된 mbox가 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: "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);

을(를) 지정한 후 logging = client_side, mbox 필드에 페이로드를 받습니다.

Target의 응답에 analytics -> payload 속성, 그대로 전달 Adobe Analytics. Adobe Analytics 은 이 페이로드를 처리하는 방법을 설명합니다. 이 작업은 다음 형식을 사용하여 GET 요청에서 수행할 수 있습니다.

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

쿼리 문자열 매개 변수 및 변수

필드 이름
필수
설명
rsid
예
보고서 세트 ID
pe
예
페이지 이벤트. 항상 로 설정 tnt
tnta
예
의 Target 서버에서 Analytics 페이로드가 반환됨 analytics -> payload -> tnta
mid
예
Marketing Cloud 방문자 ID

필수 헤더 값

헤더 이름
헤더 값
호스트
Analytics 데이터 수집 서버(예: adobeags421.sc.omtrdc.net)

샘플 A4T 데이터 삽입 HTTP Get 호출

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