データストリームの作成と設定

このドキュメントでは、UI でデータストリームを設定する手順を説明します。

データストリームワークスペースへのアクセス

左側のナビゲーションで​ データストリーム ​を選択することで、データ収集 UI または Experience Platform UI でデータストリームを作成および管理できます。

データ収集 UI の「データストリーム」タブ

データストリーム」タブには、わかりやすい名前、ID および最終更新日を含む、既存のデータストリームのリストが表示されます。 詳細の表示とサービスの設定を行うには、データストリームの名前を選択します。

特定のデータストリームのその他のオプションを表示するには、「その他」アイコン()を選択します。 データストリームの 基本設定を更新するには、「編集」を選択します。 データストリームを削除するには、「削除」を選択します。

既存のデータストリームを編集または削除するためのオプション

データストリームの作成 create

データストリームを作成するには、最初に「新規データストリーム」を選択します。

新しいデータストリームを選択

設定手順から始まる、データストリーム作成ワークフローが表示されます。ここから、データストリームの名前およびオプションで説明を指定する必要があります。

Experience Platformで使用するデータストリームを設定し、さらに Web SDK を使用する場合、取り込みを予定しているデータを表すために 🔗 イベントベースのエクスペリエンスデータモデル(XDM)スキーマも選択する必要があります。

データストリームの基本設定

ジオロケーションとネットワーク参照の設定 geolocation-network-lookup

ジオロケーションとネットワーク検索設定は、収集する地理的データとネットワークレベルのデータの精度レベルを定義するのに役立ちます。

ジオロケーションとネットワークルックアップ」セクションを展開して、以下に説明する設定を指定します。

位置情報とネットワーク参照設定がハイライト表示されたデータストリーム設定画面

設定
説明
位置情報の検索

訪問者の IP アドレスに基づいて、選択したオプションの位置情報の検索を有効にします。 次のオプションを使用できます。

  • Country:xdm.placeContext.geo.countryCode を入力します
  • 郵便番号:xdm.placeContext.geo.postalCode を入力します
  • 都道府県:xdm.placeContext.geo.stateProvince を入力します
  • DMA:xdm.placeContext.geo.dmaID を入力します
  • City:xdm.placeContext.geo.city を入力します
  • Latitude: xdm.placeContext.geo._schema.latitude を入力します
  • 経度:xdm.placeContext.geo._schema.longitude を入力します

市区町村緯度 ​または​ 経度 ​を選択すると、他にどのようなオプションが選択されているかに関係なく、小数第 2 位までの座標が表示されます。これは、都市レベルの精度と見なされます。

オプションを選択しないと、位置情報の検索が無効になります。 ジオロケーションは IP の不明化 ​ の前に発生します。つまり、IP の不明化 ​ 設定の影響を受けません。

ネットワークの検索

訪問者の IP アドレスに基づいて、選択したオプションのネットワーク検索を有効にします。 次のオプションを使用できます。

  • Carrier:xdm.environment.carrier を入力します
  • Domain:xdm.environment.domain を入力します
  • ISP:xdm.environment.ISP を入力する

上記のフィールドのいずれかをデータ収集に対して有効にする場合は、Web SDK を設定する際に context 配列プロパティを正しく設定していることを確認してください。

ジオロケーションルックアップフィールドでは context の配列文字列 "placeContext" を使用し、ネットワークルックアップフィールドでは context の配列文字列 "environment" を使用します。

また、目的の各 XDM フィールドがスキーマに存在することを確認します。 追加されていない場合は、Adobeが提供する Environment Details フィールドグループをスキーマに追加できます。

デバイス検索の設定 geolocation-device-lookup

デバイス検索 設定では、収集するデバイス固有の情報を選択できます。

デバイス検索」セクションを展開して、以下に説明する設定を指定します。

デバイス参照設定が強調表示されたデータストリーム設定画面

IMPORTANT
次の表に示す設定は、相互に排他的です。 ユーザーエージェント情報 の両方のデバイス参照データを同時に選択することはできません。
設定
説明
ユーザーエージェントヘッダーとクライアントヒントヘッダーを保持
ユーザーエージェント文字列に格納された情報のみを収集する場合は、このオプションを選択します。 この設定は、デフォルトで選択されています。 xdm.environment.browserDetails.userAgent を入力
デバイス検索を使用して、次の情報を収集します

