ルール

メモ

Adobe Experience Platform Launch は、Adobe Experience Platform のデータ収集テクノロジースイートとしてリブランドされています。 その結果、製品ドキュメント全体でいくつかの用語の変更がロールアウトされました。用語の変更点の一覧については、次のドキュメントを参照してください。

Adobe Experience Platform のタグは、ルールベースのシステムに従います。これは、ユーザーの操作に関する各種データを参照します。ルールで設定された条件が満たされると、ルールは、特定した拡張機能、スクリプトまたはクライアント側コードをトリガーします。

異なる製品を 1 つのソリューションに統合するマーケティングおよび広告テクノロジーのデータと機能を統合するためのルールを構築します。

ルール構造

Events (If):​イベントは、ルールで検出する対象です。これは、イベント、適用条件、および例外を選択することで定義されます。

アクション(Then):​トリガーは、ルールのイベントが発生し、すべての条件が満たされた後に発生します。タグのルールでは、個別のアクションを必要なだけトリガーし、それらのアクションの発生順序を制御することができます。例えば、e-コマースのありがとうございますページ用の 1 つのルールから、解析ツールおよびサードパーティタグを同時にトリガーできます。各拡張機能やタグに個別のルールを作成する必要はありません。

イベントタイプは追加できます。複数のイベントは OR で結合され、いずれかのイベントの条件を満たすと、ルールの条件が評価されます。

重要

変更は 公開 されるまでは反映されません。

イベントと条件(if)

条件付きのイベントは、ルールの If 部分です。

指定したイベントが発生した場合、条件が評価され、必要に応じて指定したアクションが実行されます。

  • イベント:ルールをトリガーするために実行する必要があるイベントを 1 つ以上指定します。複数のイベントは OR で結合されます。指定したイベントのいずれかによって、ルールがトリガーされます。

  • 条件:イベントでルールをトリガーするには true である必要がある条件を設定して、イベントを絞り込みます。例外は、NOT 条件として定義されます。複数の条件は AND で結合されます。

使用できるイベントは、インストールされている拡張機能によって異なります。Core 拡張機能のイベントについて詳しくは、「Core 拡張機能のイベントタイプ」を参照してください。

アクション(then)

アクションは、ルールの「Then」部分です。ルールが実行される際に発生することを定義します。イベントがトリガーされた場合、条件が true と評価され、例外が false と評価されると、アクションが実行されます。アクションをドラッグ&ドロップし、必要に応じて並べ替えることができます。

ルールの作成

