このページで役立つこと
システムからのイベントに備えたライフタイム キャンペーンを作成します。有効なトリガーごとに最大 1 つの実行が作成され、ペイロード内の連絡先に 1 つのナッジが送信されます。これが重要な理由
キャンペーンの構築と開始を繰り返し行わなくても、タイムリーで関連性の高いメールを送信できます。バックエンドはイベントの発生時期を制御しますが、Nudgen はメールの内容、配信、追跡、連絡先設定を 1 か所で管理します。ライフタイム キャンペーンを使用する場合
次のようなイベント ドリブンのメールにはライフタイム キャンペーンを使用します。- 注文確認
- 支払いリマインダー
- イベントベースのオンボーディング
- アカウントまたはサブスクリプションの更新
キャンペーンを作成してアクティブ化します
1
Create a Lifetime campaign
キャンペーンに移動し、新しいキャンペーンをクリックして、ライフタイムを選択します。キャンペーン名、目標、ブランド構成、およびオプションの CTA リンクを追加します。
2
Define runtime parameters
送信時にシステムが提供する各値を追加します。パラメータにより
data.* 変数が作成されます。たとえば、電子メールでは order_id は {{data.order_id}} になります。3
Create the email
件名と HTML を生成または書き込み、それらが属する場所にランタイム変数を追加します。メールをプレビューして、アクティブ化する前にテストを送信します。
4
Activate the campaign
下書きとして保存し、アクティブ化 をクリックします。 Nudgen は、必要なパラメータがメールに記載されていること、およびパラメータ コントラクトが生成以降に変更されていないことを確認します。
5
Create a trigger key
[設定] → [API キー] に移動し、チーム トリガー API キーを作成します。
ndg_team_* シークレットをバックエンドまたはシークレット マネージャーに保存します。ブラウザやモバイルアプリのコードには決して配置しないでください。ランタイム パラメーターとテンプレート変数
variableManifest は、電子メール テンプレートと各トリガーの data オブジェクトの間のコントラクトです。キャンペーンでは最大 100 個の変数を定義できます。
たとえば、テンプレートで
{{data.order_id}}、{{data.total}}、および {{data.order_url}} を使用します。 contact.*、event.*、brand.*、および {{firstName}} や {{brandName}} などの従来の変数も使用できます。
Nudgen は、HTML に挿入された変数値をエスケープします。テンプレートは JavaScript、式、またはループをサポートしていません。 href で使用される変数は、url 型で宣言された data.* 変数である必要があります。
ライフサイクルを管理する
有効な遷移は、
draft → active → paused → active と active|paused → archived です。
一時停止またはアーカイブすると、まだ保留中またはキューにある実行がキャンセルされます。すでに処理されている実行は引き続き送信される可能性があります。
バックエンドからのトリガー
ソース イベントを検証した後、信頼できるサーバーからトリガー エンドポイントを呼び出します。パーソナル アクセス トークン (PAT) ではなく、チーム トリガー API キーを使用してください。eventId を維持してください。 Nudgen は、別のナッジを送信する代わりに、200 および duplicate: true を使用して既存の実行を返します。新しい実行では、201 が返されます。
安全に統合します。
- Webhook コンシューマーまたはバックエンドからトリガーし、Nudgen を呼び出す前に受信 Webhook を確認します。
- 指数バックオフを使用してネットワーク エラー、
429、および503を再試行します。eventId. - 機密の連絡先データを含む
Authorizationヘッダーまたはペイロードをログに記録しないでください。 - トリガー キーを定期的にローテーションし、公開されている疑いがある場合はキーをすぐに取り消します。
- テンプレートと実行監査が明確になるように、イベント タイプと変数コントラクトごとに 1 つのキャンペーンを作成します。
実行を監視する
ダッシュボードでキャンペーンを開いて、最近の実行とそのステータスを確認します。実行は、pending、queued、processing、sent、skipped、cancelled、failed、またはdelivery_unknown.
skipped は、コンタクトが登録解除または返送されたことを意味するため、Nudgen はイベントを記録しますが、クォータの送信や消費は行いません。 delivery_unknown は、プロバイダーが電子メールを受け入れた可能性があるが、最終的な配信結果が不確実であることを意味します。 Nudgen は、重複送信を避けるために自動的に再試行しません。
プログラムによるセットアップ、トリガー、実行クエリについては、開発者 API をご覧ください。
関連ドキュメント
Campaigns overview
ワンショット、ドリップ、ライフタイム キャンペーンを比較します。
Developer API
API を通じてライフタイム キャンペーンとトリガーを管理します。