プロファイル属性

プロファイル属性は、訪問者に固有のパラメーターです。プロファイル属性は訪問者のプロファイルに保存され、アクティビティで使用可能な訪問者に関する情報を提供します。

ユーザープロファイルには、年齢、性別、購入商品、最終訪問時など、Webページ訪問者の人口統計や行動に関する情報が含まれ、ターゲットが訪問者に提供するコンテンツをパーソナライズするために使用します。

訪問者がWebサイトを閲覧したり、訪問者が別のセッションに戻ったりする際に、プロファイルに保存されたプロファイル属性を使用して、コンテンツのターゲットや、セグメントフィルタリングの情報のログを作成できます。

プロファイル属性を設定するには：

1. オーディエンス/プロファイルスクリプトをクリックします。

   

2. 「スクリプトを作成」をクリックします。

   

   以下のタイプのプロファイル属性を利用できます。

   パラメータータイプ	説明
   mbox	mbox を作成するときに、ページコードを介して直接渡されます。詳しくは、グローバルmboxへのパラメーターの引き渡し を参照してください。 注意：Target には、mbox 呼び出しごとに 50 個の独自のプロファイル属性という制限があります。50 個を超えるプロファイル属性を Target に渡す必要がある場合、プロファイル更新 API メソッドを使用して渡すことができます。詳しくは、Adobe TargetAPIドキュメント🔗のプロファイルの更新を参照してください。
   プロファイル	JavaScript コードスニペットにより直接定義されます。これらのパラメーターは、現在の合計数（顧客が支払った合計金額など）を保存することができ、mbox リクエストごとに実行されます。詳しくは、プロファイルスクリプト属性を参照してください。

プロファイルスクリプト属性

関連する JavaScript コードスニペットを使用して、プロファイルスクリプト属性を定義します。

プロファイルスクリプトを使用して、複数の訪問にわたり、訪問者の属性を取得できます。プロファイルスクリプトは、サーバー側の JavaScript の形式を使用して、Target 内で定義するコードスニペットです。例えば、プロファイルスクリプトを使用して、訪問者がサイトを訪問する頻度や前回の訪問日時を取得できます。

プロファイルスクリプトは、プロファイルパラメーターとは異なります。プロファイルパラメーターでは、Target の mbox コード実装を使用して、訪問者に関する情報を取得します。

プロファイルスクリプトの作成

プロファイルスクリプトは、インターフェイスの「オーディエンスTarget」タブで使用できます。

新しいプロファイルスクリプトを追加するには、 「プロファイルスクリプト 」タブをクリックし 、スクリプト を作成してスクリプトを作成します。

または

既存のプロファイルスクリプトをコピーするには、プロファイルスクリプトリストで、目的のスクリプトの上にマウスポインターを置き、コピー​アイコンをクリックします。

これにより、そのオーディエンスを編集して類似のオーディエンスを作成することができます。

プロファイルスクリプトは、各場所リクエストでプロファイル属性「catchers」を実行します。場所リクエストを受信すると、Target はどのアクティビティを実行するかを決定し、そのアクティビティおよびそのエクスペリエンスに適したコンテンツを表示し、アクティビティの成功を追跡し、関連するプロファイルスクリプトを実行します。これにより、訪問者の場所、時間帯、訪問者がサイトを訪問した回数、購入歴があるかなど、訪問に関する情報を追跡できます。 この情報は次に、訪問者のプロファイルに追加され、サイトでの訪問者のアクティビティをより詳細に追跡できます。

プロファイルスクリプト属性では、属性名の前に user. タグが挿入されます。次に例を示します。

if (mbox.name == 'Track_Interest') { 
    if (profile.get('model') == "A5" &&; profile.get('subcat') == "KS6") { 
        return (user.get('A5KS6') || 0) + 1; 
    } 
}

次の情報に注意してください。

• コード内で、user.get('parameterName') を使用して、プロファイルスクリプト属性をいくつか参照します（定義中のパラメーター自体も含む）。
• user.setLocal('variable_name', 'value') を使用すると、スクリプトを次回実行するとき（次の mbox リクエストの発生時）にアクセスされる可能性がある変数を保存できます。変数を参照 user.getLocal('variable_name') します。これは、最後のリクエストの日時を参照する場合に便利です。
• パラメーターおよび値の大文字と小文字は区別されます。オーディエンスまたはテストの実行中に受け取るパラメーターおよび値の大文字と小文字を一致させてください。
• その他の JavaScript 構文については、後述の「スクリプトプロファイルパラメーターに関する JavaScript リファレンス」を参照してください。
• スクリプトを無効にした後も、プロファイルーには引き続きパラメーターが表示されます。 プロファイルに既にアクティビティのオーディエンスーで使用されているパラメーターが含まれている場合、そのアクティビティに該当します。
• プロファイルスクリプトは、アクティビティで使用中は削除できません。
• あるプロファイルスクリプトの結果を別のプロファイルスクリプトで使用する依存プロファイルスクリプトを作成することはお勧めしません。 プロファイルスクリプトの実行順序は保証されません。

プロファイルスクリプト情報カードの表示

