Analytics for Target (A4T) レポート

Adobe Targetは、オンデバイス決定とサーバーサイド Targetの両方のアクティビティに対するA4T レポートをサポートしています。 A4T レポートを有効にするには、次の2つの設定オプションがあります。

  • Adobe Targetは、分析ペイロードを自動的にAdobe Analyticsに転送します。または
  • ユーザーはAdobe Targetから分析ペイロードを要求しています。 (Adobe TargetはAdobe Analytics ペイロードを呼び出し元に返します。)
NOTE
オンデバイス判定では、A4T レポートのみがサポートされ、そのうちAdobe Targetは分析ペイロードをAdobe Analyticsに自動的に転送します。 Adobe Targetからの分析ペイロードの取得はサポートされていません。

前提条件

  1. Adobe AnalyticsをレポートソースとしてAdobe Target UIのアクティビティを設定し、アカウントがA4Tに対して有効になっていることを確認します。
  2. API ユーザーはAdobe Marketing Cloud Visitor IDを生成し、Target リクエストの実行時にこのIDが使用可能であることを確認します。

Adobe TargetはAnalytics ペイロードを自動的に転送します

次の識別子が指定されている場合、Adobe Targetは分析ペイロードをAdobe Analyticsに自動的に転送できます。

  1. supplementalDataId: Adobe AnalyticsとAdobe Targetの間をつなぎ合わせるために使用されるID。 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から分析ペイロードを取得します

ユーザーは、特定のmboxのAdobe Analytics ペイロードを取得し、​ データ挿入APIを介してAdobe Analyticsに送信できます。 Adobe Target リクエストが実行されたら、リクエストのclient_sidelogging フィールドに渡します。 指定された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}/{content_type_num}/{code_ver}/{session}?pe=tnt&tnta={payload}&c.&a.&target.&sessionId={sessionId}&.target&.a&.c&mid={mid}

クエリー文字列パラメーターと変数

フィールド名
必須
説明
rsid
レポートスイート ID
content_type_num
常に「0」に設定
code_ver
常に「MOBILE-1.0」に設定
session
常に「0」に設定
pe
ページイベント: 常にtntに設定
tnta
Analytics ペイロードがanalytics -> payload -> tntaのTarget サーバーによって返されました
sessionId
進行中セッションのTarget セッション ID
mid
Marketing Cloud 訪問者 ID

必須ヘッダー値

ヘッダー名
ヘッダー値
ホスト
Analytics データ収集サーバー(例:adobeags421.sc.omtrdc.net

A4T データ挿入のサンプル HTTP Get呼び出し

読みやすさのURL エンコードされていないバージョン (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

URL エンコードされたバージョン(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
target-dev-help-dev