次のデバイス固有の情報を 1 つ以上収集する場合は、このオプションを選択します。

  • デバイス 情報:

    • デバイス製造元:xdm.device.manufacturer を入力します
    • デバイスモデル:xdm.device.modelNumber を入力します
    • マーケティング名:xdm.device.model を入力します
  • ハードウェア 情報:

    • ハードウェアタイプ:xdm.device.type を入力します
    • ディスプレイの高さ:xdm.device.screenHeight を入力します
    • ディスプレイの幅:xdm.device.screenWidth を入力します
    • 表示色の深度:xdm.device.colorDepth を入力します
  • ブラウザー 情報:

    • ブラウザーベンダー:xdm.environment.browserDetails.vendor を入力します
    • ブラウザー名:xdm.environment.browserDetails.name を入力します
    • ブラウザーバージョン:xdm.environment.browserDetails.version を入力します
  • オペレーティング システム 情報:

    • OS ベンダー:xdm.environment.operatingSystemVendor を入力します
    • OS 名:xdm.environment.operatingSystem を入力します
    • OS バージョン:xdm.environment.operatingSystemVersion を入力します

デバイス参照情報は、ユーザーエージェントおよびクライアントヒントと共に収集できません。 デバイス情報を収集するように選択すると、ユーザーエージェントとクライアントヒントの収集が無効になり、逆も同様です。

デバイス情報を収集しない
デバイスのルックアップ情報を収集しない場合は、このオプションを選択します。 デバイス、ハードウェア、ブラウザー、オペレーティングシステム、ユーザーエージェント、クライアントヒントのデータは収集されません。

上記のフィールドのいずれかをデータ収集に対して有効にする場合は、Web SDK を設定する際に context 配列プロパティを正しく設定していることを確認してください。

デバイスとハードウェアの情報では context 配列の文字列 "device" が使用され、ブラウザーとオペレーティングシステムの情報では context 配列の文字列 "environment" が使用されます。

また、目的の各 XDM フィールドがスキーマに存在することを確認します。 追加されていない場合は、Adobeが提供する Environment Details フィールドグループをスキーマに追加できます。

の詳細オプション 設定 @advanced-options

詳細設定オプションを表示するには、「詳細設定オプション」を選択します。 ここでは、IP の不明化、ファーストパーティ ID Cookie など、追加のデータストリーム設定を設定できます。

詳細設定オプション

IMPORTANT
お客様は、正確な位置情報を含む個人データの収集、処理、送信に関して、適用される法律および規制に基づいて必要なすべての必要な権限、同意、許可および承認を確実に取得する責任を負います。
IP アドレスの不明化の選択は、IP アドレスから派生して設定済みのAdobeソリューションに送信される位置情報のレベルには影響しません。 位置情報の参照は、個別に制限するか無効にする必要があります。
設定
説明
IP の不明化

データストリームに適用される IP 不明化のタイプを示します。顧客 IP に基づく処理は、IP の不明化の設定の影響を受けます。 これには、データストリームからデータを受信するすべての Experience Cloud サービスが含まれます。

選択可能なオプションは次のとおりです。

  • なし:IP の不明化を無効にします。完全なユーザー IP アドレスは、データストリームを介して送信されます。

  • 部分的:IPv4 アドレスの場合、ユーザー IP アドレスの最後のオクテットを不明化します。IPv6 アドレスの場合、アドレスの最後の 80 ビットを不明化します。

    例:

    • IPv4:1.2.3.4 -> 1.2.3.0
    • IPv6:2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 2001:0db8:1345:0000:0000:0000:0000:0000
  • 完全:IP アドレス全体を不明化します。

    例:

    • IPv4:1.2.3.4 -> 0.0.0.0
    • IPv6:2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 0:0:0:0:0:0:0:0

