sales-braze

Braze Platform Help

Canvas Flow のジャーニーオーケストレーションやクロスチャネルキャンペーンから、BrazeAI、Braze Data Platform、セグメンテーション、Catalogs、Feature Flags、REST API 統合まで、Braze プラットフォームに関する質問に対応します。

ステップ 1 — コンテキストを確認する

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

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

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

   • A) Canvas Flow — ジャーニーオーケストレーション、複数ステップのクロスチャネルフロー
   • B) キャンペーン — 単発配信または API トリガーによるメッセージ
   • C) メール — テンプレート、ドラッグ＆ドロップエディター、Liquid、Connected Content
   • D) プッシュ通知 — iOS、Android、Web プッシュ、リッチプッシュ（クロスプラットフォーム戦略については、/sales-push-notification {your question} に引き継ぎます）
   • E) アプリ内メッセージ / Content Cards — モーダル、スライドアップ、永続的なカード（クロスプラットフォーム戦略については、/sales-in-app-messaging {your question} に引き継ぎます）
   • F) SMS / MMS / RCS / WhatsApp / LINE — モバイルメッセージングチャネル
   • G) BrazeAI — 予測モデル、生成コンテンツ、AI エージェント、Decisioning Studio
   • H) セグメンテーション — リアルタイムセグメント、SQL セグメント、CDI Segments、フィルター
   • I) Braze Data Platform — Cloud Data Ingestion、Currents ストリーミング、データ変換
   • J) Catalogs — 商品データ、位置情報データ、動的パーソナライゼーション
   • K) Feature Flags — 制御されたロールアウト、機能の A/B テスト
   • L) トランザクションメール — 時間的制約のある 1:1 メッセージ専用の API（クロスプラットフォームについては、/sales-transactional-email {your question} に引き継ぎます）
   • M) 配信到達性 — ドメイン認証、IP ウォームアップ、送信者レピュテーション（クロスプラットフォームについては、/sales-deliverability {your question} に引き継ぎます）
   • N) REST API — エンドポイント、認証、レート制限、SDK
   • O) 統合 — Braze Alloys、CDP コネクター、データウェアハウスとの同期
   • P) Liquid テンプレート / Connected Content — 動的パーソナライゼーション
   • Q) 管理 — ワークスペース、API キー、SCIM、権限、請求
   • R) Appboy または別のプラットフォームからの移行
   • S) その他 — 内容を説明してください

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

   • A) マーケティング / CRM / ライフサイクルマーケター
   • B) グロース / プロダクトマネージャー
   • C) 開発者 / エンジニア
   • D) データ / アナリティクス
   • E) 管理者 / 運用担当
   • F) その他

3. 何を達成しようとしていますか？（具体的な目標や質問を説明してください）

ユーザーのリクエストにすでに必要な情報の大部分が含まれている場合は、該当するステップに直接進みます。 妥当な前提を明示したうえで、可能な範囲で最善の回答を先に示し、最後に最も重要な確認質問を 1〜2 件だけ尋ねます。

ステップ 2 — 振り分ける、または直接回答する

リクエストが専門スキルに該当する場合は、次のように振り分けます。

• プッシュ通知戦略 → /sales-push-notification
• アプリ内メッセージング戦略 → /sales-in-app-messaging
• メールマーケティング戦略（オプトイン） → /sales-email-marketing
• トランザクションメールのアーキテクチャ → /sales-transactional-email
• クロスプラットフォームの配信到達性 → /sales-deliverability
• ツール統合のアーキテクチャ → /sales-integration
• リードスコアリングモデル → /sales-lead-score
• ライブチャット / チャットボット → /sales-live-chat
• ロイヤルティプログラム → /sales-loyalty

それ以外の場合は、以下のリファレンスを使い、プラットフォームの知識に基づいて直接回答します。

ステップ 3 — Braze プラットフォームのリファレンス

詳細なモジュールドキュメント、料金、統合、データモデルについては、references/platform-guide.md を読みます。

プラットフォームガイドの詳細は不要です。ユーザーの具体的な状況に集中してください。

ステップ 4 — 実行可能なガイダンス

ユーザーの分野に応じて、以下を提示します。

1. 手順 — 正確な Braze UI のパスまたは API 呼び出し
2. 構成に関する推奨事項 — 設定、プランに関する考慮事項、注意点
3. 検証手順 — セットアップが機能していることを確認する方法
4. 次のステップ — 直近のタスクの後に行うこと

一般的なセットアップ手順

初回セットアップのチェックリスト：

