Segment

Introduktion

Segment-integrationen skickar Dodo Payments-händelser till Segments HTTP Tracking API som Track- och Identify-anrop. Segment vidarebefordrar sedan betalnings-, prenumerations- och kunddata till de analys-, marknadsförings- och datalagerverktyg som är anslutna till din arbetsyta, från en katalog med över 300 destinationer.

Den här integrationen kräver Write Key för en HTTP API-källa i din Segment-arbetsyta. Du behöver också åtkomst till Developer → Webhooks i Dodo Payments-instrumentpanelen.

Komma igång

Open the Webhook Section

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

Dialogrutan Add endpoint med Segment valt i rullgardinsmenyn Integration och stegen How to connect Segment

Select Segment

Under Integration väljer du Segment. Instrumentpanelen fyller i Endpoint URL och transformationskoden för Segment.

Enter Write Key

I Segment går du till Connections → Sources och öppnar eller skapar en HTTP API-källa. Kopiera Write Key från källans inställningar och klistra in den i API key.

Select Events

Under Subscribed events väljer du endast de händelser som din transformation hanterar. Exemplen på den här sidan använder payment.succeeded, subscription.active och subscription.cancelled.

Configure Transformation

Under Transformation code redigerar du hanteraren så att händelser formateras för Segments Track- eller Identify API. Börja med exemplen.

Test & Create

Under Test this code väljer du en händelsetyp och klickar på Simulate för att förhandsvisa anropet till Segment. Klicka sedan på Create endpoint.

Switch to Basic Authentication

Dodo Payments skickar värdet för API key som en bearer-token, men Segments HTTP API accepterar en Write Key via Basic-autentisering eller ett writeKey-fält i brödtexten. Direkt efter att du har skapat endpointen öppnar du fliken Advanced. Under Custom headers anger du ett nytt värde på den dolda raden Authorization: Basic, ett mellanslag och Base64-kodningen av din Write Key med ett kolon tillagt. Klicka sedan på Save. Till exempel skriver echo -n 'YOUR_WRITE_KEY:' | base64 ut det kodade värdet.

Done

Prenumererade händelser når nu Segment, som vidarebefordrar dem till dina anslutna destinationer.

Exempel på transformationskod

Varje hanterare anger webhook.url till en Segment API-endpoint och ersätter webhook.payload med anropet. Dodo Payments-belopp anges i den minsta valutaenheten, så exemplen dividerar med 100. För valutor utan decimaler, som JPY och KRW, använder du beloppet som det är.

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

Spåra prenumerationens livscykel

Registrera händelserna Subscription Started och Subscription Cancelled:

track_subscriptions.js

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

Identifiera kundegenskaper

Uppdatera kundens egenskaper efter varje lyckad betalning. Varje Identify-anrop anger egenskaperna till de värden som det skickar, så dessa egenskaper beskriver den senaste betalningen:

identify_customer.js

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,
        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 konsekventa händelsenamn i hela din integration, till exempel Segments objekt- och åtgärdsformat i Payment Completed.
Inkludera de egenskaper du behöver för analys och segmentering.
Ange timestamp från händelsens timestamp, så att Segment registrerar när händelsen inträffade och inte när den togs emot.
Använd Dodo Payments customer_id som userId, så att varje anrop för en kund kopplas till samma Segment-användare.

Felsökning

Events Not Appearing in Segment

Kontrollera att Write Key tillhör en HTTP API-källa och att Authorization-headern använder Basic-autentisering.
Segment returnerar 200 för de flesta förfrågningar, inklusive sådana som inte accepteras, så en lyckad leverans i Dodo Payments-loggarna bevisar inte att händelsen nådde fram. Kontrollera källans Debugger i Segment.
Kontrollera att händelsenamnen följer Segments namnkonventioner.
Kontrollera att varje anrop anger userId. Segment avvisar ett anrop som varken har en userId eller en anonymousId.
Kontrollera Segments hastighetsbegränsningar för HTTP API. Segment rekommenderar att du håller dig under 1 000 förfrågningar per sekund per arbetsyta.
Om din arbetsyta använder Segments EU-region skickar du anrop till https://events.eu1.segmentapis.com/v1/track och https://events.eu1.segmentapis.com/v1/identify i stället.

Transformation Errors

Kontrollera att nyttolasten matchar Segments API-format.
Kontrollera att alla obligatoriska fält finns med. Track kräver event, och både Track och Identify kräver en userId eller en anonymousId.
Kontrollera att händelsenamnen är strängar, inte objekt.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Komma igång

Exempel på transformationskod

Spåra betalningshändelser

Spåra prenumerationens livscykel

Identifiera kundegenskaper

Tips

Felsökning

​Introduktion

​Komma igång

​Exempel på transformationskod

​Spåra betalningshändelser

​Spåra prenumerationens livscykel

​Identifiera kundegenskaper

​Tips

​Felsökning

Introduktion

Komma igång

Exempel på transformationskod

Spåra betalningshändelser

Spåra prenumerationens livscykel

Identifiera kundegenskaper

Tips

Felsökning