Pomoc/Atrybucja przychodów
Atrybucja przychodów

Atrybucja przychodów z Dodo Payments

Zanim przejdziesz dalej, upewnij się, że masz zainstalowany skrypt śledzenia Flowsery.

1. Zapisz identyfikator odwiedzającego Flowsery przy płatności

Jeśli masz dostęp do plików cookie Flowsery, odczytaj _fs_vid i opcjonalnie _fs_sid podczas tworzenia sesji płatności, aby przekazać je później jako visitorUid i sessionUid.

2. Utwórz dane uwierzytelniające API Flowsery

Wygeneruj klucz API witryny w sekcji Klucze stron na stronie Tokeny API. Klucze witryn zaczynają się od flow_ i są od razu przypisane do jednej witryny, dlatego to najprostsza opcja dla tego webhooka płatności.

Jeśli zamiast tego użyjesz tokena API obszaru roboczego z sekcji Tokeny API, będzie się on zaczynał od flow_ws_ i da dostęp do wszystkich witryn w obszarze roboczym. Korzystając z tokena obszaru roboczego, dodaj websiteId lub domain do danych wysyłanych do Payment API.

3. Przekazuj udane płatności do Payment API Flowsery

JavaScript
function handler(webhook) {
  if (webhook.eventType !== 'payment.succeeded') {
    return null;
  }
 
  const payment = webhook.payload.data;
 
  webhook.url = 'https://analytics.flowsery.com/analytics/api/v1/payments';
  webhook.payload = {
    // Required only when you authenticate with a workspace token.
    websiteId: process.env.FLOWSERY_WEBSITE_ID,
    amount: payment.total_amount / 100,
    currency: payment.currency,
    transactionId: payment.payment_id,
    visitorUid: payment.metadata?._fs_vid,
    sessionUid: payment.metadata?._fs_sid,
    email: payment.customer?.email,
    name: payment.customer?.name,
    customerId: payment.customer?.id,
  };
 
  return webhook;
}

Używaj dokładnie takich nazw pól, jakie ma Payment API Flowsery. _fs_vid to tylko źródło wartości visitorUid, a nie nazwa pola w API.