1. SDK 統合を設定します（iOS/Android/Web）— SDK をインストールし、API キーとエンドポイントを設定します
2. ユーザー識別を設定します — external_id を指定して changeUser() を実行します
3. カスタムイベントと属性を追跡します — イベント分類を定義します
4. メールドメイン認証（SPF/DKIM/DMARC）を設定します
5. プッシュ通知の認証情報（APNs 証明書、FCM キー）を設定します
6. ユーザーの行動に基づいて最初のセグメントを作成します
7. 各チャネルをテストするためのシンプルなキャンペーンを作成します
8. （必要に応じて）データエクスポート用に Currents を設定します

Canvas フローのクイックスタート：

1. Dashboard → Messaging → Canvas → Create Canvas
2. エントリースケジュールを設定します（アクションベース、スケジュール設定、または API トリガー）
3. エントリー対象者を追加します（セグメントまたはフィルター）
4. フローを作成します：メッセージステップ、遅延、条件分岐を追加します
5. 必要に応じて A/B テスト用のバリエーションを追加します
6. 成功を追跡するコンバージョンイベントを設定します
7. 内容を確認し、内部ユーザーでテストしてから開始します

API キーのセットアップ：

1. Dashboard → Settings → APIs and Identifiers
2. Create New API Key — 内容がわかる名前を付けます
3. このキーに必要な権限だけを選択します（最小権限の原則）
4. REST エンドポイントを確認します（インスタンス固有の URL）
5. テストします：curl -H "Authorization: Bearer YOUR_KEY" https://rest.{instance}.braze.com/users/export/ids -d '{"external_ids": ["test_user"]}'

注意点

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

1. インスタンス固有のエンドポイント：Braze には多数のリージョン別インスタンスがあります（US-01〜US-08 と US-10 — US-09 はありません — さらに EU-01/02、AU-01、ID-01、JP-01、KR-01）。**US および APAC のインスタンスでは .braze.com、EU のインスタンスでは .braze.eu を使用します。**API 呼び出しで誤ったインスタンス URL（または EU で誤ったドメイン）を使うと、エラーが通知されないまま失敗します。正しい REST エンドポイントは、必ず Settings → APIs and Identifiers で確認してください。
2. Canvas と Campaign の混同：Braze には「Campaigns」（単一ステップ）と「Canvas」（複数ステップ）の両方があります。「シーケンス」や「ジャーニー」について尋ねるユーザーには、Campaign ではなく Canvas が適しています。「一斉配信」や「一度限りの送信」について尋ねるユーザーには、Campaign が適しています。
3. MAU ベースの料金が予想外に急増することがあります：Braze の課金対象は連絡先ではなく月間アクティブユーザー数です。休眠ユーザーを再びアクティブにするリエンゲージメントキャンペーンを実施すると、MAU 数（および請求額）が増加します。休眠顧客の呼び戻しキャンペーンを設計する際は、この点をユーザーに伝えてください。
4. Liquid と Handlebars：Braze が使用するテンプレートエンジンは Liquid（Shopify と同様）であり、Handlebars（SendGrid/Postmark と同様）ではありません。構文は {{${first_name}}} であり、{{first_name}} ではありません。二重のドル記号で囲むのは、Braze 固有の Liquid 構文です。
5. Connected Content のレート制限：Connected Content の API 呼び出しは送信時に実行されます。100 万人のユーザーに送信し、各メッセージが外部 API を呼び出す場合、サーバーへの API 呼び出しは 100 万回になります。キャッシュを実装し（{% connected_content ... :cache_max_age 300 %}）、API がこの負荷に対応できることを確認してください。

• 自己改善：ここで取り上げていない内容を見つけた場合は、今日の日付を付けて references/learnings.md に追記してください。

ステップ 5 — 関連スキル

• /sales-push-notification — プラットフォーム横断のプッシュ通知戦略
• /sales-in-app-messaging — プラットフォーム横断のアプリ内メッセージングとコンテンツカード戦略
• /sales-email-marketing — プラットフォーム横断のオプトイン型メールマーケティング戦略
• /sales-transactional-email — トランザクションメール／トリガー型メール配信戦略
• /sales-deliverability — プラットフォーム横断のメール到達率（SPF/DKIM/DMARC、ウォームアップ、レピュテーション）
• /sales-integration — Braze とデータウェアハウス、CDP、その他のツールとの接続
• /sales-live-chat — ライブチャットとチャットボット戦略
• /sales-loyalty — 顧客ロイヤルティプログラムの設計
• /sales-lead-score — リード／エンゲージメントのスコアリングモデル
• /sales-do — どのスキルを使えばよいかわからない場合に、ルーターがあらゆる営業目標に適したスキルを選択します。インストール：npx skills add sales-skills/sales --skill sales-do

