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

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

Datastreams ワークスペースへのアクセス

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

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

Datastreams」タブには、既存のデータストリームのリストが表示され、そのリストには、わかりやすい名前、ID、最終変更日が含まれます。 詳細を表示してサービスを設定するには、データストリームの名前を選択します。

特定のデータストリームのオプションをさらに表示するには、「詳細」アイコン()を選択します。 データストリームの基本設定を更新するには、Edit​を選択します。 データストリームを削除するには、Delete​を選択します。

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

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

データストリームを作成するには、まず​ New Datastream ​を選択します。

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

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

Experience Platformで使用するデータストリームを設定し、Web SDKも使用する場合は、取り込む予定のデータを表す​ イベントベースのExperience Data Model (XDM) スキーマ ​も選択する必要があります。

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

位置情報とネットワーク検索の設定 geolocation-network-lookup

位置情報とネットワーク検索設定は、収集する地理的およびネットワークレベルのデータの詳細レベルを定義するのに役立ちます。

Geolocation and network lookup」セクションを展開して、以下に説明する設定を構成します。

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

設定
説明
Geo 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に入力します

CityLatitude、または​ Longitude ​を選択すると、他のオプションの選択に関係なく、座標は最大2つの小数点で指定されます。 これは市区町村レベルの精度と見なされます。

いずれかのオプションを選択しないと、位置情報の検索が無効になります。 位置情報はIP Obfuscationより前に行われます。つまり、IP Obfuscation設定の影響を受けません。

Network Lookup

訪問者の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​設定を使用して、収集するデバイス固有の情報を選択します。

Device Lookup」セクションを展開して、以下に説明する設定を構成します。

デバイス検索設定がハイライト表示された データストリーム設定画面。

IMPORTANT
以下の表に示す設定は、相互に排他的です。 ユーザーエージェント情報​ デバイス検索データの両方を同時に選択することはできません。
設定
説明
Keep user agent and client hints headers
ユーザーエージェント文字列に格納されている情報のみを収集する場合は、このオプションを選択します。 この設定はデフォルトで選択されています。 xdm.environment.browserDetails.userAgentを自動入力
Use device lookup to collect the following information

次の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を入力します

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

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

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

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

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

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

詳細設定オプションを表示するには、Advanced Options​を選択します。 ここでは、IPの難読化、ファーストパーティ ID Cookieなどの追加のデータストリーム設定を行うことができます。

詳細設定オプション

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

データストリームに適用される 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
  • 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

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

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

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

注: データストリームは、デフォルトのAudience Manager コンテナ IDを参照しています。これは0です。 複数のAudience Manager ID同期コンテナ IDがある場合は、Audience Manager コンサルタントと協力して、ID同期設定を適切に識別して解決します。
Container ID Overrides
この節では、デフォルトのIDを上書きするために使用できる、追加のサードパーティ ID同期コンテナ IDを定義できます。
Access Type

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

  • Mixed Authentication:このオプションを選択すると、Edge Networkは認証済みリクエストと未認証リクエストの両方を受け入れます。 Web SDKまたは​ モバイル SDKEdge Network APIを使用する場合は、このオプションを選択します。
  • Authenticated Only:このオプションを選択すると、Edge Networkは認証済みリクエストのみを受け入れます。 Edge Network APIのみを使用し、未認証のリクエストがEdge Networkで処理されないようにする場合は、このオプションを選択します。
Media Analytics
Experience Platform SDKまたはMedia Edge APIを介したEdge Network統合用のストリーミングトラッキングデータの処理を有効にします。 ​ ドキュメント ​でMedia Analyticsについて説明します。

ここから、Experience Platformのデータストリームを設定する場合は、このガイドに戻る前に、Data Prep for Data Collectionのチュートリアルに従って、データをExperience Platform イベントスキーマにマッピングしてください。 それ以外は、Save​を選択して次のセクションに進みます。

NOTE
データストリーム設定に変更を保存した後、変更内容をEdge Network全体に反映するには、最大35分かかります。 この伝搬ウィンドウ中でも、リクエストは以前の設定で提供される場合があります。

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

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

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

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

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

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

続行するには、「サービスを追加」を選択します。

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

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

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

サービスがデータストリームに追加されました。

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

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

Adobe Advertisingの設定 advertising

このサービスは、Adobe AdvertisingとCustomer Journey Analyticsの統合に必要です。

Adobe Analytics 設定 analytics

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

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

