よくある質問

Last update: Fri Apr 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

このガイドでは、Adobe Experience Platform Web SDK に関するよくある質問に対する回答を示します。

Adobe Experience Platform Web SDK とは

Adobe Experience Platform Web SDK は、Adobe Experience Cloudの様々なサービスとのやり取りを可能にするクライアントサイド JavaScript ライブラリです。

Web SDK は、ソリューションに依存しない方法（XDM）でデータをExperience PlatformEdge Networkに送信し、その後、データをソリューション固有の形式と宛先にマッピングしてリアルタイムで送信します。

Web SDK について詳しくは、次のビデオを参照してください。 Alloy.js に対応し、eVarや Mbox のタグを二度と付けない.

Adobe Experience Platform Web SDK の以前のソリューションとの相違点

Web SDKExperience Platform以前

現在、個々のソリューションに基づいて異なる JavaScript ライブラリをデプロイする必要があります。

各ソリューションには、独自の JavaScript ライブラリ、スキーマ、ドメインがあります。
これらのライブラリは、互いに動作するように構築されたものではありません。
クロスソリューションとAdobe Experience Platformのユースケースでは、これらの異なるライブラリが相互に依存する必要があるので、デプロイメントに問題が生じます。

Platform のタグを使用すると、これらのライブラリをできるだけ簡単にデプロイおよび管理できますが、次の点に問題があります。

ライブラリサイズ（ページ上のAdobeコードが多すぎる）
パフォーマンス（サイトの読み込みに時間がかかる）
1 つのユースケースに対する複数の呼び出し
パーソナライゼーションの呼び出し前に ECID の返しを待つ（遅延の原因）
フラクチャされたデータ収集（evar とは）
ソリューション間のスキーマの混乱（A4T）
その他の非最適なものの多く

また、現在、Adobe Experience Platformに直接データを送信する JavaScript ライブラリはありません。

Experience PlatformWeb SDK を使用

新しい Web SDK は、次のソリューションのデータを 1 つの宛先（Experience PlatformEdge Network）に送信し、前述のソリューションの最も一般的なユースケースに対応します。

Adobe Analytics
Adobe Audience Manager
Adobe Target
訪問者 ID
Adobe Experience Platform

その他のソリューションも同様です。

Adobe Experience Platform Web SDK は、Adobe Experience Platformに直接データを送信することもできます。このデータは XDM 形式で、サーバー側のソリューションスキーマにマッピングされます。

この新しい Web SDK の価値は何ですか。

パフォーマンス： Web SDK は、現在のすべてのAdobeライブラリを使用するよりも小さく、ページの読み込みを大幅に高速化します。

シンプルさ： XDM、Web SDK、タグ、Edge Network、Adobe Experience Cloud ソリューションおよびAdobe Experience Platformの組み合わせは、理解しやすく、シンプルなデータ収集ストーリーを作成します。

XDM: データをAdobeに送信するために使用する、ソリューションに依存しないスキーマ。 eVar または mbox 用のタグ付けはこれ以上ありません。
Web SDK: Adobe Experience Platform Edge Networkとのデータの送受信を容易にします。
タグ : サイトでの Web SDK （およびその他の JavaScript タグ）のデプロイメントと設定を簡素化します。
Edge Network: データを必要な形式でAdobe Experience Platformおよびソリューションに簡単にルーティングします。
Adobe Experience PlatformおよびAdobeソリューション： 価値提案を有効にします。

制御： すべてのデータは、接続された単一のデータストリームを使用しているので、アプリケーションとの間で、ジャーニーのミリ秒ごとにデータがどのように表示されるかを論理的に追跡および制御できます。

現代的で未来に備えたデザイン： Web SDK とそのEdge Networkへの接続により、Adobeでは、データ収集、パーソナライゼーション、同意、サードパーティ cookie の将来に関するAdobeの取り扱いを大幅に最新化できるようになりました。（Adobeが管理するファーストパーティドメインが有効になります）。

価値創出までの時間： Adobeは、タグを使用して Web SDK を可能な限り簡単にデプロイし、クライアントサイドのデータを XDM にマッピングできるように、鋭意取り組んできました（今後も継続する）。その作業が完了したら、他のすべてのAdobeソリューションとAdobe Experience Platform サービスを、サーバーサイドでオンまたはオフにできます。例えば、Adobe Analyticsでこの機能を使用していて、ターゲットまたはExperience Platformをオンにする場合、データストリーム設定の切り替えをオンにして、これらのユースケースを照らし出すだけです。

alloy.js とは？

alloy.js は、Web SDK JavaScript ライブラリの名前です。 SDK のソースコードとファイル名で参照されます。

を使用するためにAdobe Experience Platformを購入する必要があるか Web SDK?

いいえ。Adobeのデジタルエクスペリエンスのお客様は誰でも、Adobe Experience Platform Web SDK を無料で使用できます。の使用を希望するお客様 Web SDK は、データ収集 UI またはExperience PlatformUI でスキーマ、データセット、ID 名前空間およびデータストリームを作成するための適切な権限を設定する必要があります。