例

例 1：オンボーディング Canvas の構築

ユーザーの質問：「Braze で新しいアプリユーザー向けの 7 日間のオンボーディングジャーニーを作成するにはどうすればよいですか？」 スキルの内容：アクションベースのエントリ（セッション開始、初回 = true）を使った Canvas の作成から、0 日目のウェルカムプッシュ通知＋アプリ内メッセージ、1 日目のスタートガイド付きメール、3 日目の Decision Split（セットアップ完了？ はい → 機能を紹介する Content Card、いいえ → リマインダープッシュ通知）、7 日目のアンケート用アプリ内メッセージまでを案内します。コンバージョンイベントと A/B バリアントの設定も含まれます。 結果：分岐、複数チャネルのメッセージ、成功指標を備えたオンボーディング Canvas が完成します

例 2：Currents データエクスポートの設定

ユーザーの質問：「Braze のエンゲージメントイベントを Snowflake データウェアハウスにストリーミングしたいです」 スキルの内容：ダッシュボード → データ設定 → Currents → 新しい Current を作成 → Snowflake の順に進み、接続認証情報の設定、ストリーミングするイベント（メール開封、プッシュ通知のクリック、アプリ内インプレッション、購入）の選択、データ形式の設定を案内します。ETL 処理なしでアクセスできる Snowflake Data Sharing という代替手段についても説明します。 結果：エンゲージメントデータが Braze から Snowflake にリアルタイムで流れます

例 3：Connected Content を使ったパーソナライズされたおすすめの表示

ユーザーの質問：「送信時に API から商品のおすすめ情報を Braze のメールに取り込むにはどうすればよいですか？」 スキルの内容：Connected Content の構文を示します：{% connected_content https://api.example.com/recs/{{${user_id}}} :save recs :cache_max_age 900 %} → {% for item in recs.products %} で繰り返し処理 → メール内に商品カードを作成します。エラー処理（{% if connected_content_status == 200 %}）、キャッシュ、負荷テストについても説明します。 結果：外部 API から取得した商品情報を使い、動的にパーソナライズされたおすすめメールが作成されます

トラブルシューティング

Canvas が想定したオーディエンスに送信されない

症状：Canvas のエントリ数が 0 件、または想定より大幅に少ない 原因：エントリーオーディエンスのフィルターが厳しすぎる、レート制限が強すぎる、再エントリーが無効になっている、またはエントリースケジュールが想定したトリガーと一致していない 解決策：1）エントリーオーディエンスを確認し、セグメントの規模をプレビューします。2）トリガーイベントが実際に発生していることを確認します（ユーザープロフィールのイベントログを確認します）。3）レート制限の設定を確認します。4）ユーザーが複数回エントリーする必要がある場合は、再エントリーが有効になっていることを確認します。5）API でトリガーされる Canvas の場合は、API 呼び出しに正しい canvas_id が含まれていることを確認します。

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

症状：プッシュキャンペーンでは送信数が記録されているものの、配信数が少ない、または 0 件 原因：プッシュトークンが無効、APNs 証明書の期限切れ、FCM キーの誤り、またはユーザーが配信登録を解除している 解決策：1）ユーザープロフィールでプッシュトークンの有効性を確認します。2）ダッシュボード → 設定 → アプリ設定で APNs 証明書または FCM キーを確認します。3）プッシュ配信登録の状態を確認し、「プッシュ有効」でセグメントを絞り込みます。4）iOS の場合は、プッシュ通知の許可を求める画面が表示され、ユーザーが許可していることを確認します。5）まず、正常に動作することが確認済みのデバイスでテストします。

Connected Content がエラーを返す

症状：メールのパーソナライズ部分が空白になったり、エラー時の代替コンテンツが表示されたりする 原因：送信時に外部 API に接続できない、レート制限が適用されている、または想定外の形式が返される 解決策：1）サンプルの user_id を使って API URL を手動でテストします。2）エラー処理を追加します：{% if connected_content_status == 200 %}。3）API 呼び出しを減らすため、キャッシュを追加します：:cache_max_age 300。4）API が送信量（受信者 1 人につき 1 回の呼び出し）に対応できることを確認します。5）代替コンテンツを追加します：{% else %}Default content here{% endif %}。