Crear atribución

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 respuesta de atribución autodeclarada. Úsalo para saber cómo descubrieron tu marca tus clientes: desde búsqueda con IA, orgánico, social, anuncios, referidos o cualquier canal personalizado. Requiere el Scope write en tu API Key.

string

requerido

El ID del proyecto.

string

requerido

Identificador del canal de atribución. Usa IDs estándar como ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content, o cualquier cadena personalizada.

string

Email del lead.

string

Nombre completo del lead.

string

ID externo de tu CRM o sistema.

number

Importe de ingresos atribuido a este lead.

string

predeterminado:"USD"

Código de moneda ISO.

string

Identificador del formulario de origen (p. ej. form_id de Typeform, ID de formulario de HubSpot).

string

URL de la página donde se envió el formulario.

object

Datos personalizados adicionales como pares clave-valor.

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

Listar atribuciones Obtener resumen de atribución

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Export

Attribution

Crear atribución