コードベースのエクスペリエンスサーフェス

最終更新日： 2025年6月23日

作成対象：

  • 経験者
  • 管理者

サーフェスとは

コードベースのエクスペリエンス​ サーフェス ​とは、ユーザーやシステムの操作用に設計されたエンティティで、URI によって一意に識別されます。サーフェスは、アプリケーション実装で指定され、コードベースのエクスペリエンスチャネル設定で参照されるサーフェスと一致する必要があります。

サーフェスは、エンティティ（タッチポイント）が存在する階層の任意のレベルのコンテナと見なすことができます。

  • Web ページ、モバイルアプリ、デスクトップアプリ、大きなエンティティ内の特定のコンテンツの場所（div など）または非標準の表示パターン（キオスクやデスクトップアプリのバナーなど）が考えられます。

  • また、非表示または抽象された表示を目的として、コンテンツ コンテナの特定の部分に拡張することもできます（サービスに配信される JSON BLOB など）。

  • また、様々なクライアントサーフェス定義に一致するワイルドカードサーフェスにすることもできます（例えば、web サイトの各ページのヒーロー画像の場所を web://mydomain.com/*#hero_image のようなサーフェス URI に変換できます）。

メモ
同じサーフェスで実行するコードベースのエクスペリエンスアクションが複数あるとき、エンドユーザーが複数のアクションの対象となる場合に配信される内容は、キャンペーンまたはジャーニーの​ 優先度スコア ​によって決まります。優先度スコアの詳細情報

サーフェス識別子

サーフェス URI は、アプリケーション内の個別のユーザーインターフェイス要素またはコンポーネントを指す正確な識別子として機能します。基本的に、サーフェス URI は複数のセクションで構成されます。

  1. タイプ：web、mobileapp、atm、kiosk、tvcd、service など。
  2. プロパティ：ページ URL またはアプリバンドル
  3. コンテナ：ページ／アプリアクティビティ上の場所

次の表に、様々なデバイスのサーフェス URI 定義の例を示します。

Web およびモバイル

タイプURI説明
Webweb://domain.com/path/page.html#element特定のドメインの特定のページ内の個々の要素を表します。要素は、次の例のようなラベル（hero_banner、top_nav、menu、footer など）にすることができます。
iOS アプリmobileapp://com.vendor.bundle/activity#elementボタンや他のビュー要素など、ネイティブアプリアクティビティ内の特定の要素を表します。
Android アプリmobileapp://com.vendor.bundle/#elementネイティブアプリ内の特定の要素を表します。

その他のデバイスタイプ

タイプURI説明
Desktopdesktop://com.vendor.bundle/#elementボタン、メニュー、ヒーローバナーなど、アプリケーション内の特定の要素を表します。
TV アプリtvcd://com.vendor.bundle/#elementスマート TV または TV 接続デバイスアプリ内の特定の要素（バンドル ID）を表します。
サービスservice://servicename/#elementサーバーサイドのプロセスまたは他の手動エンティティを表します。
キオスクkiosk://location/screen#element容易に追加できる、潜在的な追加サーフェスタイプの例。
ATMatm://location/screen#element容易に追加できる、潜在的な追加サーフェスタイプの例。

ワイルドカードサーフェス

タイプURI説明
ワイルドカード webwildcard:web://domain.com/*#elementワイルドカードサーフェス - 特定のドメインの下の各ページの個々の要素を表します。
ワイルドカード webwildcard:web://*domain.com/*#elementワイルドカードサーフェス - 「domain.com」で終わるすべてのドメインの各ページの個々の要素を表します。