オファー情報カードに似たプロファイルスクリプト情報ポップアップカードを表示できます。これらのプロファイルスクリプト情報カードでは、選択したプロファイルスクリプトを参照しているアクティビティのリストやその他の有用なメタデータが表示されます。

例えば、次のプロファイルスクリプト情報カードは、プロファイルスクリプトリスト（Audiences／プロファイルスクリプト）のプロファイルスクリプトにマウスポインターを置いてから、情報アイコンをクリックしてアクセスします。

「スクリプト情報」タブには、「名前」、「ステータス」、「トークンの種類」、「スクリプト ID」、「変更ログ」、「説明」の各情報が含まれています。

「スクリプト使用状況」タブには、選択したプロファイルスクリプトを参照するアクティビティ（およびワークスペース）が一覧表示されます。

特定の状況での Target によるプロファイルスクリプトの無効化

Target 実行に時間がかかりすぎたり、命令が多すぎるなど、特定の状況でプロファイルスクリプトを自動的に無効にします。

プロファイルスクリプトが無効化されると、次に示すように、Target UI のプロファイルスクリプトの横に黄色の警告アイコンが表示されます。

マウスポインターを重ねると、次のように、エラーの詳細が表示されます。

システムがプロファイルスクリプトを無効にする一般的な理由は次のとおりです。

• 未定義の変数が参照されている。
• 無効な値が参照されている。これは、多くの場合、URL 値およびその他のユーザー入力データを適切な検証なしに参照することが原因です。
• 使用される JavaScript 命令が多すぎる。Target には、スクリプトあたり 2,000 の JavaScript 命令という制限がありますが、これは、手作業で JavaScript を読んで単純に計算することはできません。例えば、Rhino は、すべての関数呼び出しと「新規」呼び出しを 100 個の命令として処理します。つまり、任意の関数を呼び出すと、100個の命令が消費されます。 また、すべてのエントリデータのサイズ（URL 値など）は、命令数に影響を与える可能性があります。
• 後述のベストプラクティスの節で取り上げられている項目に従っていない。

ベストプラクティス

次のガイドラインは、エラーや失敗をできるだけなくした簡潔なプロファイルスクリプトを記述するためのもので、正常に失敗するコードを記述することで、プロファイルスクリプトの処理時にシステムスクリプトの停止が起こらないようにするものです。これらのガイドラインは、効果的に実行されることが証明されたベストプラクティスによるものです。このガイドラインは、Rhino 開発者コミュニティによる原則および推奨事項に従い適用されるものです。

• 現在のスクリプト値をユーザースクリプトのローカル変数に設定し、フェイルオーバーを空白の文字列に設定します。

• ローカル変数を検証します。ローカル変数値が空白の文字列でないことを確認します。

• 正規式とは異なり、文字列ベースの操作関数を使用します。

• 実行回数を制限しないで for ループや while ループを使用することはせず、有限回数の for ループを使用します。

• 文字列の長さは 1,300 文字、ループ回数は 50 回を超えないようにします。

• JavaScript 命令は 2,000 個を超えないようにします。Target には、スクリプトあたり 2,000 の JavaScript 命令という制限がありますが、これは、手作業で JavaScript を読んで単純に計算することはできません。例えば、Rhino は、すべての関数呼び出しと「新規」呼び出しを 100 個の命令として処理します。また、すべてのエントリデータのサイズ（URL 値など）は、命令数に影響を与える可能性があります。

• スクリプトのパフォーマンスだけでなく、組み合わされたすべてのスクリプトのパフォーマンスにも注意してください。ベストプラクティスとして、命令数の合計が 5,000 未満となるようにすることをお勧めします。命令の数を数えることは明らかではありませんが、2,000命令を超えるスクリプトは自動的に無効になることに注意する必要があります。 アクティブなプロファイルスクリプトの数は300を超えてはなりません。 各スクリプトは、mboxの呼び出しが1回行われるたびに実行されます。 必要なスクリプトだけを実行します。

• 正規表現では、先頭にドットとアスタリスクを置く（例：/.*match/、/a|.*b/）のはほとんど必要ありません。正規表現検索は、文字列のすべての位置から開始（^ でバインドされている場合を除く）されるので、ドットとアスタリスクは既に想定されています。そうした正規表現が十分な長さ（数百文字以下）の入力データに一致すると、スクリプトの実行は中断されます。

• すべてを実行してもうまくいかない場合は、スクリプトを try ～ catch 文で囲みます。

• 次の推奨事項は、プロファイルスクリプトの複雑さを制限するのに役立ちます。 プロファイルスクリプトで実行できる命令の数は限られています。

  ベストプラクティスとして：

  • プロファイルスクリプトは小さく、できるだけ単純にします。
  • 正規式を使用しないでください。または、非常に単純な正規式のみを使用してください。 単純な式でも、評価に多くの指示を受けることができます。
  • 再帰を避けます。
  • プロファイルスクリプトをターゲットに追加する前に、パフォーマンステストを行う必要があります。 すべてのプロファイルスクリプトは、すべてのmboxリクエストで実行されます。 プロファイルスクリプトが正しく実行されない場合、mboxリクエストの実行に時間がかかります。 これは、トラフィックとコンバージョンに影響を与える可能性があります。
  • プロファイルスクリプトが複雑すぎる場合は、応答トークンを代わりに使用することを検討してください。