他のアドビ製品に対する IP の不明化の影響は次のとおりです。

  • Adobe Target: Adobe Targetで IP の不明化 ​ が実行される前に、データストリームレベルの IP の不明化 ​ がリクエストに存在するすべての IP アドレスに適用されます。 例えば、データストリームレベルの IP の不明化 ​ オプションが フル に設定され、Adobe Targetの IP の不明化オプションが 最後のオクテットの不明化 に設定されている場合、Adobe Targetは、完全に不明化された IP を受け取ります。 データストリームレベルの IP の不明化 ​ オプションが 部分的 に設定され、Adobe Targetの IP の不明化オプションが 完全 に設定されている場合、Adobe Targetは部分的に不明化された IP を受け取り、完全な不明化を適用します。 Adobe Targetの IP の不明化は、データストリームの IP の不明化とは独立して管理されます。 詳しくは、IP の不明化および位置情報に関する Adobe Target ドキュメントを参照してください。
  • Audience Manager: データストリームレベルの IP の不明化 ​ 設定は、Audience Managerで実行される IP の不明化 ​ の前に、リクエストに存在するすべての IP アドレスに適用されます。 Audience Manager で実行される位置情報検索は、データストリームレベルの IP 不明化オプションの影響を受けます。完全に不明化された IP に基づくAudience Managerでのジオロケーション検索は、結果が不明なリージョンになり、結果として得られたジオロケーションデータに基づくセグメントが実現されません。 詳しくは、IP の不明化に関する Audience Manager のドキュメントを参照してください。
  • Adobe Analytics: データストリームレベルの IP の不明化の設定が フル に設定されている場合、Adobe Analyticsは IP アドレスを空白として扱います。 これは、位置情報の検索や IP フィルタリングなど、IP アドレスに依存する Analytics の処理に影響します。 Analytics で、不明化されていない IP アドレスや部分的に不明化された IP アドレスを受信するには、IP の不明化設定を 部分的 または なし に設定します。 IP アドレスが部分的に不明化された場合や不明化されていない場合は、Analytics 内でさらに不明化することができます。 Analytics で IP の不明化を有効にする方法について詳しくは、Adobe Analytics ドキュメントを参照してください。 IP アドレスが完全に不明化され、ページヒットに ECID も VisitorID もない場合、Analytics は、IP アドレスに部分的に基づく フォールバック ID を生成するのではなく、ヒットをドロップします。
ファーストパーティ ID Cookie
この設定を有効にすると、Edge Network はファーストパーティデバイス ID を参照する際に、この値を ID Map で参照するのではなく、指定された Cookie を参照するように指示します。

この設定を有効にする場合、ID を保存する Cookie の名前を指定する必要があります。
サードパーティ ID 同期
ID 同期は、コンテナにグループ化して、異なる ID 同期を異なる時間に実行できます。この設定を有効にすると、どの ID 同期のコンテナがこのデータストリームに対して実行されるかを指定できます。
サードパーティ ID 同期のコンテナ ID
サードパーティ ID 同期に使用されるコンテナの数値 ID。
コンテナ ID の上書き
このセクションでは、追加のサードパーティ ID 同期コンテナ ID を定義し、これを使用してデフォルトの ID を上書きできます。
アクセスタイプ

Edge Network がデータストリームに受け入れる認証タイプを定義します。

  • 混合認証:このオプションを選択すると、Edge Network は認証済みリクエストと未認証リクエストの両方を受け入れます。Server API と一緒に Web SDK または Mobile SDK を使用する場合は、このオプションを選択してください。
  • 認証済みのみ:このオプションを選択すると、Edge Network は認証済みのリクエストのみを受け入れます。Server API のみを使用する予定で、未認証のリクエストが Edge Network で処理されないようにする場合は、このオプションを選択します。
Media Analytics
Experience PlatformSDK または Media Edge API を介したEdge Network統合用のストリーミングトラッキングデータの処理を有効にします。 ドキュメントから Media Analytics について説明します。

ここから、Experience Platform のデータストリームを設定している場合は、データ収集のためのデータ準備に関するチュートリアルに従って、Platform イベントスキーマにデータをマッピングしてから、このガイドに戻ってください。それ以外の場合は、「保存」を選択して、次の節を続行します。

データストリームの詳細の表示 view-details

新しいデータストリームを設定したり、表示するために既存のデータストリームを選択したりすると、そのデータストリームの詳細ページが表示されます。ここでは、データストリームの詳細情報(ID など)を確認できます。

