Attribution erstellen

curl --request POST \
  --url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "channelId": "ai_search",
    "respondentEmail": "jane@company.com",
    "respondentName": "Jane Smith",
    "dealValue": 12000,
    "dealCurrency": "EUR",
    "formId": "signup_form_v2",
    "pageUrl": "https://example.com/signup"
  }'

{
  "data": {
    "id": "a1b2c3d4-...",
    "channel_id": "ai_search",
    "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
    "channel_category": "ai_search",
    "respondent_email": "jane@company.com",
    "deal_value": 12000,
    "source": "api",
    "created_at": "2026-03-15T10:30:00Z"
  }
}

POST

projects

{projectId}

attribution

curl --request POST \
  --url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "channelId": "ai_search",
    "respondentEmail": "jane@company.com",
    "respondentName": "Jane Smith",
    "dealValue": 12000,
    "dealCurrency": "EUR",
    "formId": "signup_form_v2",
    "pageUrl": "https://example.com/signup"
  }'

{
  "data": {
    "id": "a1b2c3d4-...",
    "channel_id": "ai_search",
    "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
    "channel_category": "ai_search",
    "respondent_email": "jane@company.com",
    "deal_value": 12000,
    "source": "api",
    "created_at": "2026-03-15T10:30:00Z"
  }
}

Erfasse eine selbstberichtete Attributionsantwort. Damit trackst du, wie Kunden deine Brand entdeckt haben — über AI Search, Organic, Social, Ads, Referrals oder einen beliebigen eigenen Kanal. Benötigt den write-Scope auf deinem API-Key.

projectId

string

erforderlich

Die Projekt-ID.

channelId

string

erforderlich

ID des Attributionskanals. Nutze Standard-IDs wie ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content — oder einen beliebigen eigenen String.

respondentEmail

string

E-Mail-Adresse des Leads.

respondentName

string

Vollständiger Name des Leads.

respondentExternalId

string

Externe ID aus deinem CRM oder System.

dealValue

number

Umsatzbetrag, der diesem Lead zugeordnet wird.

dealCurrency

string

Standard:"USD"

ISO-Währungscode.

formId

string

ID des Quell-Formulars (z. B. Typeform form_id, HubSpot-Formular-ID).

pageUrl

string

URL der Seite, auf der das Formular abgeschickt wurde.

metadata

object

Zusätzliche eigene Daten als Key-Value-Paare.

curl --request POST \
  --url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
  --header 'Authorization: Bearer sk_live_xxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "channelId": "ai_search",
    "respondentEmail": "jane@company.com",
    "respondentName": "Jane Smith",
    "dealValue": 12000,
    "dealCurrency": "EUR",
    "formId": "signup_form_v2",
    "pageUrl": "https://example.com/signup"
  }'

{
  "data": {
    "id": "a1b2c3d4-...",
    "channel_id": "ai_search",
    "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
    "channel_category": "ai_search",
    "respondent_email": "jane@company.com",
    "deal_value": 12000,
    "source": "api",
    "created_at": "2026-03-15T10:30:00Z"
  }
}

Attributionen auflisten Attributions-Zusammenfassung abrufen

Projekte

Prompts

Metriken

Wettbewerber

Quellen

Tags

Fan-outs

Export

Attribution

Attribution erstellen