• 詳しくは、JS Rhinoエンジンのドキュメントを参照してください。https://www.mozilla.org/rhino/doc.html.

プロファイルスクリプトのデバッグ

プロファイルスクリプトのデバッグには、次のメソッドを使用できます。

• プロファイルスクリプトをレスポンストークンとして追加し、プロファイルスクリプトをデバッグ

  ターゲットで、「管理」をクリックし、「応答トークン」をクリックして、デバッグするプロファイルスクリプトを有効にします。

  次に示すように、Target を使用してページをサイトに読み込むたびに、Target からのレスポンスの一部として、指定したプロファイルスクリプトの値が含まれます。

  

• mboxTrace デバッグツールを使用してプロファイルスクリプトをデバッグ

  このメソッドには、ターゲット/管理/実装/デバッガツールの​生成認証トークンが必要です。

  その後、2 つのパラメーター mboxTrace=window&authorization=YOURTOKEN をページ URL の "?" のうしろに加えます。

  これは、プロファイルの実行前後のスナップショットを取得できるため、レスポンストークンよりもやや詳細な情報を提供します。また、使用可能なすべてのプロファイルも表示されます。

  

プロファイルスクリプトの FAQ

プロファイルスクリプトを使用してデータレイヤーにあるページから情報を取得できますか？

プロファイルスクリプトはサーバー側で実行されるので、プロファイルスクリプトを使用してページを直接読み取ることはできません。データを渡すには、mbox リクエストまたは他のデータを Target に送信する方法を使用する必要があります。データを Target に送信した後は、プロファイルスクリプトを使用して、データを mbox パラメーターまたはプロファイルパラメーターとして読み取ることができます。

スクリプトプロファイルパラメーターに関する JavaScript リファレンス

スクリプトのプロファイルを効果的に使用するには、単純なJavaScriptの知識が必要です。
パラメーター こセクションは、この機能を使用してわずか数分で生産性を高めるためのクイックリファレンスの役割を担います。

スクリプトプロファイルパラメーターは、「mbox/プロファイル」タブの下にあります。JavaScript の種類（文字列、整数、配列など）を返す Javascript プログラムを記述できます。

スクリプトプロファイルパラメーターの例

**名前：**user. recency

var dayInMillis = 3600 * 24 * 1000;
if (mbox.name == 'orderThankyouPage') {
    user.setLocal('lastPurchaseTime', new Date().getTime());
}
var lastPurchaseTime = user.getLocal('lastPurchaseTime');
if (lastPurchaseTime) {
    return ((new Date()).getTime() - lastPurchaseTime) / dayInMillis;
}

日の変数をミリ秒単位で作成します。mbox 名が orderThankyouPage の場合は、現在の日付と時間の値を取得するために、lastPurchaseTime と名前を付けたローカル（非表示）のユーザープロファイル属性を設定します。前回購入時間の値が読み取られており、その値が定義されている場合は、1 日のミリ秒数で割り算された、前回購入時間以降に経過した時間を返します（前回購入からの日数になります）。

**名前：**user. frequency

var frequency = user.get('frequency') || 0;
if (mbox.name == 'orderThankyouPage') {
    return frequency + 1;
}

frequencyという変数を作成し、前の値に初期化します。以前の値がない場合は0にします。 mbox 名が orderThankyouPage の場合、増分された値が返されます。

**名前：**user.monetaryValue

var monetaryValue = user.get('monetaryValue') || 0;
if (mbox.name == 'orderThankyouPage') {
    return monetaryValue + parseInt(mbox.param('orderTotal'));
}

monetaryValue と呼ばれる変数を作成し、特定の訪問者の現在の値を検索します（または以前の値がない場合は 0 に設定します）。mbox 名が orderThankyouPage の場合、以前の値と mbox に渡される orderTotal パラメーターの値を追加することによって、新しい金額が返されます。

名前： adobeQA

if (page.param("adobeQA"))
     return page.param("adobeQA");
else if (page.param("adobeqa"))
     return page.param("adobeqa");
else if (mbox.param("adobeQA"))
     return mbox.param("adobeQA");

adobeQAという変数を作成して、アクティビティQAのユーザーを追跡します。

オブジェクトとメソッド

次のプロパティとメソッドは、スクリプトプロファイルパラメーターで参照できます。

共通演算子

すべての標準 JavaScript 演算子が存在し、使用可能です。JavaScript 演算子は、文字列および数字（他のデータタイプも同様）に使用できます。簡単な説明：

トレーニングビデオ：プロファイルスクリプト

このビデオでは、プロファイルスクリプトの使用と作成に関する情報を説明します。

• プロファイルスクリプトの概要説明
• プロファイルスクリプトとプロファイルパラメーターの違いの説明
• シンプルなプロファイルスクリプトの作成
• 利用可能なオプションにアクセスするための利用可能なトークンメニューの使用
• プロファイルスクリプトの有効化と無効化