これらの権限の設定について詳しくは、次のドキュメントを参照してくださいデータ収集の権限管理.

Web SDK を使用するのは誰ですか？

Adobe Experience Platform Web SDK は、次のお客様向けに開発されました。

Adobe Experience Platform ユーザー
- デバイスからAdobe Experience Platformに直接データを送信する必要がある場合は、これが公式に推奨されている方法です。
- Adobeは、既にAdobe Analyticsがある場合はAdobe Analytics コネクタを使用する方が速いと認識していますが、データ収集に関する長期的な戦略ではありません。
Adobe Experience Cloud ソリューションのお客様
- Adobe Analytics、Adobe Audience Manager、Adobe Targetの新規のお客様は、従来のライブラリを使用せず、新しい Web SDK から開始する必要があります。
- 可能な限り最適化された実装を取得したい既存のお客様は、新しい Web SDK を使用する必要があります。

Web SDK へのアクセス方法を教えてください。

Web SDK は現在一般に利用可能で、Adobe Experience Cloud製品へのデータ送信に使用できます。サードパーティのソリューションにデータを送信する機能は、近い将来に提供される予定です。

SDK は無料で、Adobeがホストします。必要に応じて、無料でダウンロードして独自のサーバーにホストできます。

Web SDK は、次へのアクセスを必要とします。データストリーム設定とExperience Platform XDM スキーマビルダー（Adobeのサーバーが SDK からの受信データを適切に処理するために使用されます）。アクセス権を希望する場合は、Adobeアカウントチームに連絡してリクエストプロセスを開始してください。

Web SDK で現在サポートされているユースケースは何ですか？

Web SDK は急速に進化しています。現在取り組んでいるユースケースは増えています。次を見つけることができます現在ここでサポートされているユースケースのリストです。

現在の顧客は、サイトを再タグ付けする必要がありますか？

場合によります。Adobe Experience Platform Web SDK は、2 つの異なるスタイルでデプロイできます。今後の移行ドキュメントには、追加の詳細が記載されます。

もう 1 つのタグ： サイトが既にソリューション用にタグ付けされていて、再タグ付けできない場合でも、Experience Platformのユースケースや今後のイベント転送機能に関するデータをAdobe Experience Platform Edge Networkに送信したい場合は（以下を参照）、 alloy.js サイトにタグ付けし、「別のタグに過ぎない」ように機能させます。
唯一のタグ： Web SDK をExperience Cloudソリューションに使用する場合は、次の目的で使用する必要があります all そのページのソリューション。例えば、サイトが既にAdobe Analytics用にタグ付けされていて、Target に使用する場合は、将来、他のユーザーと同様に、両方に使用する必要があります。

つまり、ソリューション以外のユースケースにAdobe Experience Platform Web SDK を使用する場合は、でサイトにタグを付けることができます alloy.js 新しいソリューションであるかのように進みます。 Adobe Analytics、Target、Audience Manager、またはアプリケーションのユースケースに使用する場合は、ページ上の従来のコードを削除する必要が生じる場合があります。

Web SDK の使用を開始する際に ECID を移行して、web サイトの訪問者が新しい訪問者として表示されないようにできますか？

はい。Adobe Experience Platform Web SDK には、ID 移行機能が用意されています。の ID 移行の手順に従います Platform Web SDK ID ドキュメントを参照してください。

Web SDK とタグの違いは何ですか？

Experience Platform内のタグ デバイスコードを管理します。これらを使用すると、コードをより簡単にデプロイできます。彼らは自由で強力です。
Adobe Experience Platform Web SDK は、Adobeのユースケース用にタグによってデプロイされる新しいコードの正式名前です。また、無料で強力です。
alloy.js は、Adobe Experience Platform Web SDK コードのファイル名です。

Web SDK をデプロイするには、タグを使用する必要がありますか？

いいえ。をダウンロードできます alloy.js 自分でファイルを作成します。

ただし、

Adobe Experience Platform Web SDK では、Edge Network がストリームを識別してデータの処理方法を決定できるように、データストリーム ID と呼ばれるものが必要です。この ID は、Experience Platform内で作成されます。 UI を使用してプロパティを作成したり JavaScript コードをデプロイしたりする必要があるわけではありませんが、タグを使用して設定 ID を作成する必要があります。
タグは、利用できる最高のタグおよび SDK マネージャーであるだけでなく、デプロイを非常に簡単にします alloy.js およびデータを XDM スキーマにマッピングします。タグを使用しない場合、のデプロイを管理する必要があります alloy.jsを送信する前に、イベントを生成し、データを XDM にマッピングします。これは多いタグを使用するよりも難しいプロセスです。
タグを使用してデプロイすることをお勧めします alloy.js使用する唯一のタグである場合でも同様です。

イベント転送とは

