Adobe Experience PlatformWeb SDK拡張機能

AEP Web SDK Extensionは、WebプロパティからAdobe Experience Platformエッジネットワーク経由でAdobe Experience Cloudにデータを送信します。 Adobe Experience PlatformのWeb SDK拡張機能を使用すると、プラットフォームへのデータのストリーミング、IDの同期、オプトイン、およびコンテキストデータの自動収集が可能です。

AEP Web SDK拡張の設定

この節では、Adobe Experience PlatformWeb SDK Extensionの設定時に使用できるオプションについて説明します。

Adobe Experience PlatformWeb SDK拡張機能がまだインストールされていない場合は、プロパティを開き、Extensions > Catalog​を選択し、Adobe Experience PlatformWeb SDK拡張機能の上にカーソルを置いて、Install​を選択します。

拡張機能を設定するには、「Extensions」タブを開き、拡張機能の上にマウスポインターを置いて、「Configure」を選択します。

インスタンス名

AEP Web SDK Extensionは、ページ上の複数のインスタンスをサポートします。 これは、1 つの Adobe Experience Platform Launch 設定で複数の組織にデータを送信するために使用します。Name のデフォルトは「alloy」です。ただし、インスタンス名は任意の有効な JavaScript オブジェクト名に変更できます。Adobe Experience Platform 拡張機能では、各インスタンスに異なる「Config ID」と「Organization ID」が必要です。

Config ID

Config ID」は、データのルーティング先と、サーバー上で使用する設定を Adobe Experience Platform に指示します。これは、Adobe Experience Platform 拡張機能が動作するために必要です。設定 ID は、ClientCare に問い合わせて取得できます。

Organization ID

Organization ID」は、アドビでデータの送信先となる組織です。ほとんどの場合は、自動入力されるデフォルト値を使用する必要があります。ページに複数のインスタンスが存在する場合は、データの送信先となる 2 つ目の組織の値をここに入力します。

Edge Domain

Edge Domain」は、Adobe Experience Platform 拡張機能がデータの送受信をおこなうドメインです。拡張機能では、実稼動用トラフィックにファーストパーティの CNAME を使用する必要があります。デフォルトのサードパーティドメインは開発環境で使用できますが、実稼動環境には適していません。ファーストパーティ CNAME の設定方法については、ここで説明します。

Enable Errors

デフォルトでは、拡張機能でエラーが発生した場合、エラーはコンソールに記録されます。実稼動環境でエラーを非表示にする場合は、「Enable Errors」チェックボックスをオフにできます。Platform Launch でデバッグが有効になっている場合は、引き続きエラーが表示されます。

Enable Opt-in

Enable Opt-in​が有効な場合、AEP Web SDK拡張は、オプトインが受信されるまでヒットを保持できます。 オプトインの環境設定をおこなうためのアクションが拡張機能に表示されます。

Enable Migrate ECID

AEP Web SDK拡張は、新しいCookieを使用してECIDを保存します。 この設定により、移行目的で、新しい cookie と古い cookie の互換性が有効になります。ECID を持つ既存の訪問者がいない場合を除き、この機能を有効にすることを強くお勧めします。

Use 3rd Party Cookies

Adobe Experience Platform は、常にファーストパーティドメインに cookie を保存します。このオプションを使用すると、ファーストパーティドメインの cookie に加えて、demdex.net に設定されたサードパーティ cookie を使用できます。これは、複数のドメイン間を移動するユーザーがいる場合に役立ちます。これにより、demdex.net への呼び出しが無効になります。

Context

拡張機能は、リクエストのコンテキストに関する情報(URL やブラウザーについての詳細など)を自動的に収集します。これは、特定のコンテキストを選択解除することで無効にできます。

  • web:Web ページに関する詳細(URL、リファラーなど)
  • device:デバイスに関する詳細(画面の向き、画面の高さ、画面の幅など)
  • environment:コンピューティング環境(ブラウザー、接続など)に関する情報
  • location:ユーザーの場所に関する限定的な情報

アクションタイプ

イベントの送信

Adobe Experience Platform にイベントを送信し、送信したデータを Adobe Experience Platform が収集してその情報に基づいて動作できるようにします。インスタンスを選択する必要があります(複数ある場合)。ページの読み込みの開始時または単一ページアプリケーションでのビューの変更時にイベントが発生した場合は、「Occurs at the start of a view」を選択します。

XDM Data」フィールドには、送信する任意のデータを送信できます。XDM スキーマの構造に準拠する JSON オブジェクトを指定する必要があります。このオブジェクトは、ページ上または「Custom Code」「Data Element」を通じて作成できます。

同意の設定

ユーザーの同意を得たら、AEP Web SDKに通知する必要があります。 これを行うには、「同意を設定」アクションタイプを使用します。 現在、次の2種類の標準がサポートされています。"Adobe"と"IAB TCF." Adobe標準を使用する場合、現在、同意を「In」、「Out」と設定するか、データ要素を使用して指定できます。 IAB TCF標準を使用する場合は、使用するバージョンと値、およびGDPRに関する追加情報を提供します。

このアクションでは、IDマップを含めるオプションのフィールドも提供されます。これにより、IDは、同意を受けた後に同期することで同期できます。 同意呼び出しが最初に呼び出される可能性があるので、同意が「保留」に設定されている場合に便利です。

イベント結合IDのリセット

ページ上のイベント結合IDをリセットする場合は、この操作を行います。 IDをリセットするには、リセットする結合IDを選択し、必要に応じてアクションを実行します。

データ要素の種類

イベント結合ID

このデータ要素を使用すると、イベントマージIDが提供されます。 このデータ要素には設定は必要ありません。 指定されたデータ要素は、訪問者がページを離れるか、「イベント結合IDをリセット」アクションタイプが使用されるまで、同じままです。

ID マップ

IDマップデータ要素を使用すると、他のデータ要素や指定した他の値からIDを作成できます。 作成するすべてのIDは、対応する名前空間に結び付ける必要があります。 このデータ要素には、すべてのデフォルト名前空間と作成済みのすべての要素を示すドロップダウンが表示されます。

XDMオブジェクト

Adobe Experience PlatformWeb SDKに送信するデータは、すべてXDM形式にする必要があります。 XDMオブジェクトデータ要素を使用すると、データの形式設定が簡単になります。 このデータ要素を最初に開いたときは、正しいAdobe Experience Platformサンドボックスとスキーマを選択してください。 スキーマを選択すると、スキーマの構造が表示され、簡単に入力できます。

web.webPageDetails.URLなど、スキーマの特定のフィールドを開くと、一部の項目が自動的に収集されます。 複数の項目が自動的に収集される場合でも、必要に応じて、項目を上書きするオプションがあります。 すべての値は、手動で入力するか、他のデータ要素を使用して入力できます。

メモ

収集したい情報を入力するだけで済みます。 データがソリューションに送信される際に、入力されないデータはすべて省略されます。

このページ