コードベースのエクスペリエンスの設定 code-based-configuration

エクスペリエンスの構築の前に、コンテンツを配信する場所とアプリケーション内で使用する場所を定義する、コードベースのエクスペリエンス設定を作成する必要があります。

コードベースのエクスペリエンス設定では、サーフェス(基本的には変更をレンダリングする場所)を参照する必要があります。 選択したプラットフォームに応じて、場所/パスまたはフルサーフェス URI を入力する必要があります。 詳細情報

コードベースのエクスペリエンス設定の作成 create-code-based-configuration

コードベースのエクスペリエンスチャネル設定を作成するには、次の手順に従います。

  1. チャネル一般設定チャネル設定 ​メニューにアクセスし、「チャネル設定を作成」をクリックします。

  2. 設定の名前と説明(オプション)を入力します。

    note note
    NOTE
    名前は、文字(A ~ Z)で始める必要があります。使用できるのは英数字のみです。アンダースコア(_)、ドット(.)、ハイフン(-)も使用できます。
  3. 設定にカスタムまたはコアのデータ使用ラベルを割り当てるには、「アクセスを管理」を選択します。オブジェクトレベルのアクセス制御(OLAC)について詳しくはこちらを参照してください

  4. この設定を使用してメッセージに同意ポリシーを関連付けるには、マーケティングアクション ​を選択します。顧客の環境設定に従うために、そのマーケティングアクションに関連付けられているすべての同意ポリシーが活用されます。詳細情報

  5. コードベースのエクスペリエンス チャネルを選択します。

  6. コードベースエクスペリエンスを適用するプラットフォームを選択します。

    note note
    NOTE
    複数のプラットフォームを選択できます。 複数のプラットフォームを選択すると、選択したすべてのページまたはアプリにコンテンツが配信されます。
  7. この特定の場所に対してアプリケーションが想定する形式を選択します。 これは、キャンペーンやジャーニーでコードベースのエクスペリエンスを作成する際に使用されます。

  8. 送信」をクリックして、変更を保存します。

キャンペーンとジャーニーで コードベースのエクスペリエンスを作成する際に、この設定を選択できるようになりました。

NOTE
アプリ実装チームは、選択したコードベースのエクスペリエンス設定で定義されたサーフェスのコンテンツを取得するための明示的な API または SDK 呼び出しを行う責任があります。 お客様による様々な実装について詳しくは、 この節を参照してください。

Web プラットフォーム web

Web プラットフォームのコードベースのエクスペリエンス設定を定義するには、次の手順に従います。

  1. 次のいずれかのオプションを選択します。

    • 単一ページ – 単一ページにのみ変更を適用する場合は、「ページ URL」を入力します。

    • ルールに一致するページ – 同じルールに一致する複数の URL をターゲットにするには、1 つ以上のルールを作成します。 詳細情報

      例えば、Luma web サイトのすべての女性向け製品ページに表示される要素を編集する場合は、ドメイン次で始まるluma および​ ページ次を含むwomen を選択します。

  2. プレビュー URL には、次の項目が適用されます。

    • 単一ページの URL を入力した場合は、その URL がプレビューに使用されます。別の URL を入力する必要はありません。

    • ルールに一致するページが選択されている場合、ブラウザーでエクスペリエンスをプレビューするために使用される デフォルトのオーサリングおよびプレビュー URL を入力する必要があります。 詳細情報

  3. ページ上の場所 フィールドは、ユーザーがアクセスするページ内の正確な宛先を指定します。 サイトのナビゲーション構造内のページの特定のセクションにすることができます(「hero-banner」や「product-rail」など)。

モバイルプラットフォーム(iOS および Android) mobile

モバイルプラットフォーム用にコードベースのエクスペリエンス設定を定義するには、次の手順に従います。

  1. アプリ ID を入力します。 これにより、アプリの運用環境内で正確な識別と設定が可能になり、シームレスな統合と機能が保証されます。

  2. アプリ内の場所またはパス を指定します。 このフィールドは、ユーザーがアクセスする、アプリ内の正確な宛先を指定します。 「ヒーローバナー」や「製品レール」など、アプリのナビゲーション構造内の深い特定のセクションまたはページを指定できます。

  3. デバイスでのプレビューを有効にするには、「プレビュー URL」フィールドに入力します。この URL は、デバイスでプレビューをトリガーする際に使用する特定の URL をプレビューサービスに通知します。 詳細情報

    プレビュー URL は、アプリ内でアプリ開発者が設定したディープリンクです。 これにより、ディープリンクスキームに一致する URL が、モバイル web ブラウザーではなくアプリ内で開くようになります。 アプリに設定されているディープリンクスキームを取得するには、アプリ開発者に問い合わせてください。

アプリ実装のディープリンクを設定する際には、次のリソースが役立ちます。
NOTE
エクスペリエンスのプレビュー中に問題が発生した場合は、このドキュメントを参照してください。

その他のプラットフォーム other

他のプラットフォーム(ビデオコンソール、テレビ接続デバイス、スマート TV、キオスク、ATM、音声アシスタント、IoT デバイスなど)でコードベースのエクスペリエンス設定を定義するには、次の手順に従います。

  1. 実装が Web、iOS、Android用でない場合や、特定の URI をターゲットにする必要がある場合は、プラットフォームとして その他 を選択します。

  2. サーフェス URI を入力します。 サーフェス URI は、エクスペリエンスを配信するエンティティに対応する一意の ID です。 詳細情報

    note caution
    CAUTION
    独自の実装で使用する URI と一致するサーフェス URI を入力していることを確認してください。 そうしないと、変更を配信できません。
  3. 必要に応じて、別のサーフェス URI を追加 します。 最大 10 個の URI を追加できます。

    note note
    NOTE
    複数の URI を追加すると、リストされているすべてのコンポーネントにコンテンツが配信されます。

サーフェスとは surface-definition

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

サーフェスは、存在するエンティティ(タッチポイント)を持つ任意のレベルの階層で、コンテナとして見ることができます。

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

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

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

コードベースのエクスペリエンスチャネル設定を作成する場合、選択したプラットフォームに従ってサーフェスを指定するには、次の 2 つの方法があります。

  • WebiOS および Android プラットフォームの場合、サーフェスを構成するには、場所またはパス を入力する必要があります。

  • プラットフォームが その他 の場合は、以下の例のように、完全な サーフェス URI を入力する必要があります。

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

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

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

Web およびモバイル

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

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

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