プロパティを使用したパーソナライズ

プロパティ（ユーザー Tags や External ID などの識別子）を使用して、Liquid 構文でメッセージや配信ペイロードをパーソナライズできます。 OneSignal は Liquid プレースホルダーを送信時にレンダリングし、ユーザー、Subscriptions、Journey、メッセージ、テンプレート、アプリ、または組織に既に保存されているデータを使用します。このデータを使用して、メッセージ、Journey Webhook、および Event Streams をパーソナライズできます。

プロパティパーソナライズの使用タイミング

プロパティパーソナライズを使用して、OneSignal に既に存在するデータ（最も一般的にはユーザー Tags、External ID、メールアドレスや電話番号などの Subscriptions フィールド）を使用して送信時にコンテンツをレンダリングします。以下の場合に適しています：

データが既に OneSignal に保存されている
メッセージ送信時に Liquid プレースホルダーが自動的に置き換えられるようにしたい
配信時にデータを取得または計算する必要がない

値を送信時に取得または計算する必要がある場合（例：リアルタイムの価格や在庫）は、Data Feeds または custom_data を使用した API を使用してください。値が、ユーザーが Journey に入るまたは進行するきっかけとなったイベントから取得される場合は、Custom Event パーソナライズを使用してください。

チャネルサポート

各チャネルは特定のプロパティタイプとフィールドをサポートしています。

メール
プッシュ
SMS
アプリ内メッセージ
ライブアクティビティ

以下でユーザーと Subscriptions のプロパティをサポートしています：

件名、返信先、プリヘッダー
メッセージ本文
HTML 属性（例：<img src="{{ image_url }}" />）
ボタンアクション（URL、mailto など）

以下でユーザーと Subscriptions のプロパティをサポートしています：

タイトル（headings）、サブタイトル、本文（contents）
画像 URL
起動 URL：https://example.com/{{last_category_viewed}}

data（追加データ）フィールドは Liquid 構文をサポートしていません。

以下でユーザーと Subscriptions のプロパティをサポートしています：

メッセージ本文（contents）

Tag 置換のみサポートされています。プロパティ、Custom Events、その他のデータソースは現時点では利用できません。

Tags はユーザーが新しいアプリセッションを開始する前に設定されている必要があります。
テスト送信フローを使用する場合、Tag 置換が表示されないことがあります。

ブロックエディタ： テキスト、ボタン、画像ブロック HTML エディタ： テキスト要素と属性（src、href、action、data）

以下でユーザーと Subscriptions のプロパティをサポートしています：

event_updates
contents
headings

プロパティパーソナライズの仕組み

OneSignal は、メッセージ送信先のユーザーと Subscriptions に対応するプロパティ値で Liquid プレースホルダーを置き換えます。

Liquid

Hi {{ first_name | default: "friend" }}!
Congrats on reaching level {{ level | default: "1" }}!

ユーザーが Tags first_name: Jon と level: 5 を持っている場合、以下のように表示されます：

Text

Hi Jon!
Congrats on reaching level 5!

Tags が設定されていないユーザーには、代わりにデフォルト値が表示されます。

プロパティ Liquid オブジェクトリファレンス

このセクションでは、Liquid で使用可能な正確なオブジェクト名とフィールド名を確認できます。

ユーザーと Subscriptions のプロパティ

ユーザーレベルのデータには user を使用します。メールアドレスや電話番号などのチャネル固有の値が必要な場合は subscription を使用します。

user.tags

ユーザーの Tags。Tags はいくつかの方法で参照できます：

key を直接使用するか、tags の後にキーを配置します
設定された Tags の例：first_name: Jon, level: 5

Liquid

Your first name is {{ first_name }}.
Your first name is {{ user.tags.first_name }}.
Your level is {{ level }}.
Your level is {{ user.tags.level }}.

for ループ構文で Tags を反復処理できます。この例では、key:value ペアをカンマ区切りで出力します。

Liquid

{% for tag in user.tags %}
{{ tag[0] }}: {{ tag[1] }}
{% unless forloop.last %},
{% endunless %}{% endfor %}

user.external_id

ユーザーの External ID。

Liquid

Your user ID is {{ user.external_id }}.
Your user ID is {{ subscription.external_id }}.

user.onesignal_id

ユーザーの OneSignal ID。

Liquid

Your OneSignal user ID is {{ user.onesignal_id }}.

subscription.email

メッセージが送信されるメール Subscription のメールアドレス。

Liquid

Thanks for subscribing with email {{ subscription.email }}.

subscription.phone_number

メッセージが送信される SMS Subscription の電話番号。

Liquid

Thanks for subscribing with phone number {{ subscription.phone_number }}.

user.language

ユーザーの言語コード。

Liquid

Preferred language: {{ user.language }}
Preferred language: {{ subscription.language }}

user.subscriptions

ユーザーの Subscriptions。

