Customer.io

Introduktion

Customer.io-integrationen skickar Dodo Payments-händelser till Customer.ios Track API, så att betalningar och prenumerationsändringar kan utlösa kampanjer och kundresor. En ny kund kan till exempel få ett välkomstmeddelande, en prenumerationsändring kan skicka en uppdatering och en misslyckad betalning kan skicka en avisering.

Den här integrationen kräver ditt Customer.io Site ID och din API-nyckel. Track API använder HTTP Basic authentication, med Site ID som användarnamn och API-nyckeln som lösenord.

Komma igång

Open the Webhook Section

I Dodo Payments-instrumentpanelen går du till Developer → Webhooks och klickar på Add endpoint.

Add endpoint dialog with CustomerIO selected in the Integration dropdown

Select Customer.io

Välj CustomerIO under Integration.

Enter Credentials

Klistra in din Customer.io API-nyckel i API key. Dodo Payments skickar nyckeln i Authorization-headern som en bearer token.Track API förväntar sig Basic authentication. Om leveranser misslyckas med en 401 öppnar du endpointens flik Advanced och ersätter Authorization-headern med Basic följt av Base64-kodningen av site_id:api_key.

Select Events

Välj de händelser som din transformation hanterar under Subscribed events. Exemplen på den här sidan använder payment.succeeded, subscription.active och subscription.cancelled.

Configure Transformation

Redigera hanteraren under Transformation code så att händelser formateras för Customer.ios Track API. Börja med exemplen.

Test & Create

Klicka på Simulate under Test this code för att köra hanteraren mot en exempelpayload. Klicka sedan på Create endpoint.

Done

Prenumererade händelser når nu Customer.io, där de kan utlösa dina e-postautomatiseringar.

Exempel på transformationskod

Varje hanterare skickar en begäran till Track API v2 entity-endpointen och identifierar personen med deras Dodo Payments customer_id. Om du vill registrera en händelse anger begäran action till event och placerar händelsenamnet i name. Om du vill uppdatera en persons attribut anger den action till identify. Belopp i Dodo Payments anges i den minsta valutaenheten, så exemplen dividerar med 100.

Spåra betalningshändelser

Registrera en payment_completed-händelse när en betalning lyckas:

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

Spåra prenumerationens livscykel

Registrera en subscription_started-händelse när en prenumeration blir aktiv och en subscription_cancelled-händelse när den avslutas:

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

Spåra kundattribut

Uppdatera personens profilattribut när en betalning lyckas. Varje identify-begäran skriver över attributen som den skickar, så last_payment_amount och last_payment_date innehåller alltid den senaste betalningen.

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

Använd samma händelsenamn i transformationen och i utlösarna för dina Customer.io-kampanjer, till exempel payment_completed. Välj namn som beskriver vad som har hänt.
Inkludera de attribut som dina meddelanden använder för personalisering.
Identifiera varje person med samma ID i varje begäran. Exemplen använder Dodo Payments customer_id.
Se referensen för Customer.io Track API för varje begärandefält.

Felsökning

Events Not Triggering Campaigns

Kontrollera att Site ID och API-nyckeln är korrekta.
Om leveranser misslyckas med en 401 anger du Basic authentication i Authorization-headern, enligt beskrivningen i Kom igång.
Kontrollera att händelsenamnen matchar utlösarna för dina Customer.io-kampanjer.
Kontrollera att kundidentifierare har angetts.
Granska Customer.io:s API-begränsningar.

Transformation Errors

Kontrollera att payloaden matchar Customer.io API-formatet.
Kontrollera att alla obligatoriska fält finns och att action är en åtgärd som Track API stöder, till exempel event eller identify.
Kontrollera att händelsenamn och attribut är korrekt formaterade.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Komma igång

Exempel på transformationskod

Spåra betalningshändelser

Spåra prenumerationens livscykel

Spåra kundattribut

Tips

Felsökning

​Introduktion

​Komma igång

​Exempel på transformationskod

​Spåra betalningshändelser

​Spåra prenumerationens livscykel

​Spåra kundattribut

​Tips

​Felsökning

Introduktion

Komma igång

Exempel på transformationskod

Spåra betalningshändelser

Spåra prenumerationens livscykel

Spåra kundattribut

Tips

Felsökning