Customer.io

Einführung

Die Customer.io-Integration sendet Dodo Payments-Ereignisse an die Track API von Customer.io, sodass Zahlungen und Änderungen an Abonnements Kampagnen und Kundenreisen auslösen können. Beispielsweise kann ein neuer Kunde eine Willkommens-E-Mail erhalten, eine Abonnementänderung eine Aktualisierung senden und eine fehlgeschlagene Zahlung eine Benachrichtigung auslösen.

Für diese Integration benötigen Sie Ihre Customer.io Site ID und Ihren API-Schlüssel. Die Track API verwendet HTTP Basic authentication, wobei die Site ID als Benutzername und der API-Schlüssel als Passwort verwendet wird.

Erste Schritte

Open the Webhook Section

Gehen Sie im Dodo Payments-Dashboard zu Developer → Webhooks und klicken Sie auf Add endpoint.

Add endpoint dialog with CustomerIO selected in the Integration dropdown

Select Customer.io

Wählen Sie unter Integration die Option CustomerIO aus.

Enter Credentials

Fügen Sie unter API key Ihren Customer.io-API-Schlüssel ein. Dodo Payments sendet den Schlüssel im Authorization-Header als Bearer-Token.Die Track API erwartet Basic authentication. Wenn Übermittlungen mit einem 401 fehlschlagen, öffnen Sie den Tab Advanced des Endpoints und ersetzen Sie den Authorization-Header durch Basic, gefolgt von der Base64-Kodierung von site_id:api_key.

Select Events

Wählen Sie unter Subscribed events die Ereignisse aus, die Ihre Transformation verarbeitet. Die Beispiele auf dieser Seite verwenden payment.succeeded, subscription.active und subscription.cancelled.

Configure Transformation

Bearbeiten Sie unter Transformation code den Handler, um Ereignisse für die Track API von Customer.io zu formatieren. Beginnen Sie mit den Beispielen.

Test & Create

Klicken Sie unter Test this code auf Simulate, um den Handler mit einer Beispiel-Payload auszuführen. Klicken Sie anschließend auf Create endpoint.

Done

Ab jetzt erreichen abonnierte Ereignisse Customer.io, wo sie Ihre E-Mail-Automatisierungen auslösen können.

Beispiele für Transformationscode

Jeder Handler sendet eine Anfrage an den Track API v2-Endpoint entity und identifiziert die Person anhand von Dodo Payments customer_id. Um ein Ereignis aufzuzeichnen, setzt die Anfrage action auf event und verwendet den Ereignisnamen in name. Um die Attribute einer Person zu aktualisieren, setzt sie action auf identify. Die Beträge von Dodo Payments werden in der kleinsten Währungseinheit angegeben, daher teilen die Beispiele durch 100.

Zahlungen verfolgen

Zeichnen Sie ein payment_completed-Ereignis auf, wenn eine Zahlung erfolgreich ist:

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

Abonnementlebenszyklus verfolgen

Zeichnen Sie ein subscription_started-Ereignis auf, wenn ein Abonnement aktiv wird, und ein subscription_cancelled-Ereignis, wenn es gekündigt wird:

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

Kundenattribute verfolgen

Aktualisieren Sie die Profilattribute der Person, wenn eine Zahlung erfolgreich ist. Jede identify-Anfrage überschreibt die von ihr gesendeten Attribute, sodass last_payment_amount und last_payment_date immer die aktuellste Zahlung enthalten.

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

Tipps

Verwenden Sie dieselben Ereignisnamen in der Transformation und in den Triggern Ihrer Customer.io-Kampagnen, zum Beispiel payment_completed. Wählen Sie Namen, die beschreiben, was passiert ist.
Fügen Sie die Attribute ein, die Ihre Nachrichten zur Personalisierung verwenden.
Identifizieren Sie jede Person in jeder Anfrage mit derselben ID. Die Beispiele verwenden Dodo Payments customer_id.
Eine Beschreibung aller Anfragefelder finden Sie in der Customer.io Track API-Referenz.

Fehlerbehebung

Events Not Triggering Campaigns

Überprüfen Sie, ob die Site ID und der API-Schlüssel korrekt sind.
Wenn Übermittlungen mit einem 401 fehlschlagen, setzen Sie den Authorization-Header auf Basic authentication, wie unter Erste Schritte beschrieben.
Überprüfen Sie, ob die Ereignisnamen mit den Triggern Ihrer Customer.io-Kampagnen übereinstimmen.
Überprüfen Sie, ob Kundenidentifikatoren festgelegt sind.
Überprüfen Sie die API-Ratenlimits von Customer.io.

Transformation Errors

Überprüfen Sie, ob die Payload dem API-Format von Customer.io entspricht.
Überprüfen Sie, ob alle erforderlichen Felder vorhanden sind und ob action eine von der Track API unterstützte Aktion ist, beispielsweise event oder identify.
Überprüfen Sie, ob Ereignisnamen und Attribute korrekt formatiert sind.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Einführung

Erste Schritte

Beispiele für Transformationscode

Zahlungen verfolgen

Abonnementlebenszyklus verfolgen

Kundenattribute verfolgen

Tipps

Fehlerbehebung

​Einführung

​Erste Schritte

​Beispiele für Transformationscode

​Zahlungen verfolgen

​Abonnementlebenszyklus verfolgen

​Kundenattribute verfolgen

​Tipps

​Fehlerbehebung

Einführung

Erste Schritte

Beispiele für Transformationscode

Zahlungen verfolgen

Abonnementlebenszyklus verfolgen

Kundenattribute verfolgen

Tipps

Fehlerbehebung