データストリームの詳細ページ。

データストリームの詳細画面から、サービスを追加して、アクセス権のある Adobe Experience Cloud 製品の機能を有効にできます。また、データストリームの基本設定を編集したり、そのマッピングルールを更新したり、データストリームをコピーしたり、完全に削除したりできます。

データストリームへのサービスの追加 add-services

データストリームの詳細ページで、「サービスを追加」を選択して、そのデータストリームで使用可能なサービスの追加を開始します。

「サービスを追加」を選択して続行

次の画面で、ドロップダウンメニューを使用して、このデータストリームで設定するサービスを選択します。アクセス権のあるサービスのみが、このリストに表示されます。

リストからサービスを選択します。

目的のサービスを選択し、表示される設定オプションに入力してから、「保存」を選択してデータストリームにサービスを追加します。データストリームの詳細表示に、追加されたすべてのサービスが表示されます。

データストリームに追加されたサービス

次の項では、各サービスの設定オプションを説明します。

NOTE
各サービス設定には、サービスが選択されると自動的にアクティブ化される「有効」トグルが含まれます。このデータストリーム用に選択されたサービスを無効にするには、もう一度「有効」トグルを選択します。

Adobe Analytics 設定 analytics

このサービスは、Adobe Analytics にデータを送信するかどうかと、どのように送信するかを制御します。Adobe Analyticsへのデータの送信を参照してください。

Adobe Analytics データストリーム設定。

設定
説明
レポートスイート ID
(必須) ​データの送信先の Analytics レポートスイートの ID。この ID は、Adobe Analytics UI の管理者/レポートスイートにあります。複数のレポートスイートが指定された場合、データは各レポートスイートにコピーされます。
​ 訪問者 ID 名前空間 ​
(任意)Adobe Analytics visitorID に使用する名前空間。 この名前空間に指定された値でイベントを送信すると、Analytics で visitorID として自動的に使用されます。
レポートスイートの上書き
このセクションでは、デフォルトのレポートスイート ID を上書きするために使用できるレポートスイート ID を追加できます。

Adobe Audience Manager 設定 audience-manager

このサービスは、Adobe Audience Manager にデータを送信するかどうかと、どのように送信するかを制御します。Audience Manager にデータを送信するために必要なのは、このセクションを有効にすることだけです。その他の設定は、オプションですが推奨されます。

Adobeオーディエンス管理データストリーム設定。

設定
説明
Cookie 宛先が有効
SDK で、Audience Manager から Cookie 宛先経由でセグメント情報を共有できるようにします。
URL 宛先が有効
SDK で、Audience Manager から URL 宛先経由でセグメント情報を共有できるようにします。

Adobe Experience Platform 設定 aep

IMPORTANT
Platform のデータストリームを有効にする場合、UI の上部リボンに表示されている、現在使用中の Platform サンドボックスに注意してください。
選択されたサンドボックス
サンドボックスは、Adobe Experience Platform の仮想パーティションで、組織内の他のユーザーからデータおよび実装を分離できます。一旦データストリームが作成されると、そのサンドボックスは変更できません。Experience Platform のサンドボックスの役割について詳しくは、サンドボックスのドキュメントを参照してください。

このサービスは、Adobe Experience Platform にデータを送信するかどうかと、どのように送信するかを制御します。

Adobe Experience Platform データストリーム設定。

設定
説明
イベントデータセット
(必須) ​顧客イベントデータのストリーミング先となる Platform データセットを選択します。このスキーマは、XDM ExperienceEvent クラスを使用する必要があります。データセットを追加するには、イベントデータセットを追加 ​を選択します。
プロファイルデータセット
顧客属性データの送信先となる Platform データセットを選択します。このスキーマは、XDM Individual Profile クラスを使用する必要があります。
Offer Decisioning
Web SDK 実装のOffer decisioningを有効にします。 実装について詳しくは、Web SDK でのOffer decisioningの使用に関するガイドを参照してください。