条件が満たされた場合に発生するアクションを指定するルールを作成します。

  1. 「ルール」タブを開き、「新しいルールを作成」を選択します。

  2. ルール名を設定します。

  3. イベント 追加​アイコンを選択します。

  4. 拡張機能と、その拡張機能で使用可能ないずれかのイベントタイプを選択してから、イベントの設定を指定します。

    使用できるイベントタイプは、選択した拡張機能によって異なります。イベント設定は、イベントタイプに基づいて異なります。設定を指定する必要がないイベントもあります。

    重要

    クライアントサイドのルールでは、データ要素名の先頭と末尾に % を付けてデータ要素をトークン化します。たとえば、%viewportHeight% のように設定します。イベント転送ルールでは、データ要素名の先頭に {{、末尾に }} を付けてデータ要素をトークン化します。例:{{viewportHeight}}

    Edge ネットワークからデータを参照するには、データ要素のパスを arc.event._<element>_ にする必要があります。

    arc は、Adobe Response Context の略語です。

    例:arc.event.xdm.web.webPageDetails.URL

    重要

    このパスが正しく指定されていない場合、データは収集されません。

  5. 順序パラメーターを設定し、「 変更を保持」をクリックします。

    すべてのルールコンポーネントのデフォルトの順序は 50 です。すぐに実行する場合は、50 よりも小さい数値を指定します。

    • 実行順序は数字順です。1 は 3 より前、3 は 10 より前、10 は 100 より前になります。

    • 順番が同じでないルールは、特定の順序で実行されません。

    • ルールは順番に実行されますが、同じ順序で終了するとは限りません。ルール A とルール B がイベントを共有し、ルール A が最初になるように順序を割り当てた場合、ルール A が非同期で何かを実行すると、ルール B が開始する前にルール A が完了する保証はありません。

      後で実行させる場合は、50 よりも大きい数値を指定します。順序について詳しくは、「ルールの順序」を参照してください。

  6. 条件の​追加​アイコンを選択して、論理タイプ、拡張機能、および条件タイプを選択し、条件の設定を指定します。次に、「変更を保持」を選択します。

    使用できる条件タイプは、選択した拡張機能によって異なります。条件設定は、条件タイプに基づいて異なります。

    論理タイプ:

    • 正規論理型を使用すると、条件が満たされた場合にアクションを実行できます
    • 例外論理タイプでは、条件が満たされた場合にアクションが実行されないようにします

    (詳細)Timeout:このオプションは、プロパティでルールコンポーネントの優先順位が有効になっている場合に使用できます。この属性は、条件が実行されるまでに許容される最大時間を定義します。タイムアウトに達した場合、条件は失敗し、ルールの残りの条件とアクションは処理キューから削除されます。デフォルトは、2000 ms です。

    条件は好きなだけ追加できます。同じルール内の複数の条件は AND で結合されます。

  7. アクションの​追加​アイコンを選択して、拡張機能と、その拡張機能で使用可能ないずれかのアクションタイプを選択し、アクションの設定を指定してから「変更を保持」を選択します。

    使用できるアクションタイプは、選択した拡張機能によって異なります。アクション設定は、アクションタイプに基づいて異なります。

    (詳細)Wait to run next action:このオプションは、プロパティでルールコンポーネントの優先順位が有効になっている場合に使用できます。オンにすると、タグは、完了するまで次のアクションを呼び出しません。オフにすると、直ちに次のアクションの実行が開始されます。デフォルトでは、オン​になっています。

    (詳細)Timeout:このオプションは、プロパティでルールコンポーネントの優先順位が有効になっている場合に使用できます。アクションが完了するまでに許容される最大時間を定義します。タイムアウトに達した場合、アクションは失敗し、このルールの後続のアクションは処理キューから削除されます。デフォルトは、2000 ms です。

  8. ルールを確認し、「ルールを保存」を選択します。

    後に公開する際に、このルールをライブラリに追加してデプロイします。

ルールを作成または編集する際は、アクティブなライブラリに保存および成できます。これにより、変更は直ちにライブラリに保存され、ビルドが実行されます。ビルドのステータスが表示されます。

ルール順序

ルール順序を使用すると、イベントを共有するルールの実行順序を制御できます。

ルールを特定の順序で実行することが重要な状況は、頻繁に発生します。例:(1)条件付きで Analytics 変数を設定するいくつかのルールがあり、「Send Beacon」のルールを最後にする必要がある場合。(2)Target を実行するールールと、Analytics を実行する別のルールがあり、Target ルールを最初に実行したい場合。

最終的に、アクションを順に実行する責任は、使用しているイベントタイプの拡張開発者が負います。Adobe 拡張機能の開発者は、拡張機能が意図したとおりに動作することを確認します。サードパーティの拡張機能については、アドビは拡張機能開発者に対して、これを適切に実装するためのガイダンスを提供しますが、それをおこなうかどうかは開発者次第です。

アドビは、1 から 100 の正の数でルールを並べ替えることを強く推奨します(デフォルトは 50)。シンプルな方がよいでしょう。順序は保持する必要があります。ただし、 制限されているように感じるエッジケースがあることをアドビは認識しています。そのため、他の数字も使用できます。タグは、+/- 2,147,483,648 の間の数値をサポートしています。また、小数点 10 位以下の桁数を使用することもできますが、それが必要だと思われる状況の場合、現状を把握するため、いくつかの決断について再考する必要があります。

重要

ルールの「アクション」セクションでは、サーバーサイドのルールが順番に実行されます。ルールを作成する際は、順序が正しいことを確認してください。

シナリオ

  • 5 つのルールでイベントを共有しています。すべてにデフォルトの優先順位が設定されています。そのうち 1 つを最後に実行したい場合は、1 つのルールコンポーネントを編集し、50 よりも大きい数値(例:60)を入力します。
  • 5 つのルールでイベントを共有しています。すべてにデフォルトの優先順位が設定されています。そのうち 1 つを最初に実行したい場合は、1 つのルールコンポーネントを編集し、50 よりも小さい数値(例:40)を入力します。

