Skip to main content
Sitecore Documentation
  • Learn
  • Downloads
  • Changelog
  • Roadmap
CDPCloud Portal
Sitecore CDP
  • データ ブラウザー機能を使用する
    • オーディエンスの活性化のためのアイデア
    • オーディエンスのエクスポートを管理する
        • コード スニペット
        • ユーティリティ関数
    • オーディエンスのエクスポートのトラブルシューティング
  1. オーディエンスのエクスポート
  1. Sitecore CDP
  2. オーディエンスのエクスポート
  3. ユーティリティ関数

ユーティリティ関数

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

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

以下は、オーディエンスのエクスポートで呼び出すことができるユーティリティ関数のリストです。

${concat(区切り文字列, firstString, secondString)}

この関数は、最初の文字列の末尾に2番目の文字列を追加して作成された文字列を返します。2つの文字列の間に区切り文字列を指定できます。

サイドバー 。 Parameters

パラメーター

種類

形容

例

separatorString

糸

最初の文字列と2番目の文字列の間にある文字列。

区切り文字列を使用しないようにするには、この値を空の文字列 ""に設定します。

  • "+"

  • "-"

  • ""

firstString

文字列を表す文字列またはオブジェクト属性

連結された文字列の先頭にある文字列。

  • "IE"

  • guest.country

secondString

文字列を表す文字列またはオブジェクト属性

連結された文字列の末尾にある文字列。

  • "Dublin"

  • guest.city

ゲストプロフィールでゲストの国と都市を考慮してください。

{
  "country": "IE",
  "city": "Dublin"
}

countryとcityの値を連結し、連結された文字列を出力に含めるには、Output structureタブのAttribute valueフィールドに次のように入力します。

${concat("_", guest.country, guest.city)}

上記の例のゲスト プロファイルの場合、戻り値は "IE_Dublin"になります。

${getDataExtension(extObj, extName, extKey, フォールバック)}

この関数は、ゲストプロファイルで使用可能なデータエクステンション値を返します。

サイドバー 。 Parameters

パラメーター

種類

形容

例

extObj

オブジェクト

ゲストプロファイル内のデータエクステンションオブジェクトへの参照。

この値はguest.dataExtensionsに設定する必要があります。

guest.dataExtensions

extName

糸

拡張機能の名前。

"ext1"

extKey

糸

出力に含める値の拡張キー。

"MemberCardCategory"

fallback

随意

糸

拡張機能がゲスト プロファイルに存在しない場合に出力に含めるフォールバック値。

"not-available"

Example 2. 例: MemberCardCategoryの値へのアクセス

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

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

MemberCardCategoryの値にアクセスして出力に含めるには、「Output structure」タブのAttribute valueフィールドに次のように入力します。

${getDataExtension(guest.dataExtensions, "ext1", "MemberCardCategory", "not-available")}

上記の例のゲスト プロファイルの場合、戻り値は "premium"になります。

このデータエクステンションを持たないゲストプロファイルの場合、戻り値は "not-available"になります。



${getIdentifier(識別子Obj, provider, フォールバック)}

この関数は、ゲスト プロファイルで使用可能な場合、ゲストの識別子IDを返します。

サイドバー 。 Parameters

パラメーター

種類

形容

例

identifiersObj

オブジェクトの配列

ゲスト プロファイル内の識別子オブジェクトへの参照。

この値はguest.identifiersに設定する必要があります。

guest.identifiers

provider

糸

一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore CDPの外部)。

"BXLP"

fallback

随意

糸

これらの識別子がゲスト プロファイルに存在しない場合に出力に含めるフォールバック値。

"not-available"

ゲスト プロファイル内のゲストのidentifiers配列のオブジェクトについて考えてみます。

{
 "identifiers": [
    {
      "ref": "3d67f887-9e6f-55c7-9390-027e3fff5595",
      "createdAt": "2025-05-31T15:12:22.947Z",
      "modifiedAt": "2025-05-31T15:12:22.947Z",
      "provider": "BXLP",
      "id": "3bb8fb2092d1"
    }
  ]
}

identifiers.idの値を出力に含めるには、「Output structure」タブのAttribute valueフィールドに次のように入力します。

${getIdentifier(guest.identifiers, "BXLP", "not-available")}

上記の例のゲスト プロファイルの場合、戻り値は "3bb8fb2092d1"になります。

これらの識別子を持たないゲスト プロファイルの場合、戻り値は "not-available"になります。

${formatDate(日付, ロケール, タイムゾーン)}

この関数は、ISO日付を読みやすい日付にフォーマットし、選択した日付形式を使用します。

サイドバー 。 Parameters

パラメーター

種類

形容

例

date

文字列 (ISO 8601) またはそのような文字列を表すオブジェクト属性

