データストリームの作成と設定
このドキュメントでは、UI でデータストリームを設定する手順を説明します。
Datastreams ワークスペースへのアクセス
左側のナビゲーションで Datastreams を選択することで、データ収集 UI またはExperience Platform UI でデータストリームを作成および管理できます。
「Datastreams」タブには、わかりやすい名前、ID および最終更新日を含む、既存のデータストリームのリストが表示されます。 詳細の表示とサービスの設定 を行うには、データストリームの名前を選択します。
特定のデータストリームのその他のオプションを表示するには、「その他」アイコン(…)を選択します。 データストリームの 基本設定 を更新するには、「Edit」を選択します。 データストリームを削除するには、「Delete」を選択します。
データストリームの作成 create
データストリームを作成するには、最初に「New Datastream」を選択します。
設定手順から始まる、データストリーム作成ワークフローが表示されます。ここから、データストリームの名前およびオプションで説明を指定する必要があります。
Experience Platformで使用するデータストリームを設定し、さらに web SDKも使用する場合、取り込みを予定しているデータを表すために イベントベースのエクスペリエンスデータモデル(XDM)スキーマ を選択する必要があります。
ジオロケーションとネットワーク参照の設定 geolocation-network-lookup
ジオロケーションとネットワーク検索設定は、収集する地理的データとネットワークレベルのデータの精度レベルを定義するのに役立ちます。
「Geolocation and 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を入力します
City、Latitude、または Longitude を選択すると、他のオプションの選択に関係なく、小数点 2 点までの座標が得られます。 これは、都市レベルの精度と見なされます。
オプションを選択しないと、位置情報の検索が無効になります。 ジオロケーションは IP Obfuscation の前に発生します。つまり、IP Obfuscation 設定の影響を受けません。
訪問者の IP アドレスに基づいて、選択したオプションのネットワーク検索を有効にします。 次のオプションを使用できます。
- 携帯電話会社:
xdm.environment.carrierを入力します - Domain:
xdm.environment.domainを入力します - ISP:
xdm.environment.ISPを入力する - 接続タイプ:
xdm.environment.connectionTypeを入力します
上記のフィールドのいずれかをデータ収集に対して有効にする場合は、web SDKを設定する際に context 配列プロパティが正しく設定されていることを確認してください。
ジオロケーションルックアップフィールドでは context の配列文字列 "placeContext" を使用し、ネットワークルックアップフィールドでは context の配列文字列 "environment" を使用します。
また、目的の各 XDM フィールドがスキーマに存在することを確認します。 そうでない場合は、Adobeが提供する Environment Details フィールドグループをスキーマに追加できます。
デバイス検索の設定 geolocation-device-lookup
Device Lookup の設定を使用すると、収集するデバイス固有の情報を選択できます。
「Device Lookup」セクションを展開して、以下に説明する設定を指定します。
xdm.environment.browserDetails.userAgent を入力次のデバイス固有の情報を 1 つ以上収集する場合は、このオプションを選択します。
-
Device 情報:
- デバイス製造元:
xdm.device.manufacturerを入力します - デバイスモデル:
xdm.device.modelNumberを入力します - マーケティング名:
xdm.device.modelを入力します
- デバイス製造元:
-
Hardware 情報:
- ハードウェアタイプ:
xdm.device.typeを入力します - ディスプレイの高さ:
xdm.device.screenHeightを入力します - ディスプレイの幅:
xdm.device.screenWidthを入力します - 表示色の深度:
xdm.device.colorDepthを入力します
- ハードウェアタイプ:
-
Browser 情報:
- ブラウザーベンダー:
xdm.environment.browserDetails.vendorを入力します - ブラウザー名:
xdm.environment.browserDetails.nameを入力します - ブラウザーバージョン:
xdm.environment.browserDetails.versionを入力します
- ブラウザーベンダー:
-
Operating system 情報:
- OS ベンダー:
xdm.environment.operatingSystemVendorを入力します - OS 名:
xdm.environment.operatingSystemを入力します - OS バージョン:
xdm.environment.operatingSystemVersionを入力します
- OS ベンダー:
デバイス参照情報は、ユーザーエージェントおよびクライアントヒントと共に収集できません。 デバイス情報を収集するように選択すると、ユーザーエージェントとクライアントヒントの収集が無効になり、逆も同様です。
上記のフィールドのいずれかをデータ収集に対して有効にする場合は、web SDKを設定する際に context 配列プロパティが正しく設定されていることを確認してください。
デバイスとハードウェアの情報では context 配列の文字列 "device" が使用され、ブラウザーとオペレーティングシステムの情報では context 配列の文字列 "environment" が使用されます。
また、目的の各 XDM フィールドがスキーマに存在することを確認します。 そうでない場合は、Adobeが提供する Environment Details フィールドグループをスキーマに追加できます。
詳細オプションの設定 advanced-options
詳細設定オプションを表示するには、「Advanced Options」を選択します。 ここでは、IP の不明化、ファーストパーティ ID Cookie など、追加のデータストリーム設定を設定できます。
データストリームに適用される IP 不明化のタイプを示します。顧客 IP に基づく処理は、IP の不明化の設定の影響を受けます。 これには、データストリームからデータを受け取るすべてのExperience Cloud サービスが含まれます。 イベントがデータ準備などのダウンストリームサービスに送信される前に IP の不明化が発生します。
選択可能なオプションは次のとおりです。
-
None: IP の不明化を無効にします。 完全なユーザー IP アドレスは、データストリームを介して送信されます。
-
Partial: 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
- IPv4:
-
Full: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
- IPv4:
他のアドビ製品に対する IP の不明化の影響は次のとおりです。
- Adobe Target: データストリームレベルの IP obfuscation は、Adobe Targetで実行される IP obfuscation の前に、リクエストに存在するすべての IP アドレスに適用されます。 例えば、データストリームレベルの IP obfuscation オプションが Full に設定され、Adobe Targetの IP の不明化オプションが Last octet obfuscation に設定されている場合、Adobe Targetは完全に不明化された IP を受け取ります。 「datastream-level IP obfuscation」オプションが Partial に設定され、「Adobe Target IP の不明化」オプションが Full に設定されている場合、Adobe Targetは部分的に不明化された IP を受け取り、完全な不明化を適用します。 Adobe Targetの IP の不明化は、データストリームの IP の不明化とは独立して管理されます。 詳しくは、IP の不明化および位置情報に関する Adobe Target ドキュメントを参照してください。
- Audience Manager: データストリームレベルの IP obfuscation 設定は、Audience Managerで実行される IP obfuscation 前に、リクエストに存在するすべての IP アドレスに適用されます。 Audience Managerで行われたジオロケーション検索は、データストリームレベルの IP obfuscation オプションの影響を受けます。 完全に不明化された IP に基づくAudience Managerでのジオロケーションルックアップの結果、リージョンが不明になり、結果として得られたジオロケーションデータに基づくセグメントが実現されません。 詳しくは、IP の不明化に関する Audience Manager のドキュメントを参照してください。
- Adobe Analytics: データストリームレベルの IP の不明化の設定が Full に設定されている場合、Adobe Analyticsはその IP アドレスを空白として扱います。 これは、位置情報の検索や IP フィルタリングなど、IP アドレスに依存する Analytics の処理に影響します。 Analytics で、不明化されていない IP アドレスや部分的に不明化された IP アドレスを受信するには、IP の不明化設定を Partial または None に設定します。 IP アドレスが部分的に不明化された場合や不明化されていない場合は、Analytics 内でさらに不明化することができます。 Analytics で IP の不明化を有効にする方法について詳しくは、Adobe Analytics ドキュメント を参照してください。 IP アドレスが完全に不明化され、ページヒットに ECID も VisitorID もない場合、Analytics は、IP アドレスに部分的に基づく フォールバック ID を生成するのではなく、ヒットをドロップします。
- Adobe Advertising: データストリームレベルの IP の不明化が Partial または Full に設定されている場合、接続された TV 広告を除き、Advertising DSPの地理的レポートおよび機能(測定とリターゲティングを含む)は無効になります。
この設定を有効にする場合、ID を保存する Cookie の名前を指定する必要があります。
Edge Network がデータストリームに受け入れる認証タイプを定義します。
- Mixed Authentication:このオプションを選択すると、Edge Networkは認証済みリクエストと未認証リクエストの両方を受け入れます。 Edge Network API と共に Web SDKまたは モバイルSDK を使用する予定がある場合は、このオプションを選択します。
- Authenticated Only:このオプションを選択すると、Edge Networkは認証済みのリクエストのみを受け入れます。 Edge Network API のみを使用する予定で、未認証のリクエストがEdge Networkで処理されないようにする場合は、このオプションを選択します。
ここから、Experience Platformのデータストリームを設定している場合は、 データ収集のためのデータ準備 に関するチュートリアルに従って、Experience Platform イベントスキーマにデータをマッピングしてから、このガイドに戻ってください。 それ以外の場合は、「Save」を選択して、次の節を続行します。
データストリームの詳細の表示 view-details
新しいデータストリームを設定したり、表示するために既存のデータストリームを選択したりすると、そのデータストリームの詳細ページが表示されます。ここでは、データストリームの詳細情報(ID など)を確認できます。
データストリームの詳細画面から、サービスを追加して、アクセス権のある Adobe Experience Cloud 製品の機能を有効にできます。また、データストリームの基本設定を編集したり、そのマッピングルールを更新したり、データストリームをコピーしたり、完全に削除したりできます。
データストリームへのサービスの追加 add-services
データストリームの詳細ページで、「Add Service」を選択して、そのデータストリームで使用可能なサービスの追加を開始します。
次の画面で、ドロップダウンメニューを使用して、このデータストリームで設定するサービスを選択します。アクセス権のあるサービスのみが、このリストに表示されます。
目的のサービスを選択し、表示される設定オプションに入力してから、「Save」を選択してデータストリームにサービスを追加します。 データストリームの詳細表示に、追加されたすべてのサービスが表示されます。
次の項では、各サービスの設定オプションを説明します。
Adobe Advertising設定 advertising
このサービスは、Adobe AdvertisingとCustomer Journey Analyticsを統合するために必要です。
Adobe Analytics 設定 analytics
このサービスは、Adobe Analyticsにデータを送信するかどうかと、どのように送信するかを制御します。
visitorID として自動的に使用されます。詳しくは、Analytics 実装ガイドの Edge Networkを使用したAdobe Analyticsの実装 を参照してください。
Adobe Audience Manager 設定 audience-manager
このサービスは、Adobe Audience Manager にデータを送信するかどうかと、どのように送信するかを制御します。Audience Manager にデータを送信するために必要なのは、このセクションを有効にすることだけです。その他の設定は、オプションですが推奨されます。
Adobe Experience Platform 設定 aep
このサービスは、Adobe Experience Platform にデータを送信するかどうかと、どのように送信するかを制御します。
このオプションを Personalizationの宛先 と組み合わせて使用すると、 エッジの宛先 、Offer Decisioning、Adobe Target、Adobe Journey Optimizerなど、同じページおよび次のページのパーソナライゼーションのユースケースを実現できま 。
このオプションを有効にすると、データストリームはAdobe Journey Optimizerの web およびアプリベースのインバウンドキャンペーンからパーソナライズされたコンテンツを返すことができるようになります。
このオプションを使用するには、選択したデータセットで Experience Event - Proposition Interactions フィールドグループ を含むスキーマを使用する必要があります。 このフィールドグループは、Adobe Journey Optimizerのキャンペーンおよびエクスペリエンスに対するすべてのユーザーインタラクションを記録するために使用されます。
Adobe Target 設定 target
このサービスは、Adobe Target にデータを送信するかどうかと、どのように送信するかを制御します。
プロパティトークンは、Adobe Target UI の Setup/Properties にあります。
ベストプラクティスは、
dev、stage、prod の各データストリーム環境ごとに異なる設定を行って、物事をシンプルに保つことです。ただし、既に Adobe Target 環境を定義している場合は、それを使用できます。mbox3rdPartyId の ID 名前空間。Adobe Targetとの Customer Attributes 統合を使用する場合、または thirdPartyId を使用して Adobe Target プロファイル API を介してプロファイルを更新または作成する場合は、選択した名前空間値を指定する必要があります。 顧客属性ファイルのアップロードまたはプロファイル更新 API 呼び出しで使用される IdentityMap または customerID を送信するには、XDM スキーマの thirdPartyId セクションでこの名前空間を使用する必要があります。Event Forwarding 設定
このサービスは、イベント転送にデータを送信するかどうかと、どのように送信するかを制御します。
データストリームのコピー copy
既存のデータストリームのコピーを作成し、必要に応じて、その詳細を変更できます。
Datastreams ワークスペースのメインページから、省略記号(…を選択します)を選択してから、「Copy」を選択します。
または、指定されたデータストリームの詳細表示から Copy Datastream を選択することもできます。
作成する新しいデータストリームの一意の名前を指定するよう促す確認ダイアログが表示され、上書きされる設定オプションに関する詳細が表示されます。準備ができたら、「Copy」を選択します。
Datastreams ワークスペースのメインページが再表示され、新しいデータストリームがリスト表示されます。
次の手順
このガイドでは、データ収集 UI でのデータストリームの管理方法について説明しました。データストリーム設定後の Web SDKのインストールおよび設定方法について詳しくは、Web SDK タグ拡張機能の概要 を参照してください。