クライアント側のルール処理

ルールの読み込み順序は、ルールアクションが JavaScript、HTML またはその他のクライアント側コードのどれで設定されているか、ルールがページ下部/上部イベントまたは異なるタイプのどのイベントを使用しているかによって異なります。

ルールに設定されているイベントに関係なく、カスタムスクリプト内で document.write を使用できます。

異なるカスタムコードタイプを相互に並べることができます。例えば、JavaScript カスタムコードアクション、HTML カスタムコードアクション、JavaScript カスタムコードアクションの順で使用できるようになりました。タグは、それらのアクションがその順序で実行されるようにします。

ルールのバンドル

ルールのイベントと条件は、常にメインのタグライブラリにバンドルされます。アクションは、メインライブラリにバンドルされるか、サブリソースが必要とするだけ遅く読み込まれます。アクションがバンドルされているかどうかは、ルールのイベントタイプによって決まります。

「Core - Library Loaded」または「Core - Page Top」イベントを含むルール

これらのイベントは、(条件が false に評価されない限り)ほとんど常に実行される必要があるので、効率性を考慮して、埋め込みコードによって参照されるファイルであるメインライブラリにバンドルされます。

  • Javascript: JavaScript は、メインのタグライブラリに埋め込まれます。カスタムスクリプトはスクリプトタグでラップされ、document.write を使用してドキュメントに書き込まれます。ルールに複数のカスタムスクリプトがある場合、それらは順番に記述されます。

    メモ

    タグでは ES5 JavaScript が使用されます。イベント転送では ES6 が使用されます。

  • HTML: HTML は、メインのタグライブラリに埋め込まれます。document.write を使用して、ドキュメントに HTML を書き込みます。ルールに複数のカスタムスクリプトがある場合、それらは順番に記述されます。

他のイベントを含むルール

アドビでは、他のルールが実際にトリガーされ、そのアクションコードが必要になるということは保証できません。このため、前述のリストに記載されていないすべてのイベントタイプのアクションは、メインライブラリにパッケージ化されません。代わりに、サブリソースとして保存され、必要に応じてメインライブラリによって参照されます。

  • JavaScript: JavaScript は、サーバーから通常のテキストとして読み込まれ、script タグで囲まれ、Postscribe を使用してドキュメントに追加されます。ルールに複数の JavaScript カスタムスクリプトがある場合、それらはサーバーから並行して読み込まれますが、ルール内の設定と同じ順序で実行されます。
  • HTML: HTML はサーバーから読み込まれ、Postscribe を使用してドキュメントに追加されます。ルールに複数のカスタムHTML スクリプトがある場合、それらはサーバーから並行して読み込まれますが、ルール内の設定と同じ順序で実行されます。

ルールコンポーネントの優先順位

タグランタイム環境の動作は、プロパティで「ルールコンポーネントを順番に実行」がオンとオフのどちらに設定されているかによって異なります。

有効

有効にすると、実行時にイベントがトリガーされた場合、ルールの条件とアクションが、定義された順序に基づいて処理キューに追加され、FIFO ベースで一度に 1 つずつ処理されます。タグは、コンポーネントが完了するのを待ってから、次のコンポーネントに移動します。

条件が false と評価されるか定義されたタイムアウトに達すると、そのルールの後続の条件とアクションはキューから削除されます。

アクションに失敗するか定義されたタイムアウトに達すると、そのルールの後続のアクションはキューから削除されます。

メモ

この設定を有効にすると、タグライブラリを同期的に読み込んだ場合でも、すべての条件とアクションが非同期的に実行されます。

無効

無効にすると、実行時にイベントがトリガーされた場合、ルールの条件が直ちに評価されます。複数の条件が並行して評価されます。

すべての条件が true を返す場合(および例外が false を返す場合)は、ルールのアクションが直ちに実行されます。アクションは順番に呼び出されますが、タグは、完了するのを待たずに次のアクションを呼び出します。アクションが同期している場合、アクションは順番に実行されます。1 つ以上のアクションが非同期の場合、一部のアクションは並行して実行されます。

このページ