for ループ構文で Subscriptions を反復処理できます。
この例では、各 Subscription のトークンと ID をカンマ区切りで出力します。

JSON

{
  "subscriptions": "{% for subscription in user.subscriptions %}{% if subscription.subscription_token %}{{ subscription.subscription_token }}: {{ subscription.id }}{% unless forloop.last %}, {% endunless %}{% endif %}{% endfor %}"
}

subscription.unsubscribe_token

トークンを使用したメール配信停止 API で使用されるトークン。

Unsubscribe: https://your-domain.com/unsubscribe?token={{ subscription.unsubscribe_token }}

Journey プロパティ

journey オブジェクトを使用して、Journey 名を参照したり、Journey の Custom Event パーソナライズにアクセスしたりできます。

journey.name

Journey の名前。

JSON

{
  "journey_name": "{{ journey.name }}"
}

メッセージプロパティ

message オブジェクトは、Event Streams に役立つメッセージ ID、名前、テンプレート ID へのアクセスを提供します。また、バックエンドから送信されるメッセージをパーソナライズするための custom_data へのアクセスも提供します。

message.id

OneSignal によって設定されたメッセージ ID。

{
  "message_id": "{{ message.id }}"
}

message.name

送信者によって設定されたメッセージの名前。

{
  "message_name": "{{ message.name }}"
}

message.template_id

OneSignal によって設定されたテンプレート ID。

{
  "template_id": "{{ message.template_id }}"
}

テンプレートプロパティ

template オブジェクトは、メッセージの送信に使用されたテンプレートのテンプレート ID と名前へのアクセスを提供します。これは Event Streams に役立ちます。

template.id

OneSignal によって設定されたテンプレート ID。

{
  "template_id": "{{ template.id }}"
}

template.name

送信者によって設定されたテンプレートの名前。

{
  "template_name": "{{ template.name }}"
}

アプリと組織のプロパティ

app および org オブジェクトは、メッセージを送信したアプリと組織の詳細を提供します。これは Event Streams に役立ちます。

app.id

OneSignal によって設定されたアプリ ID。

{
  "app_id": "{{ app.id }}"
}

app.name

アプリのオーナーによって設定されたアプリの名前。

{
  "app_name": "{{ app.name }}"
}

org.id

OneSignal によって設定された組織 ID。

{
  "org_id": "{{ org.id }}"
}

org.name

組織のオーナーによって設定された組織の名前。

{
  "org_name": "{{ org.name }}"
}

例：Tags を使用したカート放棄

この例では、ユーザー Tags を使用してカート放棄メッセージをパーソナライズする方法を説明します。カート放棄チュートリアルをベースにしています。 設定された Tags の例：

JSON

{
  "cart_updated": "unix_timestamp_seconds",
  "product_image": "https://i.imgur.com/ssPCfbC.png",
  "product_name": "24 Pack of Acorns",
  "product_quantity": "1",
  "product_price": "$12.99",
  "cart_items_count": "4",
  "cart_url": "https://yourdomain.com/cart"
}

メールテンプレート

新しいメールテンプレートを作成する

Messages > Templates > New Email Template に移動し、ドラッグ＆ドロップエディタを開きます。

レイアウト構造を追加する

5つの行を作成します：

行1、2、4：Paragraph ブロックを含む1列
行3：HTML | Paragraph | Paragraph | Paragraph の4列
行5：Button ブロックを含む1列

Paragraph ブロックに Liquid を追加する

行1に以下を追加します：

Liquid

We're holding onto {{cart_items_count}} items in your cart, but don't wait too long, other squirrels are getting ahead!

行2にユーザーが見ている内容の説明を追加します：

Text

Currently in your cart:

行4に別の CTA を追加します：

Text

Checkout now while supplies last!

最新のアイテムを表示する

行3で4列を設定します：列1（HTML ブロック）：

HTML

<img src="{{product_image}}" alt="Image" style="max-width:100%;" />

列2〜4（テキストブロック）：

列2：{{product_name}}
列3：{{product_quantity}}
列4：{{product_price}}

ボタンにカート URL を追加する

行5の Button ブロックで、アクション URL を以下に設定します：

{{cart_url}}

テンプレートをテスト・プレビューする

Test & preview ボタンを使用して自分宛にテストメールを送信します。

メール Subscription に Tags が設定されていることを確認してください。

テンプレートにスタイルを適用する

成功です！これで独自のスタイルをテンプレートに適用できます。ドラッグ＆ドロップでメールをデザインするを参照してください。

プッシュテンプレート

プッシュ通知はスペースが限られているため、1つのアイテムを表示し、合計数に言及します。 メッセージフィールド： 条件文を使用して、正しい文法でアイテムとアイテム数を表示します。

Liquid

