sales-iterable

Iterable Platform のヘルプ

Studio のジャーニー作成やキャンペーン設定から、チャネル設定（メール、SMS、プッシュ通知、アプリ内メッセージ、ウェブプッシュ、WhatsApp）、AI 機能、データ連携、実験、API の使用方法まで、Iterable Platform に関する質問に回答します。

Step 1 — コンテキストを把握する

references/learnings.md が存在する場合は、蓄積された知識を確認するため、最初に読みます。

ユーザーに次の質問をします。

1. どの分野についてサポートが必要ですか？

   • A) Studio — ジャーニーのワークフロー、タイル、分岐、遅延
   • B) キャンペーン — 単発送信またはトリガー型メッセージ
   • C) メール — テンプレート、動的コンテンツ、エディター
   • D) SMS/MMS — 設定、双方向メッセージ、メディアメッセージ
   • E) プッシュ通知 — iOS、Android、ウェブプッシュ
   • F) アプリ内メッセージ — モーダル、バナー、Mobile Inbox、Embedded Messages
   • G) WhatsApp — テンプレート設定、メッセージの種類
   • H) 実験 — A/B テスト、多変量テスト
   • I) AI 機能 — Brand Affinity、STO、Frequency Optimization、Journey Assist
   • J) データ — Smart Ingest、Snowflake、Catalog、ユーザープロファイル、イベント
   • K) セグメンテーション — オーディエンス、フィルター、動的リスト
   • L) インテグレーション — Webhook、API、Zapier、サードパーティ
   • M) 分析とレポート — キャンペーンのパフォーマンス、エンゲージメント
   • N) その他 — 内容を説明してください

2. あなたの役割は何ですか？

   • A) マーケター／キャンペーンマネージャー
   • B) 開発者／エンジニア
   • C) データ／分析担当者
   • D) マーケティングオペレーション／管理者

3. 達成したいことは何ですか？

   • A) 初めて設定する
   • B) 既存の設定を最適化または改善する
   • C) 問題をトラブルシューティングする
   • D) 仕組みを理解する

ユーザーの依頼にすでにこれらのコンテキストの大部分が含まれている場合は、該当するステップに直接進みます。 妥当な前提を明示したうえで、可能な範囲で回答してから、最後に最も重要な確認事項を1～2点だけ尋ねます。

Step 2 — 適切なスキルに引き継ぐ、または直接回答する

質問が Iterable 固有の設定ではなく、一般的な戦略に関するものである場合は、適切なスキルに引き継ぎます。

質問の種類	引き継ぎ先
メールマーケティング戦略（Iterable 固有ではないもの）	「これはメールマーケティング戦略に関する質問です。次を実行してください：/sales-email-marketing {your question}」
複数のツールにまたがるプッシュ通知戦略	「これはプッシュ通知戦略に関する質問です。次を実行してください：/sales-push-notification {your question}」
複数のツールにまたがるアプリ内メッセージ戦略	「これはアプリ内メッセージ戦略に関する質問です。次を実行してください：/sales-in-app-messaging {your question}」
トランザクショナルメールプロバイダーの比較	「これはトランザクショナルメールに関する質問です。次を実行してください：/sales-transactional-email {your question}」
複数のツールにまたがる SPF/DKIM/DMARC の設定	「これはメール配信に関する質問です。次を実行してください：/sales-deliverability {your question}」
Zapier/Make を使った Iterable と CRM の接続	「これはツールの連携に関する質問です。次を実行してください：/sales-integration {your question}」

それ以外の場合は、以下の Iterable 固有のガイダンスに基づいて直接回答します。

Step 3 — Iterable Platform のリファレンス

詳細なモジュールのドキュメント、価格、インテグレーション、データモデルについては、references/platform-guide.md を読みます。

プラットフォームガイドの詳細を確認する必要はなくなりました。ユーザーの具体的な状況に集中してください。

Step 4 — 実行可能なガイダンス

はじめに確認するチェックリスト

