オーディエンスのエクスポート

エクスポートのJavaScript

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

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

オーディエンスのエクスポートを作成するときは、ゲストプロファイルに既に存在するデータに加えて、JavaScriptを使用してデータを計算できます。これにより、Sitecore CDPからエクスポートするデータを充実させることができます。

たとえば、ゲストの生年月日がゲストプロファイルにある場合は、${guest.dateOfBirth}として出力に含めることができます。ただし、ゲストの年齢がゲストプロファイルにない場合は、JavaScriptで計算し、出力に含めることができます。

オーディエンスのエクスポートでJavaScriptを使用するには、次の方法があります。

JavaScriptコードエディタに独自のJavaScript関数を入力します。便利なJavaScript関数の例については、コードスニペットを参照してください。
Output structure」タブのフィールドでユーティリティ関数を呼び出します。

以下は、オーディエンスのエクスポートでJavaScriptを使用する方法を紹介する動画です。

関数を使用したデータの計算

オーディエンスのエクスポートでJavaScript関数を使用するには、コードエディター Output format > Define output > JavaScriptをクリックします。すべての関数が1つの関数内にあることを確認します。

(function () {
  /* first function */
  /* second function */
  /* third function */
  return {}
})()

JavaScriptでは、ゲストプロファイルのデータを操作できます。コードエディターでguestを入力し始めると、ゲストデータモデルへの参照の一覧が表示されます。

Writing JavaScript and referencing data from the guest data model.

メモ

エラーを防ぐために、print()を使用してメッセージをテストログに記録することをお勧めします。エクスポートをテストするときに、テストログを使用します。

JavaScriptでは、1つのオブジェクトを返す必要があります。その後、オブジェクト・キー名を使用して、「Output structure」タブの出力にデータを含めることができます。

以下は、ゲストプロフィールでゲストの生年月日を参照してゲストのおおよその年齢を計算するJavaScript関数の例です。

(function () {
    // Calculate age based on a date
    function getAge(date) {
    var today = new Date();
    var birthDate = new Date(date);
    var age = today.getFullYear() - birthDate.getFullYear();
    var m = today.getMonth() - birthDate.getMonth();
    if (m < 0 || (m === 0 && today.getDate() < birthDate.getDate())) {
        age--;
    }
    return age;
    }
    
    // Calculate the guest's age based on their date of birth
    var guestAge = "";
    if (guest.dateOfBirth) {
        guestAge = getAge(guest.dateOfBirth);
    }
  
    // Return the guest's age in the "age" variable. Then, reference "age" as ${jsResult.age} on the Output structure tab.
    return { age: guestAge }
})()

返されたオブジェクトでは、キー名はageです。ゲストの年齢を出力に含めるには、Output structureタブの列に ${jsResult.age} を書き込みます。

計算データを出力に含める

オーディエンスのエクスポートでは、Output structureタブで、文字列フィールドまたは数値フィールドのAttribute valueフィールドに計算データを含めることができます。 ${jsResult.objectKeyName} 表記を使用します (例: ${jsResult.age}:

Including the computed data from the JavaScript in the output structure.

ユーティリティー関数の呼び出し

ユーティリティ関数は、ゲストプロファイルのデータにアクセスし、データ変換を行うのに役立ちます。たとえば、文字列を結合したり、日付を変換したり、機密データをハッシュ化したりして、データを安全にエクスポートできます。

オーディエンスのエクスポートでこれらの関数を呼び出すには、「 Output format > Define output > Add column」をクリックし、文字列または数値フィールドのAttribute valueフィールドにユーティリティ関数を入力します。関数のパラメーターは、選択した値に置き換えてください。

以下は、ゲストのメールアドレスを安全にエクスポートするために ${sha256()} ユーティリティ関数を呼び出す例です。

または、次のデータエクステンションオブジェクトを持つゲストプロファイルについて考えてみます。

{
  "dataExtensions": [
    {
      "name": "ext1",
      "values": {
        "MemberCardCategoryRenewalDate": "18/05/2025",
        "MemberCardBalance": 22000,
        "MemberCardType": "shop&miles",
        "MemberCardCategory": "premium",
        "MilesRequiredForMemberCardCategory": 3000
      }
    }
  ]
}

Attribute valueフィールドで ${getDataExtension(guest.dataExtensions, "ext1", "MemberCardCategory", "not-available")} を呼び出すと、MemberCardCategoryの値にアクセスし、それを出力に含めることができます。

エクスポートのテスト

変更を保存した後、オーディエンスのエクスポートをテストして、JavaScriptの計算が成功したことを確認することをお勧めします。

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