Skip to content

Event Backfeed

Description

Kumulos can send a feed of the raw analytics events from your app to a webhook of your choosing, so you can perform granular analysis of user behaviour in your own tools and systems.

By default all your custom analytics events along with the following system generated events will be forwarded on a configurable interval.

The authentication strategy, wrapper payload, batch size and feed interval are all configurable, and the feed can be enabled by contacting support. Please note that there may be an additional charge for this, depending on the volume of events, which we will discuss with you.

Event Samples

The following sample demonstrates a single example of each system event.

{
  "appId": 1,
  "events": [
    {
      "type": "app.installed",
      "uuid": "82cbd2b8-f06e-41c3-8a1e-cadb392a2b7c",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-1"
    },
    {
      "type": "app.foregrounded",
      "uuid": "4151b460-a988-48da-90fd-7d54dffa4dbd",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-1"
    },
    {
      "type": "user.associated",
      "uuid": "9e264548-0f9c-4535-9224-16668796b9d7",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1"
    },
    {
      "type": "user.unassociated",
      "uuid": "4a85623d-c8fb-4529-a3a9-9694663e1f41",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-1"
    },
    {
      "type": "push.enabled",
      "uuid": "bb9df063-43ec-4cff-ab40-cccf2f2805b5",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-1"
    },
    {
      "type": "push.disabled",
      "uuid": "95439c2d-d864-4b68-afa1-8608fddd4db8",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-2"
    },
    {
      "type": "push.sent",
      "uuid": "21e53358-bbac-4bbf-ad72-1081432355c8",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1",
      "data": {
        "notificationId": 3,
        "messageId": 30,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "push.failed",
      "uuid": "4284a4bc-e947-4a6a-852b-8d56c317d4c6",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1",
      "data": {
        "custom": "yay",
        "notificationId": 5,
        "messageId": 50,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "push.delivered",
      "uuid": "91483a72-3a21-4329-9465-3b971e632c9f",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1",
      "data": {
        "messageId": 90,
        "notificationId": 9,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "push.opened",
      "uuid": "4eeaaa47-31e0-417c-afb4-8664b9dff912",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1",
      "data": {
        "notificationId": 1,
        "messageId": 10,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "push.dismissed",
      "uuid": "364009ed-8711-4336-bec7-e5f33b726583",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-2",
      "data": {
        "messageId": 110,
        "notificationId": 11,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "inApp.subscribed",
      "uuid": "bb9b928d-0ea1-403d-838b-accee4347b29",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-1"
    },
    {
      "type": "inApp.unsubscribed",
      "uuid": "3e1e8ef5-7668-47d7-83e0-c5b95998212c",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1"
    },
    {
      "type": "inApp.sent",
      "uuid": "1b84ef17-f798-443d-9d6b-67f5b1dedffb",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-2",
      "data": {
        "inAppId": 4,
        "messageId": 40,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "inApp.failed",
      "uuid": "b3ae0145-8cf8-49a8-b400-bc406fd40fa2",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-1",
      "userId": "user-1",
      "data": {
        "inAppId": 6,
        "messageId": 60,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "inApp.delivered",
      "uuid": "e44d3e93-db96-4b4b-b22c-4211f8973391",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-2",
      "data": {
        "messageId": 100,
        "inAppId": 10,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "inApp.opened",
      "uuid": "05642648-329b-413c-8680-25dd9417867b",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1",
      "data": {
        "inAppId": 2,
        "messageId": 20,
        "campaignId": "090ecd78-bd00-4dcc-9595-e1bad6a59bb3"
      }
    },
    {
      "type": "deepLink.consumed",
      "uuid": "b3189b6e-7822-437d-a4fc-fadaf9d59eba",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-2",
      "data": {
        "url": "https://example.lnk.click/summer-promotion",
        "wasDeferred": false
      }
    },
    {
      "type": "custom.event",
      "uuid": "f9177eab-fe19-4308-a5cd-e3929d3c3cc8",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-2",
      "data": {
        "foo": "bar"
      }
    },
    {
      "type": "custom.event.two",
      "uuid": "ec4d6885-93b3-40aa-a9ff-8980f840fb4c",
      "happenedAt": "2021-01-01 09:00:00.000",
      "installId": "install-uuid-2",
      "userId": "user-1",
      "data": {
        "bar": "foo"
      }
    }
  ]
}