1. データセンターを設定する — プロジェクトのデータセンターが米国またはEUであることを確認します（APIのベースURLとデータの保存場所に影響します）
2. チャネルを設定する — 送信ドメイン（メール）を認証し、FCM/APNs（プッシュ）を設定し、SMS番号を用意して、Webプッシュを設定します
3. SDKを統合する — プッシュ、アプリ内メッセージ、Mobile Inbox、Embedded Messages、イベント追跡用のiOS/Android/Web SDKをインストールします
4. ユーザーをインポートする — CSV、API（/api/users/bulkUpdate）、またはデータウェアハウスからのSmart Ingestで一括アップロードします
5. イベントを定義する — 主要なユーザーアクション（signup、purchase、feature_used、cart_abandoned）をマッピングし、SDKまたはAPIで追跡を実装します
6. セグメントを作成する — 主要なオーディエンス（アクティブ、休眠、高価値、新規ユーザー）向けの動的リストを作成します
7. テンプレートを作成する — 動的なHandlebarsコンテンツを使用して、メール、プッシュ、SMS、アプリ内メッセージのテンプレートを設計します
8. 最初のジャーニーを作成する — Studioでウェルカムジャーニーから始めます。signupイベントで開始 → メール → 待機 → プッシュ → エンゲージメントに応じて分岐
9. 実験を設定する — 最初のキャンペーンで件名と送信時刻をA/Bテストします
10. AIを有効にする — エンゲージメントデータが30日分以上集まったら、Brand Affinity、STO、Frequency Optimizationを有効にします
11. Webhookを設定する — 配信状況の監視とCRM同期用のシステムWebhookを設定します
12. データウェアハウスを接続する — Snowflake Secure Data SharingまたはSmart Ingestを設定して、双方向のデータフローを実現します

追跡する主要指標

指標	Iterable内の場所	ベンチマーク
メール開封率	Campaign analytics	20-25%
メールクリック率	Campaign analytics	2-5%
プッシュ開封率	Campaign analytics	5-15%
アプリ内クリック率	Campaign analytics	15-30%
SMS配信率	Campaign analytics	> 95%
ジャーニー完了率	Studio analytics	ジャーニーによって異なります
Brand Affinityの分布	AI > Brand Affinity	良好な状態：Positive/Loyalが大半
実験の有意性	Experiment results	95%の信頼度に達するまで待ちます

注意点

調査に基づくベストエフォートの情報です。特に、プランによって利用が制限される機能や、古くなっている可能性のある統合上の注意点を確認してください。

1. キャンペーンは1つのチャネルのみを対象にします。 Canvasからメール、プッシュ、アプリ内メッセージを送信できるBrazeとは異なり、Iterableのキャンペーンは1つのメッセージチャネルを対象とします。複数のチャネルで送信するには、Studioのジャーニーで複数のSendタイルを使用してください。1つのキャンペーンで複数チャネルへの送信を試みないでください。
2. Brand Affinityにはデータが必要です。 キャンペーン全体で30日分以上のエンゲージメントデータが集まるまで、Brand Affinityのラベルは正確になりません。最初の1か月はセグメント化にBrand Affinityを使わないでください。「Neutral」や「Never Engaged」のラベルがほとんどになります。
3. APIのレート制限はエンドポイントごとに異なり、プロジェクト単位で適用されます。 一括イベント追跡は10 req/s、エクスポートは4 req/minです。同じプロジェクトで複数のAPIクライアントを使用する場合、プロジェクト単位のレート制限を共有します。429レスポンスには指数バックオフを実装してください。
4. Smart Ingestの同期はリアルタイムではありません。 Smart Ingestの最短同期間隔は15分です。リアルタイムデータには、代わりにREST API（/api/users/update、/api/events/track）を使用してください。Smart Ingestはイベントストリーミングではなく、定期的なデータウェアハウス同期に適しています。
5. アプリ内メッセージにはSDKの統合が必要です。 メールやプッシュとは異なり、アプリ内メッセージ、Mobile Inbox、Embedded Messagesを使うには、アプリにIterable SDKをインストールする必要があります。サーバー側のメッセージングにREST APIのみを使用している場合、これらは動作しません。

• 自己改善：ここに記載されていないことが見つかった場合は、今日の日付とともにreferences/learnings.mdに追記してください。

関連スキル

• /sales-email-marketing — 複数のプラットフォームに対応したメールマーケティング戦略（Iterable 固有ではありません）
• /sales-push-notification — プッシュ通知戦略（オプトイン、リッチプッシュ、各種ツールでの配信頻度制限）
• /sales-in-app-messaging — アプリ内メッセージ戦略（メッセージの種類、トリガー設計、各種ツールでのオンボーディング）
• /sales-transactional-email — トランザクションメールの配信（プロバイダーの比較、API 統合）
• /sales-deliverability — メールの到達率（SPF/DKIM/DMARC、ウォームアップ、送信者のレピュテーション）
• /sales-integration — Iterable を CRM、データウェアハウス、その他のツールに接続
• /sales-braze — Braze プラットフォームのサポート（主な競合製品 — Braze 固有の質問はこちら）
• /sales-customerio — Customer.io プラットフォームのサポート（別のクロスチャネルプラットフォーム）
• /sales-klaviyo — Klaviyo プラットフォームのサポート（eコマースに特化したエンゲージメント）
• /sales-do — どのスキルを使うべきか分かりませんか？ルーターがあらゆるセールスの目的に適したスキルを選びます。インストール方法：npx skills add sales-skills/sales --skill sales-do

例

例 1：Studio でウェルカムジャーニーを構築する

