データストリームの作成と設定
このドキュメントでは、UI でデータストリームを設定する手順を説明します。
データストリームワークスペースへのアクセス
左側のナビゲーションで データストリーム を選択することで、データ収集 UI または Experience Platform UI でデータストリームを作成および管理できます。
「データストリーム」タブには、わかりやすい名前、ID および最終更新日を含む、既存のデータストリームのリストが表示されます。終了 詳細の表示とサービスの設定を選択し、データストリームの名前を選択します。
特定のデータストリームのその他のオプションを表示するには、「その他」アイコン(…)に設定します。 を更新するには 基本設定 データストリームとして、を選択します。 編集. データストリームを削除するには、以下を選択します。 削除.
データストリームの作成 create
データストリームを作成するには、最初に「新規データストリーム」を選択します。
設定手順から始まる、データストリーム作成ワークフローが表示されます。ここから、データストリームの名前およびオプションで説明を指定する必要があります。
Experience Platformで使用するデータストリームを設定し、さらに Web SDK を使用する場合、 イベントベースのエクスペリエンスデータモデル(XDM)スキーマ 取り込む予定のデータを表す。
ジオロケーションとネットワーク参照の設定 geolocation-network-lookup
ジオロケーションとネットワーク検索設定は、収集する地理的データとネットワークレベルのデータの精度レベルを定義するのに役立ちます。
を展開します。 ジオロケーションとネットワーク参照 セクション:以下に説明する設定を指定します。
訪問者の IP アドレスに基づいて、選択したオプションの位置情報の検索を有効にします。 次のオプションを使用できます。
- 国:値を入力します
xdm.placeContext.geo.countryCode
- 郵便番号:値を入力します
xdm.placeContext.geo.postalCode
- 都道府県:値を入力します
xdm.placeContext.geo.stateProvince
- DMA:値を入力します
xdm.placeContext.geo.dmaID
- 市区町村:値を入力します
xdm.placeContext.geo.city
- 緯度:値を入力します
xdm.placeContext.geo._schema.latitude
- 経度:値を入力します
xdm.placeContext.geo._schema.longitude
市区町村、緯度 または 経度 を選択すると、他にどのようなオプションが選択されているかに関係なく、小数第 2 位までの座標が表示されます。これは、都市レベルの精度と見なされます。
どのオプションも選択しないと、位置情報の検索が無効になります。 位置情報は次の前に発生 IP の不明化。これは、の影響を受けません IP の不明化 の設定値。
訪問者の IP アドレスに基づいて、選択したオプションのネットワーク検索を有効にします。 次のオプションを使用できます。
- 通信事業者:値を入力します
xdm.environment.carrier
- ドメイン:値を入力します
xdm.environment.domain
- ISP:値を入力します
xdm.environment.ISP
上記のフィールドのいずれかをデータ収集に対して有効にする場合は、正しく設定していることを確認してください context
web SDK の設定時の配列プロパティ。
ジオロケーション参照フィールドでは、 context
配列文字列 "placeContext"
を選択します。ネットワーク検索フィールドでは、 context
配列文字列 "environment"
.
また、目的の各 XDM フィールドがスキーマに存在することを確認します。 追加されていない場合は、Adobe提供のを追加できます Environment Details
フィールドグループをスキーマに追加します。
デバイス検索の設定 geolocation-device-lookup
この デバイス検索 設定を使用すると、収集するデバイス固有の情報を選択できます。
を展開します。 デバイス検索 セクション:以下に説明する設定を指定します。
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
- OS ベンダー:値を入力します
デバイス参照情報は、ユーザーエージェントおよびクライアントヒントと共に収集できません。 デバイス情報を収集するように選択すると、ユーザーエージェントとクライアントヒントの収集が無効になり、逆も同様です。
上記のフィールドのいずれかをデータ収集に対して有効にする場合は、正しく設定していることを確認してください context
web SDK の設定時の配列プロパティ。
デバイスとハードウェアの情報では、 context
配列文字列 "device"
ブラウザーおよびオペレーティングシステムの情報では context
配列文字列 "environment"
.
また、目的の各 XDM フィールドがスキーマに存在することを確認します。 追加されていない場合は、Adobe提供のを追加できます Environment Details
フィールドグループをスキーマに追加します。
詳細オプションの設定 @advanced-options
詳細設定オプションを表示するには、次を選択します: 詳細オプション. ここでは、IP の不明化、ファーストパーティ ID Cookie など、追加のデータストリーム設定を設定できます。
データストリームに適用される 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
- IPv4:
-
完全: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 の不明化 次の前に適用: IP の不明化 Adobe Targetで、リクエストに存在するすべての 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 の不明化 設定は、次の前に適用されます IP の不明化 リクエストに存在するすべての IP アドレスに対してAudience Managerで実行されます。 Audience Manager で実行される位置情報検索は、データストリームレベルの IP 不明化オプションの影響を受けます。完全に不明化された IP に基づくAudience Managerでのジオロケーション検索は、結果が不明なリージョンになり、結果として得られたジオロケーションデータに基づくセグメントが実現されません。 詳しくは、IP の不明化に関する Audience Manager のドキュメントを参照してください。
- Adobe Analytics:データストリームレベルの IP の不明化設定がに設定されている場合 フル の場合、Adobe Analyticsはこの IP アドレスを空白として扱います。 これは、位置情報の検索や IP フィルタリングなど、IP アドレスに依存する Analytics の処理に影響します。 Analytics で、不明化されていない IP アドレスや部分的に不明化された IP アドレスを受信するには、IP 不明化設定をに設定します。 一部 または なし. IP アドレスが部分的に不明化された場合や不明化されていない場合は、Analytics 内でさらに不明化することができます。 Adobe Analyticsを参照 詳細を見る analytics で IP の不明化を有効にする方法について詳しくは、こちらを参照してください。 IP アドレスが完全に不明化され、ページヒットにものがない場合 ECID また、 VisitorIDその後、Analytics は、 フォールバック ID(一部は IP アドレスに基づいています)。
この設定を有効にする場合、ID を保存する Cookie の名前を指定する必要があります。
Edge Network がデータストリームに受け入れる認証タイプを定義します。
- 混合認証:このオプションを選択すると、Edge Network は認証済みリクエストと未認証リクエストの両方を受け入れます。Server API と一緒に Web SDK または Mobile SDK を使用する場合は、このオプションを選択してください。
- 認証済みのみ:このオプションを選択すると、Edge Network は認証済みのリクエストのみを受け入れます。Server API のみを使用する予定で、未認証のリクエストが Edge Network で処理されないようにする場合は、このオプションを選択します。
ここから、Experience Platform のデータストリームを設定している場合は、データ収集のためのデータ準備に関するチュートリアルに従って、Platform イベントスキーマにデータをマッピングしてから、このガイドに戻ってください。それ以外の場合は、「保存」を選択して、次の節を続行します。
データストリームの詳細の表示 view-details
新しいデータストリームを設定したり、表示するために既存のデータストリームを選択したりすると、そのデータストリームの詳細ページが表示されます。ここでは、データストリームの詳細情報(ID など)を確認できます。
データストリームの詳細画面から、サービスを追加して、アクセス権のある Adobe Experience Cloud 製品の機能を有効にできます。また、データストリームの基本設定を編集したり、そのマッピングルールを更新したり、データストリームをコピーしたり、完全に削除したりできます。
データストリームへのサービスの追加 add-services
データストリームの詳細ページで、「サービスを追加」を選択して、そのデータストリームで使用可能なサービスの追加を開始します。
次の画面で、ドロップダウンメニューを使用して、このデータストリームで設定するサービスを選択します。アクセス権のあるサービスのみが、このリストに表示されます。
目的のサービスを選択し、表示される設定オプションに入力してから、「保存」を選択してデータストリームにサービスを追加します。データストリームの詳細表示に、追加されたすべてのサービスが表示されます。
次の項では、各サービスの設定オプションを説明します。
Adobe Analytics 設定 analytics
このサービスは、Adobe Analytics にデータを送信するかどうかと、どのように送信するかを制御します。参照: Adobe Analyticsへのデータの送信.
visitorID
Analytics の場合。Adobe Audience Manager 設定 audience-manager
このサービスは、Adobe Audience Manager にデータを送信するかどうかと、どのように送信するかを制御します。Audience Manager にデータを送信するために必要なのは、このセクションを有効にすることだけです。その他の設定は、オプションですが推奨されます。
Adobe Experience Platform 設定 aep
![選択されたサンドボックス](./media_1a6e74dd68d6a80a88d93e009ba7d677ed8abd660.png?width=750&format=png&optimize=medium)
このサービスは、Adobe Experience Platform にデータを送信するかどうかと、どのように送信するかを制御します。
Offer Decisioning 機能について詳しくは、Adobe Journey Optimizer のドキュメントを参照してください。
このオプションは、と組み合わせて使用できます パーソナライゼーションの宛先 を介した同じページおよび次のページのパーソナライゼーションのユースケース エッジの宛先 または Offer Decisioning.
パーソナライゼーションの宛先の設定に関する特定の手順については、宛先のドキュメントを参照してください。
このオプションを有効にすると、データストリームは Adobe Journey Optimizer の web およびアプリベースのインバウンドキャンペーンからパーソナライズされたコンテンツを返すことができるようになります。このオプションを使用するには、エッジセグメント化をアクティブにする必要があります。次の場合 エッジのセグメント化 をオフにすると、このオプションはグレー表示されます。
Adobe Target 設定 target
このサービスは、Adobe Target にデータを送信するかどうかと、どのように送信するかを制御します。
プロパティトークンは、Adobe Target UI の設定/プロパティにあります。
ベストプラクティスは、
dev
、stage
、prod
の各データストリーム環境ごとに異なる設定を行って、物事をシンプルに保つことです。ただし、既に Adobe Target 環境を定義している場合は、それを使用できます。mbox3rdPartyId
の ID 名前空間。詳しくは、Web SDK を使用した mbox3rdPartyId
の実装に関するガイドを参照してください。イベント転送設定
このサービスは、イベント転送にデータを送信するかどうかと、どのように送信するかを制御します。
データストリームのコピー copy
既存のデータストリームのコピーを作成し、必要に応じて、その詳細を変更できます。
データストリームワークスペースのメインページから、当該データストリームの省略記号(…)を選択してから、「コピー」を選択します。
または、指定されたデータストリームの詳細表示から「データストリームをコピー」を選択することもできます。
作成する新しいデータストリームの一意の名前を指定するよう促す確認ダイアログが表示され、上書きされる設定オプションに関する詳細が表示されます。準備ができたら、「コピー」を選択します。
データストリームワークスペースのメインページが再表示され、新しいデータストリームがリスト表示されます。
次の手順
このガイドでは、データ収集 UI でのデータストリームの管理方法について説明しました。データストリーム設定後の Web SDK のインストールおよび設定方法について詳しくは、データ収集 E2E ガイドを参照してください。