- オーディエンス輸出の理解
エクスポート時のJavaScript
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
オーディエンスエクスポートを作成する際は、ゲストプロファイルにあるデータに加えてJavaScriptを使ってデータを計算できます。これにより、Sitecore CDPからエクスポートしたデータをさらに充実させることができます。
例えば、ゲストの生年月日がゲストプロフィールに記載されている場合、追加のコーディングなしで${guest.dateOfBirth}として出力に含めることができます。しかし、ゲストの年齢がゲストプロフィールにない場合は、JavaScriptで計算し、出力に含めることができます。
JavaScriptをオーディエンスエクスポートで使用するには、以下が可能です:
- JavaScriptコードエディタに関数を入力します。コードを手動で書くことも、自然言語を使ってCode Assistantで生成することも可能です。関数の例としてコードスニペットをご覧ください。
- 出力構造タブのフィールドにあるユーティリティ関数を呼び出します。
こちらは、オーディエンスエクスポートでJavaScriptを使う方法を紹介するビデオです:
計算データを出力に含める
JavaScriptをBasicモードで書く場合、計算されたデータをOutput構造タブのAttribute value欄の文字列や数値フィールドに含める必要があります。
JavaScriptが返すオブジェクトのキーを参照する際は、${jsResult.objectKeyName} 表記法を用いてください。例えば、JavaScriptに返されたオブジェクトのage属性が含まれている場合、Attribute valueフィールドにそれを ${jsResult.age}として含めます。
フィールドを更新した後は、変更を 保存 してください。その後、JavaScriptの計算が成功しているか を確認するためにオーディエンスエクスポートをテスト します。
ユーティリティ関数の呼び出し
ユーティリティ関数は ゲストプロファイルのデータにアクセスし、データの変換を行うのに役立ちます。例えば、文字列の結合、日付変換、ハッシュ化して機密データの安全なエクスポートが可能です。
BasicモードでDefiming出力画面でOutput Exportをクリック> Output Additionをクリックし、文字列や数値フィールドのAttribute value欄にユーティリティ関数を入力して、オーディエンスエクスポートでこれらの関数を呼び出せます。関数パラメータは必ずお好みの値に置き換えてください。
以下は ${sha256()} ユーティリティ関数を呼び出してゲストのメールアドレスを安全にエクスポートする例です:
または、以下のデータ拡張オブジェクトを持つゲストプロファイルを考えてみてください:
{ "dataExtensions": { "name": "ext1", "values": { "MemberCardCategoryRenewalDate": "18/05/2026", "MemberCardBalance": 22000, "MemberCardType": "shop&miles", "MemberCardCategory": "premium", "MilesRequiredForMemberCardCategory": 3000 } }
}
Attribute value欄で*${getDataExtension(guest.dataExtensions, "ext1", "MemberCardCategory", "not-available")}*を呼び出して、MemberCardCategoryの値にアクセスして出力に含めることができます。
フィールドを更新した後は、変更を 保存 してください。その後、JavaScriptの計算が成功しているか を確認するためにオーディエンスエクスポートをテスト します。