カスタム条件を作成する

条件要素

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

重要

機能の利用可能性は段階的に展開される一環です。あなたの組織はまだこの機能に気づいていないかもしれません。環境が導入された際に利用可能になります。

始める前に、条件のパラメータやコンテキストパラメータ、サポートされていないJavaScript関数の種類をしっかり理解してください。条件内の変数を宣言するには、以下の構造を用いてください。

let nameParam = `[[parametername | type | value1 | {config1: value1, config2: value2 } ]]`;

以下の表には、使用できる条件要素の説明が含まれています。

Element	概要	必須
parameter_name	マーケターが条件を追加する際に目にするフィールドの名前です。例:カート取引。	はい
type	マーケターが条件を使う際に入力する入力の種類。選択肢:文字列、テキスト、数字、エナック。	はい
default_value	パラメータ入力のデフォルト値です。	オプションですが、マーケターが選択できる変数を追加したい場合には必要です。
configuration	選択したtypeに関連する名前/値ペアを含むJSON設定オブジェクトです。	オプション
placeholder	入力欄に表示されるプレースホルダーテキストで、マーケターがここで求められる入力の種類を理解するのに役立ちます。	オプション

例1:サイト訪問者をタイプで識別する条件

この条件は、新規訪問者か再訪者かというタイプでサイト訪問者を識別します。これは、訪問者の既存のクローズドウェブセッションの有無を確認することで行われます。セッションが存在する場合、ビジターは "returning"に分類されます。セッションが存在しない場合、訪問者は新規とみなされます。 userTypeパラメータにより、マーケターは訪問者が新規か再来者かを選択できます。

(function () {
    var userType = "[[type | enum(new, returning) | | { required: true, placeholder: type }]]";
    var expectedType = "WEB";
    var expectedStatus = "CLOSED";
    var isReturning = false;

    if (guest && guest.sessions && guest.sessions.length > 0) {
         for (var index = 0; index < guest.sessions.length; index++) {
             if (
                 guest.sessions[index] &&
                 expectedType === guest.sessions[index].sessionType &&
                 expectedStatus === guest.sessions[index].status
             ) {
                 isReturning = true;
                 break;
             }
         }
     }

    if (isReturning && userType === "returning") {
         return true;
     } else if (!isReturning && userType === "new") {
         return true;
     } else {
         return false;
     }
})();

例2:データ拡張で文字列の値を確認する条件

この条件は文字列比較を用いてデータ拡張内の特定の値をチェックします。訪問者に関連するすべてのデータ拡張をループし、一致するフィールドと値を探します。条件は、指定されたフィールドの値が選択された演算子( === や !==)で定義された値と一致すれば成立します。

(function () {
    for (var i = 0; i < guest.dataExtensions.length; i++) {
        if (guest.dataExtensions[i].name === "[[ Data Extension Name | string]]"
        && guest.dataExtensions[i].values
        && guest.dataExtensions[i].values.[[Custom Field Name | string]]) {
            return guest.dataExtensions[i].values.[[Custom Field Name]] [[Operator | enum(===,!==)]] "[[ Value | string ]]";
        }
    }
    return false;
})();

例3:データ拡張で数値をチェックする条件

この条件はデータ拡張内の特定の数値をチェックします。前例の文字列マッチ版と似ていますが、===、!==、<、<=、>、>=などの数値比較演算子をサポートしています。

(function () {
    for (var i = 0; i < guest.dataExtensions.length; i++) {
        if (guest.dataExtensions[i].name === "[[ Data Extension Name | string]]"
        && guest.dataExtensions[i].values
        && guest.dataExtensions[i].values.[[Custom Field Name | string]]) {
            return guest.dataExtensions[i].values.[[Custom Field Name]] [[Operator | enum(===,!==,<,<=,>,>=)]] [[ Value | number ]];
        }
    }
    return false;
})();

この記事を改善するための提案がある場合は、お知らせください!