Customer.io

المقدمة

يرسل تكامل Customer.io أحداث Dodo Payments إلى Track API الخاص بـ Customer.io، بحيث يمكن لعمليات الدفع وتغييرات الاشتراكات تشغيل الحملات ورحلات العملاء. على سبيل المثال، يمكن لعميل جديد تلقي رسالة ترحيب، ويمكن لتغيير الاشتراك إرسال تحديث، ويمكن لعملية دفع فاشلة إرسال إشعار.

يتطلب هذا التكامل Site ID ومفتاح API الخاصين بـ Customer.io. يستخدم Track API مصادقة HTTP Basic، مع استخدام Site ID كاسم مستخدم ومفتاح API كلمة مرور.

البدء

Open the Webhook Section

في لوحة معلومات Dodo Payments، انتقل إلى المطور → Webhooks وانقر على إضافة نقطة نهاية.

مربع حوار إضافة نقطة نهاية مع تحديد CustomerIO في القائمة المنسدلة للتكامل

Select Customer.io

في Integration، اختر CustomerIO.

Enter Credentials

في API key، الصق مفتاح API الخاص بـ Customer.io. يرسل Dodo Payments المفتاح في ترويسة Authorization كرمز bearer.يتوقع Track API مصادقة Basic. إذا فشلت عمليات التسليم مع 401، فافتح علامة التبويب Advanced لنقطة النهاية واستبدل ترويسة Authorization بـ Basic متبوعة بترميز Base64 للقيمة site_id:api_key.

Select Events

في Subscribed events، اختر الأحداث التي يعالجها التحويل. تستخدم الأمثلة في هذه الصفحة payment.succeeded وsubscription.active وsubscription.cancelled.

Configure Transformation

ضمن Transformation code، حرّر المعالج لتنسيق الأحداث بما يتوافق مع Track API الخاص بـ Customer.io. ابدأ من الأمثلة.

Test & Create

ضمن Test this code، انقر على Simulate لتشغيل المعالج باستخدام حمولة نموذجية. ثم انقر على Create endpoint.

Done

تصل الأحداث المشترَك فيها الآن إلى Customer.io، حيث يمكنها تشغيل عمليات أتمتة البريد الإلكتروني الخاصة بك.

أمثلة على Transformation Code

يرسل كل معالج طلبًا واحدًا إلى نقطة نهاية Track API v2 ‏entity ويعرّف الشخص باستخدام customer_id الخاص به في Dodo Payments. لتسجيل حدث، يعيّن الطلب action إلى event ويضع اسم الحدث في name. لتحديث سمات شخص، يعيّن action إلى identify. تكون مبالغ Dodo Payments بوحدة العملة الأصغر، لذلك تقسم الأمثلة القيمة على 100.

تتبّع أحداث الدفع

سجّل حدث payment_completed عند نجاح عملية الدفع:

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;
}

تتبّع دورة حياة الاشتراك

سجّل حدث subscription_started عندما يصبح الاشتراك نشطًا، وحدث subscription_cancelled عند إلغائه:

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;
}

تتبّع سمات العميل

حدّث سمات ملف الشخص الشخصي عند نجاح عملية الدفع. يستبدل كل طلب identify السمات التي يرسلها، لذلك يحتفظ last_payment_amount وlast_payment_date دائمًا بأحدث عملية دفع.

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;
}

تلميحات

استخدم أسماء الأحداث نفسها في التحويل وفي مشغّلات حملات Customer.io، مثل payment_completed. اختر أسماء تصف ما حدث.
أدرج السمات التي تستخدمها رسائلك للتخصيص.
عرّف كل شخص باستخدام المعرّف نفسه في كل طلب. تستخدم الأمثلة customer_id الخاص بـ Dodo Payments.
للاطلاع على كل حقل طلب، راجع مرجع Customer.io Track API.

استكشاف الأخطاء وإصلاحها

Events Not Triggering Campaigns

تحقّق من صحة Site ID ومفتاح API.
إذا فشلت عمليات التسليم مع 401، فاضبط ترويسة Authorization على مصادقة Basic، كما هو موضح في البدء.
تحقّق من تطابق أسماء الأحداث مع مشغّلات حملات Customer.io.
تحقّق من تعيين معرّفات العملاء.
راجع حدود معدل Customer.io API.

Transformation Errors

تحقّق من توافق الحمولة مع تنسيق Customer.io API.
تحقّق من وجود جميع الحقول المطلوبة، ومن أن action يمثل إجراءً يدعمه Track API، مثل event أو identify.
تحقّق من تنسيق أسماء الأحداث والسمات بشكل صحيح.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

المقدمة

البدء

أمثلة على Transformation Code

تتبّع أحداث الدفع

تتبّع دورة حياة الاشتراك

تتبّع سمات العميل

تلميحات

استكشاف الأخطاء وإصلاحها

​المقدمة

​البدء

​أمثلة على Transformation Code

​تتبّع أحداث الدفع

​تتبّع دورة حياة الاشتراك

​تتبّع سمات العميل

​تلميحات

​استكشاف الأخطاء وإصلاحها

المقدمة

البدء

أمثلة على Transformation Code

تتبّع أحداث الدفع

تتبّع دورة حياة الاشتراك

تتبّع سمات العميل

تلميحات

استكشاف الأخطاء وإصلاحها