設定
説明
Report Suite ID
(必須)​データの送信先の Analytics レポートスイートの ID。このIDは、Adobe Analytics UIのAdmin > ReportSuitesにあります。 複数のレポートスイートが指定された場合、データは各レポートスイートにコピーされます。
Visitor ID namespace
(オプション)Adobe Analytics visitorIDに使用する名前空間。 この名前空間に指定された値を持つイベントを送信すると、AnalyticsでvisitorIDとして自動的に使用されます。
フィールドが入力されると、データストリームはvisitorID値をAdobe Analyticsに送信します。 訪問者IDがidentityMapに含まれているかどうかに関係なく、ECIDは引き続き生成され、送信リクエストに含まれます。 Analyticsでは、複数のIDを含めることができます。 IDは、このページに記載されている順序で評価されます。Adobe Analyticsのオペレーションの識別順序
Report Suite Overrides
このセクションでは、デフォルトのレポートスイート ID を上書きするために使用できるレポートスイート ID を追加できます。

詳しくは、Analytics実装ガイドの「Edge Networkを使用したAdobe Analyticsの実装」を参照してください。

Adobe Audience Manager 設定 audience-manager

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

Adobe Audience Manager データストリームの設定。

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

Adobe Experience Platform 設定 aep

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

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

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

設定
説明
Event Dataset
(必須)​顧客イベントデータのストリーミング先となるExperience Platform データセットを選択します。 このスキーマは、XDM ExperienceEvent クラスを使用する必要があります。データセットを追加するには、Add Event Dataset​を選択します。
Profile Dataset
同意プッシュトークンユーザーアクティビティ領域​のお客様属性の送信に使用するExperience Platform データセットを選択します。 このスキーマは、XDM Individual Profile クラスを使用する必要があります。
Offer Decisioning
Web SDK実装のOffer Decisioningを有効にします。
Edge Segmentation
このデータストリームの​ エッジセグメント化を有効にします。 Web SDKまたはEdge Network APIがエッジセグメント化が有効になっているデータストリームを介してデータを送信すると、該当するプロファイルの更新されたオーディエンスメンバーシップが応答で返されます。

このオプションを​ Personalization Destinations ​と組み合わせて、edge destinationsOffer DecisioningAdobe TargetまたはAdobe Journey Optimizerを通じて、同ページと次ページのパーソナライゼーションのユースケースに使用できます
Personalization Destinations
このデータストリームに対して​ カスタム Personalizationを有効にします。 Web SDKまたはEdge Network APIがパーソナライゼーションの宛先を有効にしたデータストリームを介してデータを送信すると、対象のプロファイルに対するオーディエンスメンバーシップとマッピングされたプロファイル属性(認証済みEdge Network API リクエストのみ)が応答で返されます。
Adobe Journey Optimizer
このデータストリームに対してAdobe Journey Optimizerを有効にします。

このオプションを有効にすると、データストリームは、Adobe Journey Optimizerでwebおよびアプリベースのインバウンドキャンペーンからパーソナライズされたコンテンツを返すことができます。

このオプションでは、選択したデータセットが​Experience Event - Proposition Interactions ​ フィールドグループ ​を含むスキーマを使用する必要があります。 このフィールドグループは、Adobe Journey Optimizerのキャンペーンとエクスペリエンスに対するすべてのユーザーインタラクションを記録するために使用されます。

Adobe Target 設定 target

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

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

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

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

ベストプラクティスは、devstageprod の各データストリーム環境ごとに異なる設定を行って、物事をシンプルに保つことです。ただし、既に Adobe Target 環境を定義している場合は、それを使用できます。
Target Third Party ID namespace
このデータストリームに使用する mbox3rdPartyId の ID 名前空間。Customer AttributesとAdobe Targetの統合を使用するか、thirdPartyIdを使用してAdobe Target Profiles APIを介してプロファイルを更新または作成する場合は、任意の名前空間値を指定する必要があります。 顧客属性ファイルのアップロードまたはプロファイル更新API呼び出しで使用されるIdentityMapまたはcustomerIDを送信するには、XDM スキーマのthirdPartyId セクションでこの名前空間を使用する必要があります。
Property Token Overrides
この節では、デフォルトのプロパティトークンを上書きするために使用できる追加のプロパティトークンを定義できます。

Event Forwarding設定

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

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

設定
説明
Launch Property
(必須)​データの送信先のイベント転送プロパティ。
Launch Environment
(必須)​データの送信先の選択されたプロパティ内の環境。
NOTE
ドロップダウンメニューを使用する代わりに、プロパティ名と環境名を入力するには、Manually enter IDs​を選択します。

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

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

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

Datastreams ワークスペースのメインページから、省略記号(…を選択します)を選択してから、Copy​を選択します。

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

または、特定のデータストリームの詳細ビューから​ Copy Datastream ​を選択することもできます。

データストリームの詳細ビューからコピーオプションを選択しています。

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

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

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

次の手順

このガイドでは、データ収集 UI でのデータストリームの管理方法について説明しました。データストリームを設定した後にWeb SDKをインストールして設定する方法について詳しくは、Web SDK タグ拡張機能の概要を参照してください。

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