はじめに
支払いイベントに基づいて、パーソナライズされたメールキャンペーンや顧客の旅をトリガーします。新しい顧客へのウェルカムメール、サブスクリプションの更新、支払い失敗通知をCustomer.ioを通じて自動的に送信します。
この統合には、Customer.ioのサイトIDとAPIキーが必要です。
始め方
Webhookセクションを開く
Dodo Paymentsのダッシュボードで、Webhooks → + エンドポイントを追加に移動し、統合のドロップダウンを展開します。 Customer.ioを選択
Customer.io統合カードを選択します。
認証情報を入力
設定にCustomer.ioのサイトIDとAPIキーを提供します。
変換を設定
Customer.ioのTrack API用にイベントをフォーマットするために変換コードを編集します。
テストと作成
サンプルペイロードでテストし、作成をクリックして同期を有効にします。
完了！
🎉 支払いイベントがCustomer.ioのメール自動化をトリガーします。
変換コードの例
支払いイベントのトラッキング
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://track.customer.io/api/v2/entity";
webhook.payload = {
type: "person",
identifiers: {
id: p.customer.customer_id
},
action: "payment_completed",
name: "Payment Completed",
attributes: {
email: p.customer.email,
name: p.customer.name,
payment_amount: (p.total_amount / 100).toFixed(2),
payment_method: p.payment_method || "unknown",
payment_id: p.payment_id,
currency: p.currency || "USD"
}
};
}
return webhook;
}
サブスクリプションライフサイクルのトラッキング
function handler(webhook) {
const s = webhook.payload.data;
switch (webhook.eventType) {
case "subscription.active":
webhook.url = "https://track.customer.io/api/v2/entity";
webhook.payload = {
type: "person",
identifiers: {
id: s.customer.customer_id
},
action: "subscription_started",
name: "Subscription Started",
attributes: {
email: s.customer.email,
subscription_id: s.subscription_id,
product_id: s.product_id,
amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
frequency: s.payment_frequency_interval,
next_billing: s.next_billing_date
}
};
break;
case "subscription.cancelled":
webhook.url = "https://track.customer.io/api/v2/entity";
webhook.payload = {
type: "person",
identifiers: {
id: s.customer.customer_id
},
action: "subscription_cancelled",
name: "Subscription Cancelled",
attributes: {
email: s.customer.email,
subscription_id: s.subscription_id,
cancelled_at: s.cancelled_at,
cancel_at_next_billing: s.cancel_at_next_billing_date
}
};
break;
}
return webhook;
}
顧客属性のトラッキング
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://track.customer.io/api/v2/entity";
webhook.payload = {
type: "person",
identifiers: {
id: p.customer.customer_id
},
action: "identify",
name: "Customer Identified",
attributes: {
email: p.customer.email,
name: p.customer.name,
total_spent: (p.total_amount / 100).toFixed(2),
payment_method: p.payment_method || "unknown",
last_payment_date: webhook.payload.timestamp,
customer_since: webhook.payload.timestamp
}
};
}
return webhook;
}
ヒント
- Customer.ioキャンペーンに一致する一貫したイベント名を使用する
- パーソナライズのために関連する属性を含める
- 正確なトラッキングのために適切な顧客識別子を設定する
- キャンペーントリガーのために意味のあるイベント名を使用する
トラブルシューティング
- サイトIDとAPIキーが正しいことを確認する
- イベント名がCustomer.ioキャンペーンと一致していることを確認する
- 顧客識別子が正しく設定されていることを確認する
- Customer.io APIのレート制限を確認する
- JSON構造がCustomer.io APIフォーマットに一致していることを検証する
- 必要なすべてのフィールドが存在することを確認する
- イベント名と属性が正しくフォーマットされていることを確認する
