Skip to main content
Sitecore Documentation
  • Learn
  • Downloads
  • Changelog
  • Roadmap
CDPCloud Portal
Sitecore CDP
  • データブラウザ
  • 用語集
  1. JavaScript関数
  1. Sitecore CDP
  3. 視聴者輸出

効用関数

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

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

Output structureタブのフィールドでオーディエンスエクスポートで呼び出せるユーティリティ関数のリストがあります。

${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

`.947Z", "modifiedAt": "2026-05-31T15:`12
`.947Z", "provider": "BXLP", "id": "3bb8fb2092d1" }

}

出力構造タブの****属性値フィールドに以下の項目を入力することで、identifiers.idの値を出力に含めることができます。

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

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

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

${formatDate(date, locale, timezone)}

この機能では、ISO日付を読みやすい日付にフォーマットし、選んだ日付形式を使って調整します。

サイドバー。パラメータ

パラメータ

種類

概要

例

date

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

例えば、ゲストの生年月日や最後に見た日付を変換するためのISO日付です。

  • "1984-04-15T01:04
    .000Z"
  • guest.dateOfBirth
  • guest.lastSeen

locale

弦(BCP 47)

選んだ日付形式を使う地域の言語タグです。

  • "EN-US"
  • "EN-IE"
  • "EN-AU"

timezone

任意

ストリング(タイムゾーンの略称)

フォーマットされた日付を望むタイムゾーンです。

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

  • "GMT"
  • "UTC"

ゲストプロフィールにゲストの生年月日を記入してください:

{ "dateOfBirth": "1984-04-15T01:`04

`.000Z" }

この日付を米国英語の日付形式にフォーマットし、出力に含めるには、出力構造タブの属性値フィールドに以下を入力してください:

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

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

${formatTime(time, locale, timezone)}

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

サイドバー。パラメータ

パラメータ

種類

概要

例

time

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

ISO 日付は変換のために、例えば注文の時間を示します。

  • "1984-04-15T01:04
    .000Z"
  • guest.dateOfBirth
  • guest.lastSeen

locale

弦(BCP 47)

選んだ時間フォーマットを使う地域の言語タグです。

  • "EN-US"
  • "EN-IE"
  • "EN-AU"

timezone

任意

ストリング(タイムゾーンの略称)

フォーマットされた時間帯で入力したいのです。

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

  • "GMT"
  • "UTC"

ゲストプロフィールにゲストの生年月日を記入してください:

{ "dateOfBirth": "1984-04-15T01:`04

`.000Z" }

この日付を米国英語時間のフォーマットにして出力に含めるには、出力構造タブの属性値フィールドに以下を入力してください:

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

上記の例のゲストプロファイルの場合、リターン値は3:04

AM""となります。

${formatDateTime(time, locale, timezone)}

この機能はISO日付を、好きな日付と時間のフォーマットで読みやすくしてくれます。

サイドバー。パラメータ

パラメータ

種類

概要

例

time

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

例えば、ゲストの生年月日・時刻や最後に見た日時などを変換するためのISO日付です。

  • "1984-04-15T01:04
    .000Z"
  • guest.dateOfBirth
  • guest.lastSeen

locale

弦(BCP 47)

選んだ日付と時間のフォーマットを使う地域の言語タグです。

  • "EN-US"
  • "EN-IE"
  • "EN-AU"

timezone

任意

ストリング(タイムゾーンの略称)

フォーマットされた日付と時間を入れたいタイムゾーンです。

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

  • "GMT"
  • "UTC"

ゲストプロフィールにゲストの生年月日を記入してください:

{ "dateOfBirth": "1984-04-15T01:`04

`.000Z" }

この日付を米国英語の日付・時刻形式にフォーマットし、出力に含めるには、出力構造タブの属性値フィールドに以下を入力してください。

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

上記の例のゲストプロファイルの場合、リターン値は3:04

AM""4/15/1984, となります。

${sha256(value)}

この関数はSHA-256アルゴリズムを使って値をハッシュ化し、データの安全なエクスポートを保証します。

サイドバー。パラメータ

パラメータ

種類

概要

例

value

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

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

  • "[email protected]"
  • guest.email

ゲストプロフィールにゲストのメールアドレスを考えてみてください:

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

このメールアドレスをハッシュ化し、出力構造タブの属性値フィールドに以下を入力して出力に含めることができます:

${sha256(guest.email)}

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

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

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

Privacy policySitecore Trust CenterTerms of use
CDPCloud Portal