SDK を使用して XDM をEdge Networkに送信すると、これらの新機能イベント転送により、新しいサーバーサイド拡張機能をインストールして、エッジネットワークから任意の場所にデータをマッピングして、任意の場所に送信できます。「サービスとしてのデータ収集」と考えてください。これは、費用が必要で、Adobe Experience Platformの一部としてバンドルされています。

CNAME またはファーストパーティドメインとは何ですか？また、それが重要な理由は何ですか？

CNAME の詳細については、を参照してください。 Adobeドキュメント

はい。現在、Web SDK では、実装に応じて 1～7 個の Cookie を使用します。 Web SDK で表示される可能性のある Cookie とその使用方法のリストを以下に示します。

名前

maxAge

友好時代

説明

knd_orgid_identity

34128000

395 日

ID cookie は、ECID と、ECID に関連するその他の情報を保存します。

kndctr_orgid_consent_check

7200

2 時間

このセッションベースの Cookie は、同意設定サーバー側を検索するようにサーバーにシグナルで通知します。

kndctr_orgid_consent

15552000

180 日

この cookie は、web サイトに対するユーザーの同意設定を保存します。

kndctr_orgid_cluster

1800

30 分

この cookie は、現在のユーザーのリクエストを処理するEdge Networkリージョンを格納します。 Edge Networkがリクエストを正しいリージョンにルーティングできるように、リージョンは URL パスで使用されます。この cookie の有効期間は 30 分です。これにより、ユーザーが別の IP アドレスで接続した場合、リクエストは最も近い地域にルーティングできます。

mbox

63072000

2 年。

この cookie は、Target 移行設定が true に設定されている場合に表示されます。これにより、Target が許可されます mbox cookie Web SDK で設定されます。

mboxEdgeCluster

1800

30 分

この cookie は、Target 移行設定が true に設定されている場合に表示されます。この cookie を使用すると、Web SDK は正しいエッジクラスターを at.js に通信できるため、ユーザーがサイト全体を移動しても、Target プロファイルの同期が維持されます。

AMCV_###@AdobeOrg

34128000

395 日

この cookie は、Adobe Experience Platform Web SDK で ID 移行が有効な場合にのみ表示されます。この cookie は、サイトの一部がまだ visitor.js を使用している場合に Web SDK に移行するのに役立ちます。参照： idMigrationEnabled を参照してください。

Web SDK を使用する場合、Edge Networkは上記の Cookie を 1 つ以上設定します。 Edge Networkは、すべての Cookie をに設定します。 secure および sameSite="none" 属性。

現在、web サイトにセキュリティで保護されたセクションと保護されていないセクションの両方がある場合は、ユーザーの識別が妨げられることがあります。ユーザーがサイトの保護されたセクションから保護されていないセクションに移動すると、Edge Networkは新しい ECID （リクエストを使用）。

Adobe Experience Platform Web SDK はどのブラウザーをサポートしていますか？

Adobe Experience Platform Web SDK は、最新バージョンのGoogle Chrome、Safari、Firefox、Internet Explorer 11、Microsoft Edge Chromium で最適に動作するように設計されています。古いバージョンのブラウザーでは、特定の機能を使用する際に問題が発生する場合があります。

Adobe Experience Platform Web SDK に関する詳細情報はどこで入手できますか？

Internet Explorer のサポート support-internet-explore

この SDK では、非同期タスクの完了を通信する方法である promises を使用します。この約束 sdk で使用される実装は、を除くすべてのターゲットブラウザーでネイティブにサポートされています Internet Explorer. SDK を使用する対象： Internet Explorerに設定します window.Promise ポリフィル.

既に window.Promise がポリフィルされているかどうかを判断するには、次の手順を実行します。

で web サイトを開きます。 Internet Explorer.
ブラウザーのデバッグコンソールを開きます。
コンソールに「window.Promise」とに入力し、Enter キーを押します。

undefined 以外が表示された場合は、既に window.Promise　がポリフィルされている可能性があります。上記のインストール手順を完了した後に Web サイトを読み込むことで、window.Promise がポリフィルされているかどうかを判断する方法もあります。SDK が promise に関するエラーをスローした場合、window.Promise がポリフィルされていない可能性が高くなります。

決定した場合は、ポリフィルする必要があります window.Promiseで、以前に指定したベースコードの上に次のスクリプトタグを含めます。

<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

このタグは、以下を保証するスクリプトを読み込みます window.Promise は有効な Promise 実装です。

NOTE

別の Promise 実装を読み込む場合は、がサポートしていることを確認してください Promise.prototype.finally.

Internet Explorer のサポート

Adobe Experience Platform SDK は、プロミスを使用します。プロミスは、非同期タスクの完了を伝える手段です。この約束 sdk で使用される実装は、を除くすべてのターゲットブラウザーでネイティブにサポートされています Internet Explorer. SDK を使用する対象： Internet Explorerに設定します window.Promise ポリフィル.

promise をポリフィルするために使用できるライブラリの 1 つに、promise-polyfill があります。を参照してください。 promise-polyfill ドキュメント npm と共にインストールする方法の詳細については、を参照してください。