Offer Decisioning 機能について詳しくは、Adobe Journey Optimizer のドキュメントを参照してください。
エッジのセグメント化
このデータストリームに対して エッジのセグメント化を有効にします。 Web SDK または Edge Networkサーバー API がエッジセグメント化を有効にしたデータストリームでデータを送信すると、該当するプロファイルの更新されたオーディエンスメンバーシップが応答で返されます。

このオプションを Personalizationの宛先 と組み合わせて使用すると、 エッジ宛先または Offer Decisioning を介した同じページおよび次のページのパーソナライゼーションのユースケースを実現できます。
パーソナライゼーションの宛先
「エッジセグメント化」チェックボックスを有効にした後でこの項目を有効にすると、カスタムパーソナライゼーションなどのパーソナライゼーションの宛先にデータストリームが接続できるようになります。

パーソナライゼーションの宛先の設定に関する特定の手順については、宛先のドキュメントを参照してください。
Adobe Journey Optimizer
このデータストリームに対して 🔗0}Adobe Journey Optimizer} を有効にします。

このオプションを有効にすると、データストリームは Adobe Journey Optimizer の web およびアプリベースのインバウンドキャンペーンからパーソナライズされたコンテンツを返すことができるようになります。このオプションを使用するには、エッジセグメント化をアクティブにする必要があります。Edge セグメント化 ​ がオフの場合、このオプションはグレー表示されます。

Adobe Target 設定 target

このサービスは、Adobe Target にデータを送信するかどうかと、どのように送信するかを制御します。

Adobe Target データストリーム設定。

設定
説明
プロパティトークン
Target を使用すると、お客様はプロパティを使用して権限を制御できます。 プロパティについて詳しくは、Target ドキュメントのエンタープライズ権限の設定に関するガイドを参照してください。

プロパティトークンは、Adobe Target UI の設定/プロパティにあります。
Target 環境 ID
Adobe Target の環境を使用すると、開発のすべてのステージを通じて実装を管理できます。この設定は、このデータストリームで使用しようとしている環境を指定します。

ベストプラクティスは、devstageprod の各データストリーム環境ごとに異なる設定を行って、物事をシンプルに保つことです。ただし、既に Adobe Target 環境を定義している場合は、それを使用できます。
Target サードパーティ ID 名前空間
このデータストリームに使用する mbox3rdPartyId の ID 名前空間。詳しくは、Web SDK を使用した mbox3rdPartyId の実装に関するガイドを参照してください。
プロパティトークンの上書き
このセクションでは、デフォルトのプロパティトークンを上書きするために使用できる、追加のプロパティトークンを定義できます。

イベント転送設定

このサービスは、イベント転送にデータを送信するかどうかと、どのように送信するかを制御します。

データストリーム設定画面の「イベント転送」セクション。

設定
説明
Launch プロパティ
(必須) ​データの送信先のイベント転送プロパティ。
Launch 環境
(必須) ​データの送信先の選択されたプロパティ内の環境。
NOTE
手動で ID を入力」を選択すると、ドロップダウンメニューを使用せずに、プロパティ名および環境名を入力できます。

データストリームのコピー copy

既存のデータストリームのコピーを作成し、必要に応じて、その詳細を変更できます。

NOTE
データストリームは、同じサンドボックス内でのみコピーできます。つまり、あるサンドボックスから別のサンドボックスにデータストリームをコピーすることはできません。

データストリームワークスペースのメインページから、当該データストリームの省略記号()を選択してから、「コピー」を選択します。

データストリームリスト表示から「コピー」オプションが選択されていることを示す画像

または、指定されたデータストリームの詳細表示から「データストリームをコピー」を選択することもできます。

データストリームの詳細表示から「コピー」オプションが選択されている。

作成する新しいデータストリームの一意の名前を指定するよう促す確認ダイアログが表示され、上書きされる設定オプションに関する詳細が表示されます。準備ができたら、「コピー」を選択します。

データストリームのコピーに関する確認ダイアログ。

データストリームワークスペースのメインページが再表示され、新しいデータストリームがリスト表示されます。

次の手順

このガイドでは、データ収集 UI でのデータストリームの管理方法について説明しました。データストリーム設定後の Web SDK のインストールおよび設定方法について詳しくは、データ収集 E2E ガイドを参照してください。

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac