ドキュメントJourney OptimizerJourney Optimizer ガイド

パーソナライゼーションの追加 build-personalization-expressions

Last update: Mon Mar 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 中級
  • 開発者

パーソナライゼーションエディターは、Journey Optimizer のパーソナライズ機能の中核です。メール、プッシュ、オファーなど、パーソナライゼーションを定義する必要があるすべてのコンテキストで利用できます。

パーソナライゼーションエディターインターフェイスでは、すべてのデータを選択、整理、カスタマイズ、および検証して、コンテンツ用にカスタマイズされたパーソナライゼーションを作成できます。

パーソナライゼーションを追加できる場所

パーソナライゼーションアイコンを追加 アイコンを使用して、すべてのフィールドの Journey Optimizer にパーソナライゼーションを追加できます。

メッセージ

メッセージでは、「件名 フィールドなど、メッセージ内の様々な場所にパーソナライゼーションを追加できます。

コンテンツの他のセクションに追加することもできます。 例えば、 プッシュ通知の場合、パーソナライゼーションは タイトル、本文、カスタムサウンド、バッジ、カスタムデータ フィールドに追加できます。

E メールデザイナー

メールDesigner でメールコンテンツを編集する際に、コンテキストツールバーのアイコンを使用して、テキストブロックや URL にパーソナライゼーションを追加できます。

オファー

オファーの表示域 でテキストタイプのコンテンツを使用する場合、パーソナライゼーションを追加できます。 パーソナライズされたオファーを作成する方法を学ぶ

URL

Journey Optimizerでは、メッセージ内の URL をパーソナライズすることもできます。 パーソナライズされた URL は、プロファイル属性に応じて、受信者を web サイトの特定のページに誘導するか、パーソナライズされたマイクロサイトに誘導します。URL のパーソナライゼーションは、外部リンク、購読解除リンク および オプトアウト のリンクで使用できます。

パーソナライズされた URL のサンプルを参照
  • https://www.adobe.com/users/{{profile.person.name.lastName}}
  • https://www.adobe.com/users?uid={{profile.person.name.firstName}}
  • https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}
  • https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}

{width="50%"}

NOTE
パーソナライゼーションエディターでパーソナライズされた URL を編集する場合、セキュリティ上の理由から、ヘルパー関数とオーディエンスメンバーシップが無効になります。
スペースは、URL 内で使用されるパーソナライゼーショントークンではサポートされていません。

Personalization ソース sources

画面の左側には、パーソナライゼーションのソースを選択できるドメインセレクターが表示されます。利用可能なソースは次のとおりです。

  • プロファイル属性：Adobe Experience Platform データモデル（XDM）ドキュメントに記載のプロファイルスキーマに関連付けられているすべての参照をリストします。
  • オーディエンス：Adobe Experience Platform セグメント化サービスで作成されたすべてのオーディエンスをリストします。セグメント化について詳しくは、こちらを参照してください。
  • オファー決定：特定のプレースメントに関連付けられているすべてのオファーを一覧表示します。配置を選択し、コンテンツにオファーを挿入します。オファーの管理方法に関する詳細なドキュメントについては、この節を参照してください。
  • コンテキスト属性：チャネルアクションアクティビティ（メール、プッシュ、SMS）をジャーニーまたはキャンペーンで使用する場合、イベントやプロパティに関連するコンテキスト属性をパーソナライズに使用できます。コンテキスト属性を活用したパーソナライゼーションの例については、この節を参照してください。
NOTE
コンポジションワークフローを使用して生成されたエンリッチメント属性でオーディエンスをターゲットにしている場合は、これらのエンリッチメント属性を活用してメッセージをパーソナライズできます。オーディエンスのエンリッチメント属性の使用方法を学ぶ

パーソナライゼーションの追加 add

中央のワークスペースは、パーソナライゼーション構文を構築する場所です。 属性を使用してメッセージをパーソナライズするには、左側のナビゲーションパネルで属性を見つけ、「+」ボタンをクリックして式に追加します。

+ アイコンの横にある省略記号メニューを使用すると、各属性の詳細を取得したり、使用頻度の高い属性をお気に入りに追加したりできます。 お気に入りに追加した属性には、左側のナビゲーションパネルの お気に入り メニューからアクセスできます。

さらに、文字列タイプのプロファイル属性が空の場合に表示されるデフォルトの代替テキストを定義できます。これを行うには、属性の横にある省略記号ボタンをクリックし、「代替テキストで挿入」を選択します。プロファイルの属性の値が空の場合にデフォルトで表示するテキストを書き込み、「追加」をクリックします。

次の例では、パーソナライゼーションエディターを使用して、本日が誕生日のプロファイルを選択し、この日に対応する特定のオファーを挿入してカスタマイズを完了します。

式を編集するツール

中央のワークスペースには、パーソナライゼーション式を記述するのに役立つ様々なツールが用意されています。

利用可能なオプションは次のとおりです。

  1. 検索 / 検索と置換：式を検索して、コードの一部を自動的に置換します。

  2. 取り消し / やり直し：最後の操作を取り消し/やり直します。

  3. オートコンプリート：入力中にコードを自動的に提案して完了します。 この機能は、HTMLとテキストのフォーマットでのみ使用でき、プロファイルとコンテキストの属性をサポートしています。 切替スイッチで無効にした場合、エディターは代わりにネイティブのHTML コードのオートコンプリートを提供します。

    {align="center" width="70%" modal="regular"}

  4. HTML / JSON / テキスト: コードのフォーマットを識別します。 これにより、選択した言語に基づいて検証およびオートコンプリート機能を適応させることができます。

  5. Validate：式の構文を確認します。 詳しくは、この節を参照してください。

  6. フラグメントとして保存：式を式フラグメントとして保存します。 詳しくは、この節を参照してください。

  7. フォントサイズ：読みやすくするために、エディター内のコンテンツのフォントサイズを調整します。

  8. ワードラップ：ワードラップを有効または無効にして、長い式を 1 行に表示したり、エディター内で折り返したりできます。 次のようなオプションがあります。

    • オフ （デフォルト） – 単語の折り返しを行いません。 長い線がエディタービューを超えて伸び、水平スクロールが必要な場合。
    • オン - エディターの幅で行を折り返します。
    • ワードラップ列 – 行文字が 80 文字に達すると行を折り返します。
    • 境界付き - エディターの幅または 80 文字のいずれか小さい方で行を折り返します。

ナビゲーションウィンドウでは、パーソナライゼーション式を作成するのに役立つ追加機能を使用できます。

  • ヘルパー関数 - ヘルパー関数を使用すると、データの操作（計算、データのフォーマットやコンバージョン、条件、パーソナライゼーションのコンテキストでの操作など）を実行できます。 使用可能なヘルパー関数について詳しくはこちらを参照

  • お気に入り – お気に入りに追加した属性がこのリストに表示されます。 これにより、最も頻繁に使用する項目にすばやくアクセスできます。 属性をお気に入りに追加するには、「。…」メニューをクリックし、お気に入りに追加 を選択します。

  • 条件 - ライブラリで作成した条件付きルールを活用して、メッセージに動的コンテンツを追加します。 これにより、条件に基づいてメッセージの複数のバリアントを作成できます。 動的コンテンツの作成方法を学ぶ

  • フラグメント – 作成または現在のサンドボックスに保存された式フラグメントを活用します。 フラグメントは、Journey Optimizer キャンペーンおよびジャーニー全体で参照できる、再利用可能なコンポーネントです。この機能を使用すると、複数のカスタムコンテンツブロックを事前に構築し、マーケティングユーザーはそのコンテンツブロックを使用して、改善されたデザインプロセスでコンテンツを迅速に組み立てることができます。 パーソナライゼーションに式フラグメントを使用する方法を学ぶ

パーソナライゼーション式を準備できたら、パーソナライゼーションエディターで検証する必要があります。詳しくは、この節を参照してください。

検証メカニズム validation-mechanisms

「追加」ボタンをクリックしてエディターウィンドウを閉じると、式の検証は自動的に実行されます。 「検証」ボタンを使用して、パーソナライゼーション構文を確認することもできます。

以下のセクションを展開して、パーソナライゼーションの検証時に発生する可能性のある一般的なエラーを確認します。

一般的なエラー
  • パス「XYZ」が見つかりません

スキーマで定義されていないフィールドを参照しようとしたとき。

この場合、firstName1 は、プロファイルスキーマの属性として定義されていません。

code language-none 
{{profile.person.name.firstName1}}
  • 変数「XYZ」のタイプが一致しません。予想される配列です。文字列が見つかりました。

配列ではなく文字列を反復処理する場合。

この場合、product は配列ではありません。

code language-none 
{{each profile.person.name.firstName as |product|}}
 {{product.productName}}
{{/each}}
  • ハンドルバー構文が無効です。‘[XYZ}}’ が見つかりました

無効なハンドルバー構文が使用される場合。

ハンドルバー式は {{expression}} で囲まれます

code language-none 
   {{[profile.person.name.firstName}}
  • 無効なセグメント定義
code language-none 
No segment definition found for 988afe9f0-d4ae-42c8-a0be-8d90e66e151

オファーの場合、特定のエラーが発生する場合があります。 詳細については、以下のセクションを展開してください。

オファーに関連する特定のエラー

メールまたはプッシュメッセージ内のオファー統合に関連するエラーは、次のパターンになります。

code language-none 
Offer.<offerType>.[PlacementID].[ActivityID].<offer-attribute>

検証は、パーソナライゼーションエディターでのパーソナライゼーションコンテンツの検証中に実行されます。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
エラータイトル 検証／解決
ID が placementID でタイプが OfferPlacement のリソースが見つかりません
IDが activityID でタイプが OfferActivity のリソースが見つかりません		 ActivityID または PlacementID、あるいはその両方が使用可能かどうかを確認します
リソースを検証できませんでした。 プレースメントの componentType は、offerType オファーと一致する必要があります
オファー offerId にパブリック URL が存在しません。 画像オファー（決定とプレースメントのペアに関連付けられたすべてのパーソナライズオファーおよびフォールバック）には、パブリック URL を入力する必要があります（deliveryURL を空にすることはできません）。
決定にプロファイル以外の属性が含まれています。 オファーモデルの使用には、プロファイル属性のみを含める必要があります。
決定の使用状況の取得中にエラーが発生しました。 このエラーは、API がオファーモデルを取得しようとしているときに発生する可能性があります。
オファー属性 offer-attribute が無効です。 オファー drp で参照されている offer-attribute が有効かどうかを確認します。有効な属性は次のとおりです。
画像：deliveryURL, linkURL
テキスト：content
HTML：content
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76