Crea un'attribuzione

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

Registra una risposta di attribuzione self-reported. Usa questo Endpoint per tracciare come i clienti hanno scoperto il tuo brand — da AI search, organico, social, annunci, referral o qualsiasi canale personalizzato. Richiede lo Scope write sulla tua API Key.

string

obbligatorio

L’ID del progetto.

string

obbligatorio

Identificatore del canale di attribuzione. Usa gli ID standard come ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content, oppure una stringa personalizzata qualsiasi.

string

Indirizzo email del lead.

string

Nome completo del lead.

string

ID esterno proveniente dal tuo CRM o dal tuo sistema.

number

Importo di ricavo attribuito a questo lead.

string

predefinito:"USD"

Codice valuta ISO.

string

Identificatore del form di origine (es. form_id di Typeform, ID del form HubSpot).

string

URL della pagina in cui è stato inviato il form.

object

Dati personalizzati aggiuntivi come coppie chiave-valore.

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

Elenca le attribuzioni Riepilogo delle attribuzioni

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Crea un'attribuzione