ドキュメントTarget デベロッパーガイド

Analytics for Target（A4T）レポート

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

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

  • Adobe Target が analytics ペイロードを自動的に Adobe Analytics に転送する
  • ユーザーは、Adobe Target から Analytics ペイロードをリクエストします。 （Adobe Target は Adobe Analytics ペイロードを呼び出し元に返します。）
NOTE
オンデバイス判定では、Adobe Target が分析ペイロードを Adobe Analytics に自動的に転送する A4T レポートのみをサポートしています。 Adobe Target からの分析ペイロードの取得はサポートされていません。

前提条件

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

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

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

  1. supplementalDataId:Adobe Analytics と Adobe Target の間でつなぐために使用する ID。 Adobe Target と Adobe Analytics がデータを正しくステッチするには、Adobe Target と Adobe Analytics の両方に同じ supplementalDataId を渡す必要があります。
  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 ペイロードを取得し、Data Insertion API を介して Adobe Analytics に送信できます。 Adobe Target リクエストが発生したら、client_side をリクエストの logging フィールドに渡します。 これにより、Analytics をレポートソースとして使用するアクティビティに指定された mbox が存在する場合、ペイロードが返されます。

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
○
analytics -> payload -> tnta で Target サーバーから返された Analytics ペイロード
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