データストリームの作成と設定
このガイドでは、UIで データストリーム を設定する手順について説明します。
データストリーム ワークスペースへのアクセス workspace
左側のナビゲーションで「データストリーム」を選択すると、データ収集UIまたはAdobe Experience Platform UIでデータストリームを作成および管理できます。
データ収集UIの「
「データストリーム」タブには、既存のデータストリームのリスト(わかりやすい名前、ID、最終変更日など)が表示されます。 詳細を表示してサービスを設定するには、データストリームの名前を選択します。
特定のデータストリームの詳細なオプションを表示するには、その他のアイコン (…)を選択します。 データストリームの基本設定を更新するには、編集を選択します。 データストリームを削除するには、削除を選択します。
データストリームの作成 create
データストリームを作成するには、まず 新しいデータストリーム を選択します。
設定手順から始まる、データストリーム作成ワークフローが表示されます。 ここから、データストリームの名前およびオプションで説明を指定する必要があります。
Experience Platformで使用するデータストリームを設定し、Web SDKも使用する場合は、マッピングスキーマも選択する必要があります。 イベントベースのExperience Data Model (XDM) スキーマ を使用して、取り込む予定のデータを表します。
位置情報とネットワーク検索の設定 geolocation-network-lookup
位置情報とネットワーク検索設定は、収集する地理的およびネットワークレベルのデータの詳細レベルを定義するのに役立ちます。
「位置情報とネットワーク検索」セクションを展開して、以下に説明する設定を構成します。
位置情報とネットワーク検索設定がハイライト表示された
訪問者のIP アドレスに基づいて、選択したオプションの位置情報の検索を有効にします。 使用可能なオプションは次のとおりです。
- 国:入力:
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難読化の前に発生します。つまり、IP難読化設定の影響を受けません。
訪問者のIP アドレスに基づいて、選択したオプションのネットワーク検索を有効にします。 使用可能なオプションは次のとおりです。
- 携帯電話会社:
xdm.environment.carrierに入力します - ドメイン:
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設定を使用して、収集するデバイス固有の情報を選択します。
「デバイス検索」セクションを展開して、以下に説明する設定を構成します。
デバイス検索設定がハイライト表示された
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 ベンダー:
デバイスのルックアップ情報は、ユーザーエージェントおよびクライアントヒントと共に収集できません。 デバイス情報の収集を選択すると、ユーザーエージェントとクライアントヒントの収集が無効になり、その逆も無効になります。
データ収集でこれらのフィールドのいずれかを有効にする場合は、Web SDKの設定時にcontext配列プロパティを正しく設定してください。
デバイス情報とハードウェア情報ではcontext配列文字列"device"を使用し、ブラウザー情報とオペレーティングシステム情報ではcontext配列文字列"environment"を使用します。
また、各XDM フィールドがスキーマに存在することを確認します。 そうでない場合は、Adobeが提供するEnvironment Details フィールドグループをスキーマに追加できます。
詳細オプションの設定 advanced-options
詳細設定オプションにアクセスするには、詳細オプションを選択します。 ここでは、IPの難読化、ファーストパーティ ID Cookieなどの追加のデータストリーム設定を行うことができます。
データストリームに適用される IP 不明化のタイプを示します。 顧客IPに基づく処理は、IP難読化設定の影響を受けます。 これには、データストリームからデータを受け取るすべてのExperience Cloud サービスが含まれます。 IPの難読化は、イベントがデータ準備などの任意のダウンストリームサービスに送信される前に行われます。
選択可能なオプションは次のとおりです。
-
なし: 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:
-
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難読化は、Adobe Targetで実行されたIP難読化の前に、リクエストに存在するすべてのIP アドレスに適用されます。 例えば、データストリームレベルのIP難読化 オプションが Full に設定され、Adobe Target IP難読化オプションが 最終オクテット難読化 に設定されている場合、Adobe Targetは完全に難読化されたIPを受け取ります。 データストリームレベルのIP難読化 オプションが 部分 に設定され、Adobe Target IP難読化オプションが 完全 に設定されている場合、Adobe Targetは部分的に難読化されたIPを受け取り、完全な難読化を適用します。 Adobe Target IPの難読化は、データストリームとは独立して管理されます。 詳しくは、IP の不明化および位置情報に関する Adobe Target ドキュメントを参照してください。
- Audience Manager: データストリームレベル IP難読化設定は、Audience Managerで実行されたIP難読化の前に、リクエストに存在するすべてのIP アドレスに適用されます。 Audience Managerによる位置情報の検索は、データストリームレベルのIP難読化 オプションの影響を受けます。 Audience Managerで位置情報の検索を行うと、難読化されたIPに基づいて不明な領域が生成され、結果として得られる位置情報データに基づくセグメントは認識されません。 詳しくは、IP の不明化に関する Audience Manager のドキュメントを参照してください。
- Adobe Analytics: データストリームレベルのIP難読化設定が Full に設定されている場合、Adobe AnalyticsはIP アドレスを空白として扱います。 これは、位置情報の検索やIP フィルタリングなど、IP アドレスに依存するAnalytics処理に影響します。 Analyticsが難読化されていないIP アドレスまたは部分的に難読化されたIP アドレスを受信するには、IP難読化設定を 部分 または なし に設定します。 部分的に不明化されたIP アドレスと不明化されていないIP アドレスは、Analytics内でさらに不明化できます。 AnalyticsでIP難読化を有効にする方法について詳しくは、Adobe Analytics ドキュメント を参照してください。 IP アドレスが完全に難読化され、ページヒットにECIDもVisitorIDも含まれていない場合、Analyticsは、IP アドレスに部分的に基づく フォールバック IDを生成するのではなく、ヒットをドロップします。
- Adobe Advertising: データストリームレベルのIP難読化が部分または完全に設定されている場合、コネクテッド TV広告を除き、Advertising DSPでは地理的レポートと機能(測定とリマーケティングを含む)が無効になります。
この設定を有効にする場合は、IDを保存するCookieの名前を指定する必要があります。
注: データストリームは、デフォルトのAudience Manager コンテナ IDを参照しています。これは0です。 複数のAudience Manager ID同期コンテナ IDがある場合は、Audience Manager コンサルタントと協力して、ID同期設定を適切に識別して解決します。
Edge Network がデータストリームに受け入れる認証タイプを定義します。
- Mixed Authentication:このオプションを選択すると、Edge Networkは認証済みリクエストと未認証リクエストの両方を受け入れます。 Web SDKまたは モバイル SDKとEdge Network APIを使用する場合は、このオプションを選択します。
- 認証済みのみ:このオプションを選択すると、Edge Networkは認証済みリクエストのみを受け付けます。 Edge Network APIのみを使用し、未認証のリクエストがEdge Networkで処理されないようにする場合は、このオプションを選択します。
ここから、Experience Platformのデータストリームを設定する場合は、このガイドに戻る前に、Data Prep for Data Collectionのチュートリアルに従って、データをExperience Platform イベントスキーマにマッピングしてください。 それ以外は、保存を選択して、次のセクションに進みます。
データストリームの詳細の表示 view-details
新しいデータストリームを設定したり、表示するために既存のデータストリームを選択したりすると、そのデータストリームの詳細ページが表示されます。 ここでは、データストリームの詳細情報(ID など)を確認できます。
データストリームの詳細画面から、サービスを追加して、アクセス権のある Adobe Experience Cloud 製品の機能を有効にできます。 また、データストリームの基本設定を編集したり、そのマッピングルールを更新したり、データストリームをコピーしたり、完全に削除したりできます。
データストリームへのサービスの追加 add-services
データストリームの詳細ページで、「サービスを追加」を選択して、そのデータストリームに使用可能なサービスの追加を開始します。
次の画面で、ドロップダウンメニューを使用して、このデータストリームで設定するサービスを選択します。 アクセス権のあるサービスのみが、このリストに表示されます。
目的のサービスを選択し、表示される設定オプションを入力し、保存を選択してデータストリームにサービスを追加します。 データストリームの詳細表示に、追加されたすべてのサービスが表示されます。
次の項では、各サービスの設定オプションを説明します。
Adobe Advertisingの設定 advertising
このサービスは、Adobe AdvertisingとCustomer Journey Analyticsの統合に必要です。
Adobe Analytics 設定 analytics
このサービスを使用して、Adobe Analyticsにデータを送信します。
visitorIDとして自動的に使用されます。フィールドが入力されると、データストリームは
visitorID値をAdobe Analyticsに送信します。 訪問者IDがidentityMapに含まれているかどうかに関係なく、ECIDは引き続き生成され、送信リクエストに含まれます。 Analyticsは、複数のIDを含めることをサポートしています。 IDは、このページに記載されている順序で評価されます。Adobe Analyticsのオペレーションの識別順序。詳しくは、Analytics実装ガイドの「Edge Networkを使用したAdobe Analyticsの実装」を参照してください。
Adobe Audience Manager 設定 audience-manager
このサービスを有効にして、Adobe Audience Managerにデータを送信します。 その他の設定は、オプションですが推奨されます。
Adobe Experience Platform 設定 aep
このサービスを使用して、Adobe Experience Platformにデータを送信します。
このオプションを Personalization Destinations と組み合わせて、edge destinations、Adobe Target、Adobe Journey Optimizerを通じて、同ページと次ページのパーソナライズのユースケースを行うことができます。
このオプションを有効にすると、データストリームはAdobe Journey Optimizerのwebおよびアプリベースのインバウンドキャンペーンからパーソナライズされたコンテンツを返すことができます。
このオプションを有効にするには、選択したデータセットでエクスペリエンスイベント – 提案インタラクション フィールドグループ を含むスキーマを使用する必要があります。 このフィールドグループは、Adobe Journey Optimizer件のキャンペーンとエクスペリエンスに関するすべてのユーザーインタラクションを記録するために使用されます。
Adobe Target 設定 target
このサービスを使用して、Adobe Targetにデータを送信します。
プロパティトークンは、Adobe Target UIの設定 > プロパティ にあります。
ベストプラクティスは、設定エラーを回避するために、
dev、stage、prodの各データストリーム環境に対して異なる設定をすることです。 ただし、既にAdobe Target環境が定義されている場合は、それらを使用できます。mbox3rdPartyId の ID 名前空間。 Customer AttributesとAdobe Targetの統合を使用するか、thirdPartyIdを使用してAdobe Target Profiles APIを介してプロファイルを更新または作成する場合は、任意の名前空間値を指定する必要があります。 顧客属性ファイルのアップロードまたはプロファイル更新API呼び出しで使用されるcustomerIDまたはthirdPartyIdを送信するには、XDM スキーマのIdentityMap セクションでこの名前空間を使用する必要があります。 イベント転送設定 event-forwarding
このサービスを使用して、 イベント転送にデータを送信します。
データストリーム設定画面の
データストリームのコピー copy
既存のデータストリームのコピーを作成し、必要に応じて、その詳細を変更できます。
データストリーム ワークスペースのメインページから、省略記号(…)を選択します 対象のデータストリームの場合は、コピーを選択します。
または、特定のデータストリームの詳細ビューから「データストリームをコピー」を選択することもできます。
作成する新しいデータストリームの一意の名前を指定するよう促す確認ダイアログが表示され、上書きされる設定オプションに関する詳細が表示されます。 準備ができたら、コピーを選択します。
データストリーム ワークスペースのメインページが再び表示され、新しいデータストリームが一覧表示されます。
次の手順 next-steps
このガイドでは、データ収集 UI でのデータストリームの管理方法について説明しました。 データストリームを設定した後にWeb SDKをインストールおよび設定する方法について詳しくは、 タグ拡張機能の概要を参照してください。 Web SDK