CSVを使用したダイナミックコンテンツ

• CSVを使用して大規模にパーソナライズ – 1つのメッセージ、すべての人にカスタムエクスペリエンス
• 多言語サポート – ユーザーごとに自動的に言語を切り替え
• ダイナミックパーソナライゼーション – コンテンツはユーザープロパティ（言語、地域、キャンペーンID）に適応
• チームコラボレーション – 非技術ユーザーがCSVファイルでコンテンツを編集
• HTML インジェクション（メール） – CSVセルにHTMLマークアップを含めて、リッチなメールコンテンツを動的に構築
• クロスチャネル互換性 – チャネル全体でCSVロジックを再利用

• 多言語オンボーディングまたはマーケティング
• 地域固有のプロモーション
• 場所ごとのイベント発表
• キャンペーンベースのパーソナライゼーション

​

CSVを使用したダイナミックコンテンツのセットアップ手順

1. コンテンツのバリエーションを含むCSVファイルを作成します。
2. Liquid構文のdynamic_contentプロパティを使用してCSVデータをメッセージにマッピングします。
3. OneSignalダッシュボードから新しいメッセージまたはテンプレートを作成します。
4. Dynamic ContentまたはPersonalizationボタンを選択します。
5. CSVファイルをアップロードしてメッセージを送信します。

​

CSV要件と設定

• ファイルサイズ： 200 KB未満
• 列ヘッダー：
  • タグキーの最初の列ヘッダーを予約するか、セクションを参照するために空白のままにします
  • 英数字と下線のみ
  • スペースの代わりに下線（_）を使用します
• エンコーディング： UTF-8

• 多言語 – 言語ごとにコンテンツをローカライズ
• コンテンツパーソナライゼーション – データタグごとにコンテンツをカスタマイズ

​

CSVの例

• 多言語テンプレートの例
• コンテンツパーソナライゼーションテンプレートの例

• 列ヘッダーをサポートされている言語コードにマッピングします。
• 各言語コードの各行に翻訳を追加します。
• 複数のセクション（メールなど）がある場合は、最初の列をセクション名として指定します。

この例には以下が含まれます：

• 3つの言語：英語、スペイン語、フランス語。
• 2つのセクション：「section_1」と「section_2」。

• 最初の列ヘッダーをタグキーにマッピングし、基礎となる行を参照する値にマッピングします。ユーザーにタグを追加する方法の詳細については、タグを参照してください。
• 残りの列ヘッダーをパーソナライズするセクションまたはコンポーネントにマッピングします。

この例では：

• タグキーはcampaign_idで、可能な値はAとBです。
• 3つのコンポーネントがあります：「title」、「message」、「url」。

重要： CSVヘッダーからスペースと非英数字文字を削除するか、 Liquidでハッシュ表記を使用してください。

​

CSVデータをメッセージコンテンツにマッピングする

<!-- オプション1：コンポーネントから先にアクセス -->
{{dynamic_content.file_name.message_component[user_property]}}

<!-- オプション2：ユーザープロパティから先にアクセス -->
{{dynamic_content.file_name[user_property].message_component}}

• dynamic_content – CSVデータを参照するために使用されるプロパティ名
• file_name – CSVファイル名（.csv拡張子なし）
• message_component – パーソナライズする特定のメッセージコンポーネント。これは、CSV列ヘッダーまたは最初の行の静的テキストです。
• user_property – 参照するユーザープロパティ。

{{ dynamic_content.my_template.header[user.language] | default: "最新の更新へようこそ" }}

• 利用可能な場合はダイナミックコンテンツが使用されます
• ダイナミックコンテンツが失敗した場合はハードコードされたメッセージが表示されます
• ユーザーが空白のコンテンツを受け取ることはありません

• 多言語メッセージの例
• コンテンツパーソナライゼーションメッセージの例

translations.csv

,en,es,fr
section_1,Hello,Hola,Bonjour
section_2,Thanks for shopping with us...,Gracias por comprar con nosotros...,Merci pour votre achat avec nous...

• file_nameはtranslations.csvです。
• message_componentは最初の列の行section_1とsection_2にあります。
• user_propertyは言語コードに一致する列ヘッダーです。user.languageプロパティを使用してユーザー上でこれを参照できます。

多言語メッセージの基本的なLiquid構文

{{dynamic_content.translations.section_1[user.language]}}
{{dynamic_content.translations.section_2[user.language]}}

（推奨）デフォルトフォールバック付き多言語メッセージのLiquid構文

{% assign supported_langs = "en,es,fr,de" | split: "," %}
{% assign lang = user.language | default: "en" %}

{% unless supported_langs contains lang %}
  {% assign lang = "en" %}
{% endunless %}

{{ dynamic_content.translations.section_1[lang] | default: "Hello" }}
{{ dynamic_content.translations.section_2[lang] | default: "Thanks for shopping with us..." }}

content_personalization_template.csv

campaign_id,title,message,url
campaign_123,Flash deal for you,Tap to claim,https://example.com/flash
campaign_456,Weekend picks are here,See what's trending,https://example.com/weekend
default,Our latest offers,See what's new,https://example.com

• file_nameはcontent_personalization_template.csvです。
• user_propertyはタグキー：campaign_idにマッピングされます。
• message_componentは、パーソナライズするメッセージのセクションにマッピングされた列ヘッダーです（title、message、またはurl）。

コンテンツパーソナライゼーションメッセージのLiquid構文

{{ dynamic_content.content_personalization_template[campaign_id].title }}
{{ dynamic_content.content_personalization_template[campaign_id].message }}
{{ dynamic_content.content_personalization_template[campaign_id].url }}

（推奨）デフォルトフォールバック付きコンテンツパーソナライゼーションメッセージのLiquid構文

{% assign cid = campaign_id | default: "default" %}

{% unless dynamic_content.content_personalization_template[cid] %}
  {% assign cid = "default" %}
{% endunless %}

{{ dynamic_content.content_personalization_template[cid].title | default: "最新のオファー" }}
{{ dynamic_content.content_personalization_template[cid].message | default: "新着を見る" }}
{{ dynamic_content.content_personalization_template[cid].url | default: "https://example.com" }}

​

CSVセルでのHTMLの使用（メールのみ）

campaign_id,banner_html
spring_sale,<div style="background:#4CAF50;padding:16px;text-align:center;"><a href="https://example.com/spring" style="color:#fff;font-size:18px;">Shop the Spring Sale</a></div>
default,<div style="background:#333;padding:16px;text-align:center;"><a href="https://example.com" style="color:#fff;font-size:18px;">See What's New</a></div>

{{ dynamic_content.promo_banners[campaign_id].banner_html | default: "<p>Check out our latest offers</p>" }}

​

参考

​

テンプレートの更新

​

キーの特殊文字

{{ dynamic_content.file_name["!the_row!"]["&the_column&"] }}

{{ dynamic_content.file_name.the_row.the_column }}

​

よくある質問

​

CSVを使用したダイナミックコンテンツをテストするにはどうすればよいですか？

• メールで+アドレッシングを使用して複数のバリエーションをテストします：username+test@example.com。
• 上記の多言語およびコンテンツパーソナライゼーションの例に従ってタグを設定します。
• 複数のユーザーとデータタグのアップロードについての詳細は、インポートを参照してください。

​

CSVを使用したダイナミックコンテンツと他のパーソナライゼーションオプションをどちらを使用するか

​

関連ページ