> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CSVを使用したダイナミックコンテンツ
> OneSignalでCSVアップロードとLiquid構文を使用して、プッシュ、メール、SMSメッセージを大規模にパーソナライズします。
OneSignalは、大規模に[メッセージコンテンツをパーソナライズする](./message-personalization)ためのいくつかの方法を提供します。このガイドは、プッシュ、メール、SMSのためにOneSignalダッシュボードにあるCSVアップロード機能を備えたダイナミックコンテンツの使用に焦点を当てています。
**主な利点：**
* **CSVを使用して大規模にパーソナライズ** – 1つのメッセージ、すべての人にカスタムエクスペリエンス
* **多言語サポート** – ユーザーごとに自動的に言語を切り替え
* **ダイナミックパーソナライゼーション** – コンテンツはユーザープロパティ（言語、地域、キャンペーンID）に適応
* **チームコラボレーション** – 非技術ユーザーがCSVファイルでコンテンツを編集
* **HTML インジェクション（メール）** – CSVセルにHTMLマークアップを含めて、リッチなメールコンテンツを動的に構築
* **クロスチャネル互換性** – チャネル全体でCSVロジックを再利用
**一般的なユースケース：**
* 多言語オンボーディングまたはマーケティング
* 地域固有のプロモーション
* 場所ごとのイベント発表
* キャンペーンベースのパーソナライゼーション
***
## CSVを使用したダイナミックコンテンツのセットアップ手順
**クイックリファレンス：**
1. コンテンツのバリエーションを含むCSVファイルを作成します。
2. Liquid構文の`dynamic_content`プロパティを使用してCSVデータをメッセージにマッピングします。
3. OneSignalダッシュボードから新しいメッセージまたは[テンプレート](./templates)を作成します。
4. **Dynamic Content**または**Personalization**ボタンを選択します。
5. CSVファイルをアップロードしてメッセージを送信します。
### CSV要件と設定
* **ファイルサイズ：** 200 KB未満
* **列ヘッダー：**
* タグキーの最初の列ヘッダーを予約するか、セクションを参照するために空白のままにします
* 英数字と下線のみ
* スペースの代わりに下線（`_`）を使用します
* **エンコーディング：** UTF-8
空白のCSVから始めるか、提供されたテンプレートを使用します。テンプレートは、メッセージおよびテンプレートエディターで**Dynamic Content**または**Personalization**ボタンを選択すると提供されます。
利用可能なテンプレート：
* **多言語** – 言語ごとにコンテンツをローカライズ
* **コンテンツパーソナライゼーション** – データタグごとにコンテンツをカスタマイズ
#### CSVの例
このガイドでは、以下のCSVデータの例を使用します。
* 列ヘッダーを[サポートされている言語コード](./multi-language-messaging#supported-languages)にマッピングします。
* 各言語コードの各行に翻訳を追加します。
* 複数のセクション（メールなど）がある場合は、最初の列をセクション名として指定します。
この例には以下が含まれます：
* 3つの言語：英語、スペイン語、フランス語。
* 2つのセクション：「section\_1」と「section\_2」。
* 最初の列ヘッダーをタグキーにマッピングし、基礎となる行を参照する値にマッピングします。ユーザーにタグを追加する方法の詳細については、[タグ](./add-user-data-tags)を参照してください。
* 残りの列ヘッダーをパーソナライズするセクションまたはコンポーネントにマッピングします。
この例では：
* タグキーは`campaign_id`で、可能な値は`A`と`B`です。
* 3つのコンポーネントがあります：「title」、「message」、「url」。
**重要：** CSVヘッダーからスペースと非英数字文字を削除するか、
Liquidでハッシュ表記を使用してください。
### CSVデータをメッセージコンテンツにマッピングする
[Liquid構文](./using-liquid-syntax)を使用して、`dynamic_content`プロパティを使用してメッセージ内のCSVデータを参照します：
```liquid theme={null}
{{dynamic_content.file_name.message_component[user_property]}}
{{dynamic_content.file_name[user_property].message_component}}
```
**パラメータ：**
* `dynamic_content` – CSVデータを参照するために使用されるプロパティ名
* `file_name` – CSVファイル名（`.csv`拡張子なし）
* `message_component` – パーソナライズする特定のメッセージコンポーネント。これは、CSV列ヘッダーまたは最初の行の静的テキストです。
* `user_property` – 参照する[ユーザープロパティ](./message-personalization#properties)。
**フォールバックコンテンツ：**
CSVルックアップまたはダイナミックコンテンツが失敗した場合にメッセージがレンダリングされることを保証するために、常にハードコードされた文字列`default`フォールバックを使用してください。
```liquid フォールバックのためのLiquid構文 theme={null}
{{ dynamic_content.my_template.header[user.language] | default: "最新の更新へようこそ" }}
```
これは、CSVルックアップまたはダイナミックコンテンツが失敗した場合、メッセージがフォールバックテキスト`"最新の更新へようこそ"`をレンダリングすることを意味します。
これにより以下が保証されます：
* 利用可能な場合はダイナミックコンテンツが使用されます
* ダイナミックコンテンツが失敗した場合はハードコードされたメッセージが表示されます
* ユーザーが空白のコンテンツを受け取ることはありません
```csv translations.csv theme={null}
,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`[プロパティ](./message-personalization#properties)を使用してユーザー上でこれを参照できます。
```liquid 多言語メッセージの基本的なLiquid構文 theme={null}
{{dynamic_content.translations.section_1[user.language]}}
{{dynamic_content.translations.section_2[user.language]}}
```
```liquid （推奨）デフォルトフォールバック付き多言語メッセージのLiquid構文 theme={null}
{% 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..." }}
```
```csv content_personalization_template.csv theme={null}
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 コンテンツパーソナライゼーションメッセージのLiquid構文 theme={null}
{{ 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 （推奨）デフォルトフォールバック付きコンテンツパーソナライゼーションメッセージのLiquid構文 theme={null}
{% 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" }}
```
`default`フォールバック付きのLiquidを使用して、件名、プリヘッダー、ボタン
ラベル、およびURLを更新します。
### CSVセルでのHTMLの使用（メールのみ）
CSVセルにHTMLマークアップを直接含めて、リッチコンテンツをメールに注入することができます。これは、ユーザープロパティに基づいてメールのセクション全体（バナー、CTAなど）を入れ替えるのに便利です。
```csv promo_banners.csv theme={null}
campaign_id,banner_html
spring_sale,
default,
```
メールテンプレートでHTMLセルを参照します：
```liquid theme={null}
{{ dynamic_content.promo_banners[campaign_id].banner_html | default: "Check out our latest offers
" }}
```
HTMLはメール本文に直接レンダリングされるため、メールクライアントがサポートするインラインスタイルとマークアップを使用できます。
CSVセルのHTMLはメールでのみサポートされています。プッシュとSMSチャネルはコンテンツをプレーンテキストとしてレンダリングし、HTMLマークアップを解釈しません。
***
## 参考
### テンプレートの更新
ダッシュボード経由でCSVを再アップロードするか、[テンプレート更新API](/reference/update-template)の`dynamic_content`プロパティを使用します。
### キーの特殊文字
**ハッシュ表記**（非英数字キーの場合）：
```liquid theme={null}
{{ dynamic_content.file_name["!the_row!"]["&the_column&"] }}
```
**ドット表記**（標準キーの場合）：
```liquid theme={null}
{{ dynamic_content.file_name.the_row.the_column }}
```
***
## よくある質問
### CSVを使用したダイナミックコンテンツをテストするにはどうすればよいですか？
メールを使用してメッセージの複数のバリエーションをテストします。
* メールで`+`アドレッシングを使用して複数のバリエーションをテストします：`username+test@example.com`。
* 上記の多言語およびコンテンツパーソナライゼーションの例に従ってタグを設定します。
* 複数のユーザーとデータタグのアップロードについての詳細は、[インポート](./import)を参照してください。
### CSVを使用したダイナミックコンテンツと他のパーソナライゼーションオプションをどちらを使用するか
ダッシュボードからメッセージを送信し、CSVファイルでユーザーデータにアクセスできる場合は、**CSVを使用したダイナミックコンテンツ**を使用してください。メッセージにダイナミックコンテンツを追加する他の方法については、[メッセージパーソナライゼーション](./message-personalization)または[多言語メッセージング](./multi-language-messaging)を参照してください。
***
## 関連ページ
OneSignalで利用可能なすべてのパーソナライゼーションオプションの概要。
OneSignalメッセージの完全なLiquid構文リファレンス。
ユーザーデータとセグメントをOneSignalにアップロードします。
再利用可能なメッセージテンプレートを作成します。