--- title: "効用関数" slug: "utility-functions" abstract: "Sitecore CDPでオーディエンスをエクスポートするための便利なユーティリティ機能。" --- # 効用関数 **Output structure**タブのフィールドで[オーディエンスエクスポートで呼び出](https://doc.sitecore.com/cdp/ja/users/sitecore-cdp/audience-export/javascript-in-the-export.html#UUID-e0fcc0c5-b3e4-cbab-1a1c-81f5c3fee3e4_section-idm4642469535550433964492091815 "Calling utility functions")せるユーティリティ関数のリストがあります。 ## ${concat(separatorString, firstString, secondString)} この関数は、2本目の文字列を1本目の列の末尾に付け加えて作成した文字列を返します。2つの文字列の間に区切り文字列を指定することもできます。 サイドバー。パラメータ パラメータ 種類 概要 例 separatorString ストリング 第一弦と第二弦の間に繋がる弦です。 区切り文字列を使わない場合は、この値を空文字列 ""に設定します。 - "+" - "-" - "" firstString 文字列またはオブジェクト属性を表す文字列 連結された文字列の先頭に置く文字列です。 - "IE" - guest.country secondString 文字列またはオブジェクト属性を表す文字列 連結された文字列の末尾に置く文字列です。 - "Dublin" - guest.city ゲストプロフィールでゲストの国と都市を考慮してください: { "country": "IE", "city": "Dublin" } 国と都市の値を連結し、出力の条件欄に以下の入力を入れることで、連結された文字列を出力に含めることができます。 ${concat("\_", guest.country, guest.city)} 上記の例のゲストプロファイルの場合、返還値は "IE\_Dublin"となります。 ## ${getDataExtension(extObj, extName, extKey, fallback)} この関数はゲストプロファイルで利用可能なデータ拡張値を返します。 サイドバー。パラメータ パラメータ 種類 概要 例 extObj 目的 ゲストプロファイル内のデータ拡張オブジェクトへの参照。 この値を guest.dataExtensionsに設定しなければなりません。 guest.dataExtensions extName ストリング 拡張機能名です。 "ext1" extKey ストリング 出力に含めたい値の拡張キーです。 "MemberCardCategory" fallback 任意 ストリング ゲストプロファイルに拡張機能が存在しない場合、そのフォールバック値も出力に含めるべきです。 "not-available" 例4。例:の値へのアクセス MemberCardCategory 以下のデータ拡張オブジェクトを持つゲストプロファイルを考えてみましょう: { "dataExtensions": { "name": "ext1", "values": { "MemberCardCategoryRenewalDate": "18/05/2026", "MemberCardBalance": 22000, "MemberCardType": "shop&miles", "MemberCardCategory": "premium", "MilesRequiredForMemberCardCategory": 3000 } } } 出力**構造タブの****属性値**フィールドに以下を入力して、MemberCardCategoryの値にアクセスし、出力に含めることができます: ${getDataExtension(guest.dataExtensions, "ext1", "MemberCardCategory", "not-available")} 上記の例のゲストプロファイルの場合、返還値は "premium"となります。 このデータ拡張を持たないゲストプロファイルの場合、返される値は "not-available"となります。 ## ${getIdentifier(identifiersObj, provider, fallback)} この機能はゲストプロフィールに利用可能な場合、ゲストの識別子IDを返します。 サイドバー。パラメータ パラメータ 種類 概要 例 identifiersObj オブジェクトの配列 ゲストプロファイル内の識別子オブジェクトへの参照。 この値を guest.identifiersに設定しなければなりません。 guest.identifiers provider ストリング あなたの組織のアイデンティティシステムの名前で、Sitecore CDPの外部で、一意のゲスト識別子を提供している。 "BXLP" fallback 任意 ストリング ゲストプロファイルにこれらの識別子が存在しない場合、そのフォールバック値は出力に含めるべきです。 "not-available" ゲストプロフィールでゲストのidentifiers物の配列を考えてみましょう: { "identifiers": { "ref": "3d67f887-9e6f-55c7-9390-027e3fff5595", "createdAt": "2026-05-31T15:\`12:22\`.947Z", "modifiedAt": "2026-05-31T15:\`12:22\`.947Z", "provider": "BXLP", "id": "3bb8fb2092d1" } } 出力**構造タブの****属性値**フィールドに以下の項目を入力することで、identifiers.idの値を出力に含めることができます。 ${getIdentifier(guest.identifiers, "BXLP", "not-available")} 上記の例のゲストプロファイルの場合、返還値は "3bb8fb2092d1"となります。 これらの識別子を持たないゲストプロファイルの場合、返り値は "not-available"となります。 ## ${formatDate(date, locale, timezone)} この機能では、ISO日付を読みやすい日付にフォーマットし、選んだ日付形式を使って調整します。 サイドバー。パラメータ パラメータ 種類 概要 例 date 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))またはそのような文字列を表すオブジェクト属性 例えば、ゲストの生年月日や最後に見た日付を変換するためのISO日付です。 - "1984-04-15T01:04:00.000Z" - guest.dateOfBirth - guest.lastSeen locale 弦([BCP 47](https://www.techonthenet.com/js/language_tags.php)) 選んだ日付形式を使う地域の言語タグです。 - "EN-US" - "EN-IE" - "EN-AU" timezone 任意 ストリング([タイムゾーンの略称](https://www.timeanddate.com/time/zones/)) フォーマットされた日付を望むタイムゾーンです。 デフォルトは "UTC"です。 - "GMT" - "UTC" ゲストプロフィールにゲストの生年月日を記入してください: { "dateOfBirth": "1984-04-15T01:\`04:00\`.000Z" } この日付を米国英語の日付形式にフォーマットし、出力に含めるには、**出力**構造タブの**属性値**フィールドに以下を入力してください: ${formatDate(guest.dateOfBirth, "en-US")} 上記の例のゲストプロファイルの場合、返還値は "4/15/1984"となります。 ## ${formatTime(time, locale, timezone)} この関数はISO日付を読みやすい時間にフォーマットし、選んだ時間形式を使います。 サイドバー。パラメータ パラメータ 種類 概要 例 time 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))またはそのような文字列を表すオブジェクト属性 ISO 日付は変換のために、例えば注文の時間を示します。 - "1984-04-15T01:04:00.000Z" - guest.dateOfBirth - guest.lastSeen locale 弦([BCP 47](https://www.techonthenet.com/js/language_tags.php)) 選んだ時間フォーマットを使う地域の言語タグです。 - "EN-US" - "EN-IE" - "EN-AU" timezone 任意 ストリング([タイムゾーンの略称](https://www.timeanddate.com/time/zones/)) フォーマットされた時間帯で入力したいのです。 デフォルトは "UTC"です。 - "GMT" - "UTC" ゲストプロフィールにゲストの生年月日を記入してください: { "dateOfBirth": "1984-04-15T01:\`04:00\`.000Z" } この日付を米国英語時間のフォーマットにして出力に含めるには、**出力**構造タブの**属性値**フィールドに以下を入力してください: ${formatTime(guest.dateOfBirth, "en-US")} 上記の例のゲストプロファイルの場合、リターン値は3:04:00 AM""となります。 ## ${formatDateTime(time, locale, timezone)} この機能はISO日付を、好きな日付と時間のフォーマットで読みやすくしてくれます。 サイドバー。パラメータ パラメータ 種類 概要 例 time 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601))またはそのような文字列を表すオブジェクト属性 例えば、ゲストの生年月日・時刻や最後に見た日時などを変換するためのISO日付です。 - "1984-04-15T01:04:00.000Z" - guest.dateOfBirth - guest.lastSeen locale 弦([BCP 47](https://www.techonthenet.com/js/language_tags.php)) 選んだ日付と時間のフォーマットを使う地域の言語タグです。 - "EN-US" - "EN-IE" - "EN-AU" timezone 任意 ストリング([タイムゾーンの略称](https://www.timeanddate.com/time/zones/)) フォーマットされた日付と時間を入れたいタイムゾーンです。 デフォルトは "UTC"です。 - "GMT" - "UTC" ゲストプロフィールにゲストの生年月日を記入してください: { "dateOfBirth": "1984-04-15T01:\`04:00\`.000Z" } この日付を米国英語の日付・時刻形式にフォーマットし、出力に含めるには、**出力**構造タブの**属性値**フィールドに以下を入力してください。 ${formatDateTime(guest.dateOfBirth, "en-US")} 上記の例のゲストプロファイルの場合、リターン値は3:04:00 AM""4/15/1984, となります。 ## ${sha256(value)} この関数は[SHA-256](https://en.wikipedia.org/wiki/SHA-2)アルゴリズムを使って値をハッシュ化し、データの安全なエクスポートを保証します。 サイドバー。パラメータ パラメータ 種類 概要 例 value そのような文字列を表す文字列またはオブジェクト属性 エクスポート前にデータをハッシュ化します。 - "jane.doe@myretailsite.com" - guest.email ゲストプロフィールにゲストのメールアドレスを考えてみてください: { "email": "jane.doe@myretailsite.com" } このメールアドレスをハッシュ化し、出力構造タブの**属性値**フィールドに以下を入力して出力に含めることができます: ${sha256(guest.email)} 上記の例のゲストプロファイルでは、返還値はハッシュ化され、安全にエクスポートされます。