コードベースのエクスペリエンスの設定 code-based-configuration
エクスペリエンスの構築の前に、コンテンツを配信する場所とアプリケーション内で使用する場所を定義する、コードベースのエクスペリエンス設定を作成する必要があります。
コードベースのエクスペリエンス設定では、サーフェス(基本的には変更をレンダリングする場所)を参照する必要があります。 選択したプラットフォームに応じて、場所/パスまたはフルサーフェス URI を入力する必要があります。 詳細情報
コードベースのエクスペリエンス設定の作成 create-code-based-configuration
コードベースのエクスペリエンスチャネル設定を作成するには、次の手順に従います。
-
チャネル/一般設定/チャネル設定 メニューにアクセスし、「チャネル設定を作成」をクリックします。
-
設定の名前と説明(オプション)を入力します。
note note NOTE 名前は、文字(A ~ Z)で始める必要があります。使用できるのは英数字のみです。アンダースコア( _
)、ドット(.
)、ハイフン(-
)も使用できます。 -
設定にカスタムまたはコアのデータ使用ラベルを割り当てるには、「アクセスを管理」を選択します。オブジェクトレベルのアクセス制御(OLAC)について詳しくはこちらを参照してください
-
この設定を使用してメッセージに同意ポリシーを関連付けるには、マーケティングアクション を選択します。顧客の環境設定に従うために、そのマーケティングアクションに関連付けられているすべての同意ポリシーが活用されます。詳細情報
-
コードベースのエクスペリエンス チャネルを選択します。
-
コードベースエクスペリエンスを適用するプラットフォームを選択します。
note note NOTE 複数のプラットフォームを選択できます。 複数のプラットフォームを選択すると、選択したすべてのページまたはアプリにコンテンツが配信されます。 -
この特定の場所に対してアプリケーションが想定する形式を選択します。 これは、キャンペーンやジャーニーでコードベースのエクスペリエンスを作成する際に使用されます。
-
「送信」をクリックして、変更を保存します。
キャンペーンとジャーニーで コードベースのエクスペリエンスを作成する際に、この設定を選択できるようになりました。
Web プラットフォーム web
Web プラットフォームのコードベースのエクスペリエンス設定を定義するには、次の手順に従います。
-
次のいずれかのオプションを選択します。
-
単一ページ – 単一ページにのみ変更を適用する場合は、「ページ URL」を入力します。
-
ルールに一致するページ – 同じルールに一致する複数の URL をターゲットにするには、1 つ以上のルールを作成します。 詳細情報
例えば、Luma web サイトのすべての女性向け製品ページに表示される要素を編集する場合は、ドメイン/次で始まる/
luma
および ページ/次を含む/women
を選択します。
-
-
プレビュー URL には、次の項目が適用されます。
-
単一ページの URL を入力した場合は、その URL がプレビューに使用されます。別の URL を入力する必要はありません。
-
ルールに一致するページが選択されている場合、ブラウザーでエクスペリエンスをプレビューするために使用される デフォルトのオーサリングおよびプレビュー URL を入力する必要があります。 詳細情報
-
-
ページ上の場所 フィールドは、ユーザーがアクセスするページ内の正確な宛先を指定します。 サイトのナビゲーション構造内のページの特定のセクションにすることができます(「hero-banner」や「product-rail」など)。
モバイルプラットフォーム(iOS および Android) mobile
モバイルプラットフォーム用にコードベースのエクスペリエンス設定を定義するには、次の手順に従います。
-
アプリ ID を入力します。 これにより、アプリの運用環境内で正確な識別と設定が可能になり、シームレスな統合と機能が保証されます。
-
アプリ内の場所またはパス を指定します。 このフィールドは、ユーザーがアクセスする、アプリ内の正確な宛先を指定します。 「ヒーローバナー」や「製品レール」など、アプリのナビゲーション構造内の深い特定のセクションまたはページを指定できます。
-
デバイスでのプレビューを有効にするには、「プレビュー URL」フィールドに入力します。この URL は、デバイスでプレビューをトリガーする際に使用する特定の URL をプレビューサービスに通知します。 詳細情報
プレビュー URL は、アプリ内でアプリ開発者が設定したディープリンクです。 これにより、ディープリンクスキームに一致する URL が、モバイル web ブラウザーではなくアプリ内で開くようになります。 アプリに設定されているディープリンクスキームを取得するには、アプリ開発者に問い合わせてください。
-
Android の場合:
-
iOS の場合:
その他のプラットフォーム other
他のプラットフォーム(ビデオコンソール、テレビ接続デバイス、スマート TV、キオスク、ATM、音声アシスタント、IoT デバイスなど)でコードベースのエクスペリエンス設定を定義するには、次の手順に従います。
-
実装が Web、iOS、Android用でない場合や、特定の URI をターゲットにする必要がある場合は、プラットフォームとして その他 を選択します。
-
サーフェス URI を入力します。 サーフェス URI は、エクスペリエンスを配信するエンティティに対応する一意の ID です。 詳細情報
note caution CAUTION 独自の実装で使用する URI と一致するサーフェス URI を入力していることを確認してください。 そうしないと、変更を配信できません。 -
必要に応じて、別のサーフェス URI を追加 します。 最大 10 個の URI を追加できます。
note note NOTE 複数の URI を追加すると、リストされているすべてのコンポーネントにコンテンツが配信されます。
サーフェスとは surface-definition
コードベースのエクスペリエンス サーフェス は、ユーザーまたはシステムインタラクション用に設計された任意のエンティティで、URI によって一意に識別されます。 サーフェスは、アプリケーション実装で指定され、コードベースのエクスペリエンスチャネル設定で参照されるサーフェスと一致する必要があります。
サーフェスは、存在するエンティティ(タッチポイント)を持つ任意のレベルの階層で、コンテナとして見ることができます。
-
Web ページ、モバイルアプリ、デスクトップアプリ、大きなエンティティ内の特定のコンテンツの場所(
div
など)または非標準の表示パターン(キオスクやデスクトップアプリのバナーなど)が考えられます。 -
また、非表示または抽象された表示を目的として、コンテンツ コンテナの特定の部分に拡張することもできます(サービスに配信される JSON BLOB など)。
-
また、様々なクライアントサーフェス定義に一致するワイルドカードサーフェスにすることもできます(例えば、web サイトの各ページのヒーロー画像の場所を web://mydomain.com/*#hero_image のようなサーフェス URI に変換できます)。
コードベースのエクスペリエンスチャネル設定を作成する場合、選択したプラットフォームに従ってサーフェスを指定するには、次の 2 つの方法があります。
-
Web、iOS および Android プラットフォームの場合、サーフェスを構成するには、場所またはパス を入力する必要があります。
-
プラットフォームが その他 の場合は、以下の例のように、完全な サーフェス URI を入力する必要があります。
サーフェス URI は、アプリケーション内の個別のユーザーインターフェイス要素やコンポーネントに向ける正確な識別子として機能します。 基本的に、サーフェス URI は複数のセクションで構成されます。
- タイプ:web、mobileapp、atm、kiosk、tvcd、service など。
- プロパティ:ページ URL またはアプリバンドル
- コンテナ:ページ/アプリアクティビティ上の場所
次の表に、様々なデバイスのサーフェス URI 定義の例を示します。
Web およびモバイル
web://domain.com/path/page.html#element
mobileapp://com.vendor.bundle/activity#element
mobileapp://com.vendor.bundle/#element
その他のデバイスタイプ
desktop://com.vendor.bundle/#element
tvcd://com.vendor.bundle/#element
service://servicename/#element
kiosk://location/screen#element
atm://location/screen#element
ワイルドカードサーフェス
wildcard:web://domain.com/*#element
wildcard:web://*domain.com/*#element