インポート

​

CSVインポート

​

CSV要件

• UTF-8エンコーディング（BOMなし）
• 印字不可能な文字がないこと（特殊文字や非ASCII文字を含まない）
• クリーンで一意の列ヘッダー
• ファイルサイズが150MB未満（約200万行）
• 次のうち少なくとも1つの識別子：
  • external_id — 推奨。すべてのサブスクリプションにわたってユーザーを識別します。
  • email — 新しいメールサブスクリプションの作成に必要です。詳細については、メールアドレス検証を参照してください。
  • phone_number — 新しいSMSサブスクリプションの作成に必要です。
  • subscription_id — バックエンドでOneSignalのサブスクリプションIDをすでに追跡している場合にのみ推奨されます。

​

利用可能なCSV列

​

タグの制限と制約

• 一括タグ更新ワークフローを使用して、ユーザーをエクスポートし、不要なタグ値をクリアし、削除オプションを有効にして再インポートします。
• タグキーにスペースを使用しないでください — 代わりにアンダースコアを使用してください。

• “user”
• “subscription”
• “message”
• “template”
• “app”
• “org”
• “custom_data”
• “dynamic_content”

• CSVに含まれるタグは提供された値で上書きされます。
• CSVに含まれていないタグはユーザーレコードで変更されません。

• ヘッダー列にタグキーが含まれていること。
• 行に値が含まれていないこと。
• レビュー画面で「空白値のタグを削除」オプションを選択したこと。

• Segment
• HubSpot
• Journeys
• SDKタグメソッド
• カスタムAPIまたはETLパイプライン

​

単一の列からタグをインポートする

external_id,email,tags

userA,example@email.com,"{""level"":""30"",""Color"":""teal""}"

1

データをエクスポートする

• OneSignalダッシュボードでオーディエンス > サブスクリプションに移動します。外部ID、サブスクリプションID、タグ列のみを有効にします（オプションでメールまたは電話番号も可）。
• エクスポートをクリックしてCSVをエクスポートします。

2

削除したいタグ値をクリアする

エクスポートしたCSVをテキストエディタで開き、削除したい各タグの値を空の文字列に設定します。例：編集前のタグ値を含む行：

編集前の行

コピー

AIに質問

userA,example@email.com,"{""level"":""30"",""color"":""teal""}"

タグ値をクリアした後の同じ行：

タグ値クリア後の行

コピー

AIに質問

userA,example@email.com,"{""level"":"""",""color"":""""}"

これによりユーザーからタグlevelとcolorが削除されます。

3

削除オプションを使用してCSVを再インポートする

• 編集したCSVをインポートします。
• レビュー画面で、空白値のタグを削除に対してはいを選択します。OneSignalはインポート中に空白値のタグを削除します。

​

メールアドレス検証

​

インポート前にAIを使用してCSVを確認する

このCSVから"user_name"以外のすべてのタグを削除したいです。

以下を実行してください：
1. "user_name"タグ列のみを保持してください。
2. 他のすべてのタグ列を削除してください。
3. このドキュメントのOneSignalインポート要件に一致するようにCSVをフォーマットしてください：
   https://documentation.onesignal.com/docs/en/import

これが私のCSVです：
[CSVを貼り付け]

tag_first_name、tag_last_name、tag_cityなどの複数のタグ列があります。

OneSignalインポートドキュメントによると、各タグは以下を満たす必要があります：
- tag_プレフィックスを使用する
- 英数字とアンダースコアのみを含む
- サポートされているデータ型に従う

私のCSVを確認し、正しくフォーマットされていない部分を特定し、これらの要件を満たす修正版を返していただけますか？

ドキュメントリンク：
https://documentation.onesignal.com/docs/en/import

OneSignalがインポート中にCSVを拒否しました。

以下を実行してください：
1. CSV構造を検証してください。
2. フォーマットの問題（ヘッダー、ID列、タグフォーマット、引用符）を特定してください。
3. このドキュメントの要件に従った修正版を返してください：
   https://documentation.onesignal.com/docs/en/import#prepare-your-csv

これがファイルです：
[CSVを貼り付け]

電話番号がE.164形式ではないため、インポートが失敗しています。

以下を実行してください：
1. すべての電話番号をE.164形式に変換してください。
2. 他のすべてのフィールドを変更しないでください。
3. CSVがOneSignalの必要な構造と一致することを確認してください：
   https://documentation.onesignal.com/docs/en/import

現在のフォーマットの例：(555) 555-1234

これが私のCSVです：
[CSVを貼り付け]

[プラットフォーム名]からOneSignalに移行しています。

このCSVをOneSignalのインポート形式に一致するように変換していただけますか？
以下を含めてください：
- `external_id`
- `tag_`プレフィックスで変換されたタグ（必要な場合）
- E.164形式の電話番号（該当する場合）

参考ドキュメント：
https://documentation.onesignal.com/docs/en/import

これが私のCSVです：
[CSVを貼り付け]

​

インポートの手順

1

CSVをアップロードする

準備したCSVファイルを選択します。

2

フィールドをマッピングする

OneSignalはCSVヘッダーを既知のプロパティに自動的にマッピングします。確認する前にマッピングを確認してください — external_id、email、phone_number、および/またはsubscription_idを識別子として使用し、タグとして使用しないでください。

既存のユーザーに新しいメールアドレスまたは電話番号を追加するには、external_idを使用する必要があります。subscription_idは使用しないでください — サブスクリプションをリンクまたはマージしません。

OneSignalがフォーマットの問題を検出した場合は、CSVを修正して再アップロードするか（推奨）、影響を受けた列のチェックを外してスキップしてください。

3

確認してインポートする

レビュー画面では以下のことができます：

• セグメントを自動的に作成 — インポートされた各ユーザーにタグを追加し、一致するセグメントを作成します。プランの制限に注意してください。
• 空白の値を持つタグを削除 — CSVで値が空白のタグを削除します。不要なタグをクリーンアップしてプランの制限内に収めるのに役立ちます。
• メールアドレス検証の設定 — バウンスを減らして送信者の評判を守るためにメールアドレス検証設定を構成します。

例えば、次のCSVを使用した場合：

コピー

AIに質問

external_id,tag1,tag2
UserA,,"tag2value"
UserB,"tag1value",

「空白の値を持つタグを削除」を有効にした場合、UserAからtag1が削除され、UserBからtag2が削除されます。

確認してインポートをクリックします。ステータス画面に進行状況が表示されます。

​

メール確認

• 一意のメールアドレスまたは電話番号（アプリに存在しなかったもの）から100個のサブスクリプションが作成されました。
• 37,814個のサブスクリプションが更新されました（ユーザー数ではありません — 各ユーザーは複数のサブスクリプションを持つことができます）。
• 621,852行がインポートされませんでした。外部IDが既存のユーザーと一致しなかったか、メール/電話番号がすでに存在していて新しいデータがなかったためです。

​

手動入力

​

よくある質問

​

CSVのインポートにはどのくらいかかりますか？

​

CSVインポートを元に戻すことはできますか？

​

セグメントのカウントがCSVの行数と一致しないのはなぜですか？

​

一部の行でインポートが「インポートされていません」と表示されるのはなぜですか？

​

削除したタグが戻ってくるのはなぜですか？