{% assign item_count = cart_items_count | plus: 0 %}
{% if item_count == 1 %}
You left {{product_name}} in your cart.
{% endif %}
{% if item_count == 2 %}
You left {{product_name}} and {{item_count | minus: 1}} more item in your cart.
{% endif %}
{% if item_count > 2 %}
You left {{product_name}} and {{item_count | minus: 1}} more items in your cart.
{% endif %}

画像フィールド：

Liquid

{{product_image | default: "https://i.imgur.com/ssPCfbC.png"}}

起動 URL フィールド：

{{cart_url | default: "https://yourdomain.com/cart"}}

Test & preview でプッシュテンプレートのパーソナライズをプレビュー

成功です！これでさらにテンプレートを作成し、カート放棄 Journey で使用できます。

例：データタグでアプリ内メッセージをパーソナライズする

この例では、データタグでパーソナライズされたリワードアプリ内メッセージを示します。アプリ内メッセージは、データタグの値を複数のブロックタイプに置換します。設定されたメッセージ：

テキストブロック — 完了したレベルとそのレベルのリワードを表示
画像ブロック — そのリワードに対応する画像と、デフォルト画像をフォールバックとして表示
ボタン2テキスト — リワード値を表示し、デフォルト値は 100
背景画像 — データタグの値から設定

テキスト、画像、ボタンブロックでデータタグ置換が設定されたアプリ内メッセージエディター

メッセージはセッション開始時に、ユーザーの現在のデータタグ値を使用してレンダリングされます：

サポートされているブロック、属性、タイミングルールについては、上記のチャネルサポートのアプリ内メッセージタブを参照してください。そこから改めて強調すべき2つのポイント：

データタグは、ユーザーが新しいアプリセッションを開始する前に設定する必要があります。 セッション中に更新されたデータタグは、そのセッション中に表示されるアプリ内メッセージではレンダリングされません。
データタグ置換は「テストメッセージを送信」のテスト送信ではレンダリングされません。 置換を確認するには、実際のセッションからメッセージをトリガーしてください。
プロパティ置換はアプリ内メッセージではサポートされていません。

メッセージパーソナライズ

Custom Events とその他の方法の使い分けを含む、OneSignal のすべてのパーソナライズオプションの概要。

Liquid 構文の使用

フィルター、条件分岐、ループ、文字列操作を含む完全な Liquid リファレンス。

Templates

Journeys で使用する再利用可能なメッセージテンプレートを作成・管理します。

カート放棄チュートリアル

Tags とプロパティを使用してカート放棄 Journey を構築します。

サポートが必要ですか？サポートチームとチャットするか、support@onesignal.comにメールしてください以下を含めてください：

発生している問題の詳細と再現手順（利用可能な場合）
OneSignal App ID
該当する場合は、External IDまたはSubscription ID
該当する場合は、OneSignalダッシュボードでテストしたメッセージのURL
関連するログまたはエラーメッセージ

お気軽にお問い合わせください！

はじめに & 設定

メッセージングチャネル

ジャーニー

オーディエンス & カスタムイベント

分析 & 統合

プライバシー & セキュリティ

プロパティを使用したパーソナライズ

プロパティパーソナライズの使用タイミング

チャネルサポート

プロパティパーソナライズの仕組み

Tags が設定されていないユーザーには、代わりにデフォルト値が表示されます。

プロパティ Liquid オブジェクトリファレンス

ユーザーと Subscriptions のプロパティ

Journey プロパティ

メッセージプロパティ

テンプレートプロパティ

アプリと組織のプロパティ

例：Tags を使用したカート放棄

メールテンプレート

プッシュテンプレート

例：データタグでアプリ内メッセージをパーソナライズする

関連ページ

メッセージパーソナライズ

Tags

Liquid 構文の使用

Templates

カート放棄チュートリアル

​プロパティパーソナライズの使用タイミング

​チャネルサポート

​プロパティパーソナライズの仕組み

​Tags が設定されていないユーザーには、代わりにデフォルト値が表示されます。

​プロパティ Liquid オブジェクトリファレンス

​ユーザーと Subscriptions のプロパティ

​Journey プロパティ

​メッセージプロパティ

​テンプレートプロパティ

​アプリと組織のプロパティ

​例：Tags を使用したカート放棄

​メールテンプレート

​プッシュテンプレート

​例：データタグでアプリ内メッセージをパーソナライズする

​関連ページ

メッセージパーソナライズ

Tags

Liquid 構文の使用

Templates

カート放棄チュートリアル

プロパティパーソナライズの使用タイミング

チャネルサポート

プロパティパーソナライズの仕組み

Tags が設定されていないユーザーには、代わりにデフォルト値が表示されます。

プロパティ Liquid オブジェクトリファレンス

ユーザーと Subscriptions のプロパティ

Journey プロパティ

メッセージプロパティ

テンプレートプロパティ

アプリと組織のプロパティ

例：Tags を使用したカート放棄

メールテンプレート

プッシュテンプレート

例：データタグでアプリ内メッセージをパーソナライズする

関連ページ