Customer.io

परिचय

Customer.io integration Dodo Payments events को Customer.io के Track API पर भेजता है, जिससे payments और subscription changes campaigns और customer journeys को ट्रिगर कर सकते हैं। उदाहरण के लिए, नए customer को welcome email मिल सकता है, subscription change पर update भेजा जा सकता है, और failed payment पर notification भेजी जा सकती है।

इस integration के लिए आपके Customer.io Site ID और API key आवश्यक हैं। Track API HTTP Basic authentication का उपयोग करता है, जिसमें Site ID username और API key password होता है।

प्रारंभ करना

Open the Webhook Section

Dodo Payments dashboard में, Developer → Webhooks पर जाएँ और Add endpoint पर क्लिक करें।

Integration dropdown में CustomerIO चयनित होने वाला Add endpoint संवाद

Select Customer.io

Integration में, CustomerIO चुनें।

Enter Credentials

API key में अपनी Customer.io API key paste करें। Dodo Payments key को bearer token के रूप में Authorization header में भेजता है।Track API को Basic authentication की अपेक्षा होती है। यदि deliveries 401 के साथ विफल होती हैं, तो endpoint का Advanced tab खोलें और Authorization header को Basic से बदलें, जिसके बाद site_id:api_key का Base64 encoding डालें।

Select Events

Subscribed events में, वे events चुनें जिन्हें आपका transformation handle करता है। इस page के examples payment.succeeded, subscription.active और subscription.cancelled का उपयोग करते हैं।

Configure Transformation

Transformation code के अंतर्गत, Customer.io के Track API के लिए events format करने हेतु handler को edit करें। examples से शुरुआत करें।

Test & Create

Test this code के अंतर्गत, sample payload के विरुद्ध handler चलाने के लिए Simulate पर click करें। फिर Create endpoint पर click करें।

Done

अब subscribed events Customer.io तक पहुँचते हैं, जहाँ वे आपकी email automations को ट्रिगर कर सकते हैं।

Transformation Code Examples

प्रत्येक handler Track API v2 entity endpoint को एक request भेजता है और व्यक्ति की पहचान उनके Dodo Payments customer_id से करता है। Event record करने के लिए, request action को event पर सेट करती है और event name को name में रखती है। व्यक्ति के attributes update करने के लिए, यह action को identify पर सेट करती है। Dodo Payments amounts सबसे छोटी currency unit में होते हैं, इसलिए examples उन्हें 100 से divide करते हैं।

Track Payment Events

Payment सफल होने पर payment_completed event record करें:

track_payments.js

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: "event",
      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;
}

Track Subscription Lifecycle

Subscription active होने पर subscription_started event और cancel होने पर subscription_cancelled event record करें:

track_subscriptions.js

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: "event",
        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: "event",
        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;
}

Track Customer Attributes

Payment सफल होने पर व्यक्ति के profile attributes update करें। प्रत्येक identify request अपने द्वारा भेजे गए attributes को overwrite करती है, इसलिए last_payment_amount और last_payment_date में हमेशा latest payment होता है।

track_attributes.js

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,
        last_payment_amount: (p.total_amount / 100).toFixed(2),
        payment_method: p.payment_method || "unknown",
        last_payment_date: webhook.payload.timestamp
      }
    };
  }
  return webhook;
}

Tips

Transformation और अपने Customer.io campaign triggers में समान event names का उपयोग करें, उदाहरण के लिए payment_completed। ऐसे names चुनें जो हुई घटना का वर्णन करें।
Personalization के लिए अपने messages द्वारा उपयोग किए जाने वाले attributes शामिल करें।
प्रत्येक request में हर व्यक्ति की पहचान समान ID से करें। Examples Dodo Payments customer_id का उपयोग करते हैं।
प्रत्येक request field के लिए Customer.io Track API reference देखें।

Troubleshooting

Events Not Triggering Campaigns

Verify करें कि Site ID और API key सही हैं।
यदि deliveries 401 के साथ विफल होती हैं, तो Getting Started में बताए अनुसार Authorization header को Basic authentication पर सेट करें।
जाँचें कि event names आपके Customer.io campaign triggers से match करते हैं।
जाँचें कि customer identifiers सेट हैं।
Customer.io API rate limits की समीक्षा करें।

Transformation Errors

जाँचें कि payload Customer.io API format से match करता है।
जाँचें कि सभी required fields मौजूद हैं और action वह action है जिसे Track API support करता है, जैसे event या identify।
जाँचें कि event names और attributes सही format में हैं।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

प्रारंभ करना

Transformation Code Examples

Track Payment Events

Track Subscription Lifecycle

Track Customer Attributes

Tips

Troubleshooting

​परिचय

​प्रारंभ करना

​Transformation Code Examples

​Track Payment Events

​Track Subscription Lifecycle

​Track Customer Attributes

​Tips

​Troubleshooting

परिचय

प्रारंभ करना

Transformation Code Examples

Track Payment Events

Track Subscription Lifecycle

Track Customer Attributes

Tips

Troubleshooting