Eventos y payloads de Webhook - Topsort Documentation

Ejemplo de respuesta de evento

A continuación se muestra un ejemplo de una respuesta de evento de webhook para una actualización de campaña. Los campos comunes para todos los eventos son:

channel: El tipo de evento que ocurrió
timestamp: Cuándo ocurrió el evento
id: ID único para el evento que se puede usar para deduplicación
payload: El payload contiene los detalles del evento y variará según el evento, lo cual se cubre en detalle a continuación

{
  "channel": "campaign:update",
  "timestamp": "2024-10-31T14:42:55.759185Z",
  "id": "gUo",
  "payload": {
    "name": "My campaign",
    "campaign_id": "edac69a3-3ca2-41d6-af9e-08d3126099b4"
  }
}

Creación de campaña

Se activa cuando se crea una campaña. Para ver la especificación completa del payload, consulte la respuesta de la API Campaign Create.

{
  "channel": "campaign:create",
  "timestamp": "2024-10-31T14:42:55.759185Z",
  "id": "gUo",
  "payload": {
    "name": "My campaign",
    "campaign_id": "edac69a3-3ca2-41d6-af9e-08d3126099b4"
  }
}

Actualización de campaña

Se activa cuando se actualiza una campaña. Para ver la especificación completa del payload, consulte la respuesta de la API Campaign Update.

{
  "channel": "campaign:update",
  "timestamp": "2024-10-31T14:42:55.759185Z",
  "id": "gUo",
  "payload": {
    "name": "My new campaign name",
    "campaign_id": "edac69a3-3ca2-41d6-af9e-08d3126099b4"
  }
}

Eliminación de campaña

Se activa cuando se elimina una campaña.

{
  "channel": "campaign:delete",
  "timestamp": "2024-10-31T14:42:55.759185Z",
  "id": "gUo",
  "payload": {
    "name": "My campaign",
    "ad_format": "listing",
    "vendor_id": "2355d342-222e-4dc9-af92-81c3865b3b66",
    "campaign_id": "edac69a3-3ca2-41d6-af9e-08d3126099b4",
    "campaign_type": "autobidding",
    "marketplace_id": "ad666c53-b174-497a-b52f-77354947456c"
  }
}

​Ejemplo de respuesta de evento

​Creación de campaña

​Actualización de campaña

​Eliminación de campaña

Ejemplo de respuesta de evento

Creación de campaña

Actualización de campaña

Eliminación de campaña