Webhook-Ereignisse und Payloads - Topsort Documentation

Unten ist ein Beispiel für eine Webhook-Ereignisantwort für eine Kampagnenaktualisierung. Die gemeinsamen Felder für alle Ereignisse sind:

channel: Der Ereignistyp, der aufgetreten ist
timestamp: Wann das Ereignis aufgetreten ist
id: Eindeutige Kennung für das Ereignis, die für Deduplizierung verwendet werden kann
payload: Die Payload enthält die Ereignisdetails und variiert je nach Ereignis, was unten ausführlich behandelt wird

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

Kampagnenerstellung

Wird ausgelöst, wenn eine Kampagne erstellt wird. Für die vollständige Payload-Spezifikation siehe die Campaign Create API-Antwort.

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

Kampagnenaktualisierung

Wird ausgelöst, wenn eine Kampagne aktualisiert wird. Für die vollständige Payload-Spezifikation siehe die Campaign Update by ID API-Antwort.

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

Kampagnenlöschung

Wird ausgelöst, wenn eine Kampagne gelöscht wird.

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

​Kampagnenerstellung

​Kampagnenaktualisierung

​Kampagnenlöschung

Kampagnenerstellung

Kampagnenaktualisierung

Kampagnenlöschung