変換するISO日付 (ゲストの生年月日や最終視聴日など)。

  • "1984-04-15T01:04:00.000Z"

  • guest.dateOfBirth

  • guest.lastSeen

locale

文字列 (BCP 47)

選択した日付形式を使用する地域の言語タグ。

  • "EN-US"

  • "EN-IE"

  • "EN-AU"

timezone

随意

string (タイム ゾーンの省略形)

書式設定された日付のタイム ゾーン。

デフォルトは "UTC"です。

  • "GMT"

  • "UTC"

ゲストプロフィールでゲストの生年月日を考慮してください。

{
  "dateOfBirth": "1984-04-15T01:04:00.000Z"
}

この日付を米国英語の日付形式に書式設定し、出力に含めるには、Output structureタブのAttribute valueフィールドに次のように入力します。

${formatDate(guest.dateOfBirth, "en-US")}

上記の例のゲスト プロファイルの場合、戻り値は "4/15/1984"になります。

${formatTime(時間, ロケール, タイムゾーン)}

この関数は、選択した時刻形式を使用して、ISO日付を読みやすい時刻に書式設定します。

サイドバー 。 Parameters

パラメーター

種類

形容

例

time

文字列 (ISO 8601) またはそのような文字列を表すオブジェクト属性

変換するISO日付 (たとえば、注文の時刻)。

  • "1984-04-15T01:04:00.000Z"

  • guest.dateOfBirth

  • guest.lastSeen

locale

文字列 (BCP 47)

選択した時間形式を使用する地域の言語タグ。

  • "EN-US"

  • "EN-IE"

  • "EN-AU"

timezone

随意

string (タイム ゾーンの省略形)

書式設定された時刻のタイム ゾーン。

デフォルトは "UTC"です。

  • "GMT"

  • "UTC"

ゲストプロフィールでゲストの生年月日を考慮してください。

{
  "dateOfBirth": "1984-04-15T01:04:00.000Z"
}

この日付を米国英語の時間形式に書式設定し、出力に含めるには、Output structureタブのAttribute valueフィールドに次のように入力します。

${formatTime(guest.dateOfBirth, "en-US")}

上記の例のゲスト プロファイルの場合、戻り値は "3:04:00 AM"になります。

${formatDateTime(時間, ロケール, タイムゾーン)}

この関数は、ISO日付を、選択した日付と時刻の形式を使用して、読みやすい日付と時刻に書式設定します。

サイドバー 。 Parameters

パラメーター

種類

形容

例

time

文字列 (ISO 8601) またはそのような文字列を表すオブジェクト属性

変換するISO日付 (ゲストの生年月日や最終表示日時など)。

  • "1984-04-15T01:04:00.000Z"

  • guest.dateOfBirth

  • guest.lastSeen

locale

文字列 (BCP 47)

選択した日付と時刻の形式を使用する地域の言語タグ。

  • "EN-US"

  • "EN-IE"

  • "EN-AU"

timezone

随意

string (タイム ゾーンの省略形)

書式設定された日付と時刻のタイム ゾーン。

デフォルトは "UTC"です。

  • "GMT"

  • "UTC"

ゲストプロフィールでゲストの生年月日を考慮してください。

{
  "dateOfBirth": "1984-04-15T01:04:00.000Z"
}

この日付を米国英語の日付と時刻の形式に書式設定し、出力に含めるには、Output structureタブのAttribute valueフィールドに次のように入力します。

${formatDateTime(guest.dateOfBirth, "en-US")}

上記の例のゲスト プロファイルの場合、戻り値は "4/15/1984, 3:04:00 AM"になります。

${sha256(値)}

この関数は、SHA-256アルゴリズムを使用して値をハッシュし、データが安全にエクスポートされるようにします。

サイドバー 。 Parameters

パラメーター

種類

形容

例

value

文字列またはそのような文字列を表すオブジェクト属性

エクスポートする前にハッシュ化するデータ。

  • "[email protected]"

  • guest.email

ゲストプロファイルでゲストのメールアドレスについて考えてみます。

{
  "email": "[email protected]"
}

このメールアドレスをハッシュ化して出力に含めるには、「Output structure」タブのAttribute valueフィールドに次のように入力します。

${sha256(guest.email)}

上記の例のゲスト プロファイルの場合、戻り値はハッシュ化され、安全にエクスポートされます。

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

Documentation Assistant

This assistant uses AI to generate responses based on Sitecore documentation. While it has access to official sources, answers may be incomplete or inaccurate and should not be considered official advice or support.
Powered by
k
kapa.ai
Protected by reCAPTCHA

© Copyright 2026, Sitecore A/S or a Sitecore affiliated company.
All rights reserved.

Privacy policySitecore Trust CenterTerms of use