ユーザーの質問：「Iterable で新規ユーザー向けの複数ステップのウェルカムジャーニーを作成するにはどうすればよいですか？」 スキルの動作：Studio ジャーニーの作成手順を説明します。「signup」カスタムイベントをエントリートリガーに設定 → メール送信（ウェルカムメッセージ＋価値提案）→ 1 日待機 → フィルター（ウェルカムメールを開封したか？）→ はいの分岐：プッシュ通知を送信（機能の紹介）→ 2 日待機 → アプリ内メッセージを送信（オンボーディングのツールチップ）。いいえの分岐：メールを送信（再エンゲージメント）。終了条件：ユーザーがオンボーディングイベントを完了。後続ステージ向けのテンプレートの推奨と Brand Affinity によるフィルタリングも含みます。 結果：マルチチャネルのオンボーディングフローを含む、完成した Studio ジャーニー

例 2：実験を設定する

ユーザーの質問：「Iterable でメールの件名を A/B テストするにはどうすればよいですか？」 スキルの動作：次の 2 つの方法を説明します。1）キャンペーンレベルの実験 — 一斉配信キャンペーンを作成し、2～4 種類の件名を使った実験を追加して、勝者を決める指標（開封率）、サンプルサイズ（20％）、勝者の自動送信タイミングを設定します。2）ジャーニーの実験 — Studio に Experiment タイルを追加し、件名の異なる 2 つのメール送信タイルにトラフィックを振り分けます。統計的有意性を得るため、バリアントごとに最低 1,000 人の受信者を推奨します。 結果：適切なサンプルサイズと勝者の判定基準で設定された A/B テスト

例 3：Smart Ingest を使って Snowflake と統合する

ユーザーの質問：「Snowflake から Iterable にユーザーデータを同期するにはどうすればよいですか？」 スキルの動作：Smart Ingest の設定手順を説明します。Integrations > Smart Ingest > Create Connection > Select Snowflake > 認証情報を設定（アカウント、ウェアハウス、データベース、スキーマ）> 同期タイプをマッピング（Users）> フィールドをマッピング（email → email、カスタム属性 → dataFields）> 同期頻度を設定（15 分ごと、または 1 時間ごと）> テストして有効化。逆方向（Iterable → Snowflake）には Snowflake Secure Data Sharing を使用できることにも触れます。 結果：Snowflake と Iterable の双方向データパイプラインが設定された状態

トラブルシューティング

iOS でプッシュ通知が配信されない

症状：プッシュキャンペーンで送信数は表示されるものの、iOS デバイスへの配信数が表示されない 原因：APNs 証明書の期限切れ、サンドボックスと本番環境の不一致、または SDK の初期化が正しく行われていない 解決策：1）Iterable Settings > Mobile Apps で APNs 証明書の有効期限を確認します。2）正しい APNs 環境を使用していることを確認します（TestFlight にはサンドボックス、App Store には本番環境）。3）Iterable SDK が正しい API キーで初期化されており、プッシュ通知の登録時に registerForRemoteNotifications() が呼び出されていることを確認します。4）デバイストークンが setDeviceToken() を介して Iterable に送信されていることを確認します。5）アプリを新規インストールして、新しいトークンを生成し、テストします。

Smart Ingest の同期に失敗する

症状：Smart Ingest 接続でエラーが表示される、またはデータが同期されない 原因：認証情報の問題、クエリのタイムアウト、またはフィールドマッピングの不一致 解決策：1) Snowflake／BigQuery の認証情報が引き続き有効で、ソーステーブルに対する SELECT 権限があることを確認します。2) ソースクエリがデータを返すことを確認します（データウェアハウスで直接実行します）。3) ユーザーを特定できるよう、フィールドマッピングで email または userId がマッピングされていることを確認します。4) データ型の不一致（例：文字列フィールドが数値にマッピングされている）がないか確認します。5) Iterable の Smart Ingest ログを確認し、具体的なエラーメッセージを調べます。

Brand Affinity の精度が低い

症状：Brand Affinity でほとんどのユーザーが「Neutral」または「Never Engaged」と表示される 原因：エンゲージメントデータが不足しています。Brand Affinity で有意なスコアを生成するには、複数チャネルにまたがる過去のインタラクションデータが必要です。 解決策：1) 30 日以上にわたって複数のチャネルでキャンペーンを配信していることを確認します。2) メールキャンペーンの開封／クリックトラッキングが有効になっていることを確認します。3) プッシュ通知の開封トラッキングが機能していることを確認します（SDK が正しく設定されていること）。4) Brand Affinity は定期的に再計算されるため、エンゲージメントデータを追加した後、次の更新サイクルを待ちます。5) その間は、Brand Affinity ラベルではなく、従来のエンゲージメントベースのセグメンテーション（過去 30 日間に開封）を使用します。