よくある質問

このページでは、Liquidに関するよくある質問への回答を見つけることができます。

Brazeは現在、ShopifyのLiquidの100%をサポートしているわけではなく、ドキュメントで概説しようとした特定の部分のみをサポートしています。すべてのメッセージを送信する前にLiquidを使用してテストすることを強くお勧めします。これにより、エラーのリスクやサポートされていないLiquidの使用を減らすことができます。

Braze で Liquid スニペットを使用するにはどうすればよいですか?

多くの場合、キャンペーンやキャンバスに移動し、パーソナライゼーションモーダルのメールメッセージ本文やセグメントなどの領域にLiquidを挿入することで、Liquidスニペットを組み込むことができます。

もっと詳しく知るにはどこで学べますか？

Liquid の詳細については、Braze ラーニングのガイド付きパス「Liquid を使用したダイナミックなパーソナライゼーション」を参照してください。また、インスピレーションやLiquidを使用したさまざまなパーソナライゼーションの例については、Liquidユースケースライブラリーを参照することもできます。

Liquid とコネクテッドコンテンツをパーソナライゼーションに使用する場合の違いは何ですか?

Braze コネクテッドコンテンツは Liquid タグの一例です。これはパーソナライゼーションにも使用されますが、このデータは Braze 内の保存データではなく、外部のエンドポイントから取得されます。専用のコネクテッドコンテンツセクションをご覧になり、メッセージのパーソナライズ方法を拡張する方法について詳しく学んでください。

Liquid テンプレートとは何ですか?

これは、Braze で Liquid を使用する最も一般的な方法です。Liquid テンプレートでは、ユーザーのプロファイルからデータをメッセージに引き出します。このデータは、ユーザーの名からイベントトリガーメッセージのカスタムイベントまで多岐にわたっています。

サポートされているパーソナライゼーションタグの完全なリストについては、サポートされているLiquidタグを参照してください。

Liquidで変数をどのように割り当てますか？

assignタグを使用して変数を作成および割り当てることができます。これにより、メッセージ作成画面で変数が作成され、メッセージ全体で参照できるようになります。

Liquidはログデータポイントを使用するのか？

いいえ。

Liquid を使用してパーソナライズされた挨拶を送信するにはどうすればよいですか?

パーソナライズされた挨拶にユーザーの名を使用する場合、標準的なユーザープロファイル属性を {{${first_name}}}、{{${last_name}}}のように取得することができます。

Liquidを使用して、曜日やカスタム属性などに基づいて条件付きレンダリングを行う{% if X %} ステートメントを使用することもできます。サポートされているLiquid演算子の条件文で使用できる演算子の詳細については、演算子をチェックしてください。

顧客の所在地に基づいてメッセージをパーソナライズするにはどうすればよいですか？

ユーザーの位置情報にはデフォルトの属性があります: {{${most_recent_location}}}。

{{campaign.${name}}}と{{campaign.${message_name}}}の違いは何ですか？

両方{{campaign.${name}}}と{{campaign.${message_name}}}はサポートされているLiquidパーソナライゼーションタグです。両方のタグはキャンペーン属性を参照しています。{{campaign.${name}}}はキャンペーンの名前を示し、{{campaign.${message_name}}}はメッセージバリアントの名前を示します。

Liquidをネストされたオブジェクトでどのように使用しますか？

Brazeには、メッセージで使用できるセグメントのLiquidコードを生成する組み込み機能があります。具体的には、オブジェクト内の複数の基準に一致するSegmentを作成できます。

詳細については、マルチ基準セグメンテーションをご覧ください。

イベント属性を使用して、イベントがトリガーしているメッセージをどのようにパーソナライズしますか？

API トリガーイベントのプロパティにアクセスするには、api_triggered_property タグ: {{api_trigger_properties.${attribute_key}}} を使用できます。

中止ロジックとは何ですか、それをどのように使用できますか？

中止ロジックにより、条件が満たされている場合、メッセージの送信を停止できます。これは、未完成のメッセージがユーザーに送信されるのを防ぐのに特に役立ちます。マーケティングキャンペーンにおける中止ロジックの例については、メッセージの中止をお読みください。

ループロジックとは何ですか、それはどのように使用できますか?

For loops are also known as 反復タグ.Liquid スニペットで for ループロジックを使用すると、条件が満たされるまで Liquid のブロックを反復実行できます。

Braze では、これは配列のカスタム属性、またはカタログ、セレクション、またはコネクテッドコンテンツの呼び出し応答によって返される値やオブジェクトのリストをチェックするために使用できます。具体的には、メッセージングの一環としてforループロジックを使用して、製品が在庫にあるかどうか、または製品が最低評価を持っているかどうかを確認できます。

例えば、「ゲーム」というカタログがあり、その中に「ゲームタイトル」という選択項目があると”cheap_games”.しよう。このカタログ内のゲームタイトルを取得するには、次のLiquidスニペットを使うことができる”cheap_games”,：

1
2
3
4
{% catalog_selection_items Games cheap_games %}
{% for item in items %}
 Get this game: {{ item.title }}
{% endfor %}

設定された条件が満たされると、メッセージを進めることができます。さまざまな条件で Liquid ブロックを繰り返す代わりに、このロジックを使用すると、時間を節約できて便利です。

コンテンツブロックを使ったメッセージに余分なスペースが入るのはなぜだ？

送信したメッセージに、Liquidを使用したコンテンツブロックで余分なスペースが生じている場合、条件分岐文内に不要な段落や改行が含まれている可能性がある。条件文は複数行にまたがらず、1行で記述せよ。

例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% if {{custom_attribute.${has_discount}}} == true %}Discounted Item{% elsif {{custom_attribute.${is_new_arrival}}} == true %}New Arrival{% else %}Regular Item{% endif %}


### When should I use `assign` versus `capture`?

Both `assign` and `capture` create Liquid variables, but they serve different purposes:

- `assign` is for simple variables that store a single value, such as a boolean, number, or simple string. You can also apply a single filter in the same line.
- `capture` is for storing a block of text that may include multiple variables, strings, or complex expressions. Use `capture` when the value is too complex for a single `assign` statement, such as URLs that utilize other Liquid variables or custom attributes as parameters. `capture` is also preferred when implementing Liquid variables in the body of Connected Content calls.

#### Examples


```liquid
{% comment %} Valid assign usage {% endcomment %}
{% assign name = {{custom_attribute.${first_name}}} %}
{% assign price = {{custom_attribute.${price}}} | plus: 0 %}

{% comment %} Use capture for complex strings {% endcomment %}
{% capture greeting %}Hello, {{custom_attribute.${first_name}}}! Your order #{{custom_attribute.${order_id}}} is ready.{% endcapture %}
{{ greeting }}