はじめに
セグメントでの支払いイベントを追跡し、分析、マーケティングオートメーション、顧客データプラットフォームを強化します。支払い、サブスクリプション、顧客ライフサイクルイベントを300以上の下流ツールに自動的に送信します。
この統合には、セグメントワークスペースからのセグメント書き込みキーが必要です。
始め方
Webhookセクションを開く
Dodo Paymentsダッシュボードで、Webhooks → + エンドポイントを追加に移動し、統合のドロップダウンを展開します。 セグメントを選択
セグメント統合カードを選択します。
書き込みキーを入力
設定にセグメント書き込みキーを提供します。
変換を設定
セグメントのTrack API用にイベントをフォーマットするために変換コードを編集します。
テストと作成
サンプルペイロードでテストし、作成をクリックして同期を有効にします。
完了！
🎉 支払いイベントは今後セグメントで追跡され、接続されたツールに送信されます。
変換コードの例
支払いイベントを追跡
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://api.segment.io/v1/track";
webhook.payload = {
userId: p.customer.customer_id,
event: "Payment Completed",
properties: {
amount: (p.total_amount / 100).toFixed(2),
currency: p.currency || "USD",
payment_method: p.payment_method || "unknown",
payment_id: p.payment_id,
customer_email: p.customer.email,
customer_name: p.customer.name
},
timestamp: webhook.payload.timestamp
};
}
return webhook;
}
サブスクリプションライフサイクルを追跡
function handler(webhook) {
const s = webhook.payload.data;
switch (webhook.eventType) {
case "subscription.active":
webhook.url = "https://api.segment.io/v1/track";
webhook.payload = {
userId: s.customer.customer_id,
event: "Subscription Started",
properties: {
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,
customer_email: s.customer.email
},
timestamp: webhook.payload.timestamp
};
break;
case "subscription.cancelled":
webhook.url = "https://api.segment.io/v1/track";
webhook.payload = {
userId: s.customer.customer_id,
event: "Subscription Cancelled",
properties: {
subscription_id: s.subscription_id,
product_id: s.product_id,
cancelled_at: s.cancelled_at,
cancel_at_next_billing: s.cancel_at_next_billing_date,
customer_email: s.customer.email
},
timestamp: webhook.payload.timestamp
};
break;
}
return webhook;
}
顧客プロパティを特定
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://api.segment.io/v1/identify";
webhook.payload = {
userId: p.customer.customer_id,
traits: {
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 IDをuserIdとして使用する
トラブルシューティング
- 書き込みキーが正しくアクティブであることを確認する
- イベント名がセグメントの命名規則に従っていることを確認する
- ユーザー識別のためにuserIdが正しく設定されていることを確認する
- セグメントAPIのレート制限を確認する
- JSON構造がセグメントAPIフォーマットに一致していることを検証する
- すべての必須フィールドが存在することを確認する
- イベント名がオブジェクトではなく文字列であることを確認する
