このドキュメントの情報を使用して、正しい方法でサーバーサイド JavaScript 関数の呼び出しを作成し、変数と値を宣言し、サーバーサイド JavaScript キーワードを参照してください。

Script タグを使用して、アプリケーションで処理する JavaScript ブロックを明確に示します。アプリケーションはこのタグを、大文字と小文字を区別しないインスタンスとして処理します。値を区別する必要がない限り、アプリケーションは引用符を省略可能として処理します。

サーバーは表示時にサーバーサイド JavaScript を実行します。表示後に変数の状態は維持されません。

この例は、サーバーサイド JavaScript ブロックの宣言に必要な最小限の構文を示しています。

サーバーで JavaScript を実行するか、クライアントのブラウザーで JavaScript を実行してエラーを返すかを指定する必要があります。

この例は、完全な構文を示しています。

例には、必要に応じて指定できる 3 つのパラメーターが含まれます。

1. Language パラメーターでは、「JavaScript」または「AMPscript」を指定できます。デフォルトでは「JavaScript」が使用されます。
2. ExecutionContextType では、「Get」または「Post」を指定できます。パラメーターを指定しない場合は、デフォルトの「Get」が使用されます。
3. ExecutionContextName では、実行する名前付きコンテキストを指定できます。

サーバーサイド JavaScript では、購読者属性、システム属性、データエクステンションフィールド、変数、関数、および JavaScript コード式でパーソナライズトークンが使用されます。

以下のタグをパーソナライズ文字列の一部として使用します。

• ctrl - 購読者属性の値、システム属性の値、および送信可能なデータエクステンションのフィールド値を参照します。
• crtl - AMPscript またはサーバーサイド JavaScript スクリプトブロック内で作成された変数を参照します。
• ctrl - JavaScript 式をコンテンツの代替として埋め込みます。

以下の属性をパーソナライズ文字列内で使用できます。

• Name - 属性、送信可能なデータエクステンションのフィールド、または変数を識別します。属性および変数のデータソースではこの値を必ず含める必要があります。

• Default - すべてのタグの省略可能なデフォルト値を提供します。データソースが null または空の文字列の場合、この値が返されます。

• Format - パーソナライズ文字列の形式を指定します。使用する値については、次のリンクを参照してください。

  • [](http://msdn.microsoft.com/en-us/library/dwhawy9k(VS.71)http://msdn.microsoft.com/en-us/library/dwhawy9k(VS.71).aspx
  • [](http://msdn.microsoft.com/en-us/library/az4se3k1(VS.71)http://msdn.microsoft.com/en-us/library/az4se3k1(VS.71).aspx

• Language - 式の言語を指定します。許容される値は「javascript」と「ampscript」で、値が指定されていない場合、デフォルトの「javascript」が使用されます。

独自のサーバーサイド JavaScript 呼び出しを作成するためのひな型として、以下の例を使用してください。この呼び出しをランディングページの任意の場所で使用して、パーソナライズした情報を提供できます。

または

完全な構文では default の値と format の値が追加されます。

全機能の構文を使用するか、サーバーサイド JavaScript で同等の簡単な式構文を使用できます。たとえば、次の 2 つの式は同じ目的を達成します。

サーバーサイド JavaScript は、説明されているメソッドとライブラリを介して Marketing Cloud からの情報とやり取りします。このライブラリを使用するには、まずライブラリを読み込む必要があります。

コアライブラリの現在のバージョンは 1.1.1 で、コアライブラリでは ECMAscript 3.0 がサポートされます。このバージョンはサーバーサイド JavaScript ライブラリの最新の元のバージョンを表し、このバージョンにリビジョンはありません。

このセクションで使用する数値は単なる例です。次の構文を使用してライブラリを読み込みます。

最初のパラメーターではライブラリの名前を指定し、2 番目のパラメーターではライブラリのバージョンを指定します。読み込みコードには両方のパラメーターが必要ですが、ライブラリのマイナー番号は省略可能です。つまり、バージョン番号は存在する必要がありますが、バージョン番号を「1」または「1.2」のように表すことができます。マイナー値が指定されていない場合、読み込みで、そのマイナー更新の最新バージョンが取得されます。

たとえば、サーバーサイド JavaScript のコアライブラリを読み込むには、次の例を使用します。

コアライブラリに 1、1.1、2.0 のバージョンがある場合、読み込みではバージョン 1.1 のライブラリが取得されます。1.2 のバージョンがある場合、呼び出しでは代わりにそのバージョンが返されます。

コアライブラリに 1、1.1、1.2、2.0 のバージョンがある場合、読み込みではバージョン 1.2 のライブラリが取得されます。

サーバーサイド JavaScript では、以下のメソッドがサポートされます。

• Add - API オブジェクトで Web サービス API の Create メソッドを呼び出します。
• Remove - API オブジェクトで Web サービス API の Delete メソッドを呼び出します。
• Update - API オブジェクトで Web サービス API の Update メソッドを呼び出します。
• Retrieve - API オブジェクトで Web サービス API の Retrieve メソッドを呼び出します。

サーバーサイド JavaScript は、示されているライブラリで公開されている .NET CLR (共通言語ランタイム) オブジェクトにのみアクセスできます。許可されていない CLR オブジェクトにアクセスすると、エラーが発生します。

コアライブラリに関するサーバーサイド JavaScript 関数を使用すると、標準の JSON 機能と JavaScript 機能を使用して Marketing Cloud を操作できます。プラットフォームオブジェクトはランディングページとアプリケーション内で機能できます。