Créer une 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"
  }
}

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

Enregistrez une réponse d’attribution auto-déclarée. Utilisez cet Endpoint pour savoir comment vos clients ont découvert votre marque — via la recherche IA, le trafic organique, les réseaux sociaux, la publicité, les recommandations ou tout canal personnalisé. Nécessite le Scope write sur votre clé API.

string

requis

L’ID du projet.

string

requis

Identifiant du canal d’attribution. Utilisez des ID standard comme ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content, ou toute chaîne personnalisée.

string

Adresse e-mail du lead.

string

Nom complet du lead.

string

ID externe issu de votre CRM ou de votre système.

number

Montant de revenu attribué à ce lead.

string

défaut:"USD"

Code de devise ISO.

string

Identifiant du formulaire source (p. ex. form_id Typeform, ID de formulaire HubSpot).

string

URL de la page où le formulaire a été soumis.

object

Données personnalisées supplémentaires sous forme de paires clé-valeur.

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

Lister les attributions Résumé des attributions

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Créer une attribution