Receive engagement events in your own analytics

Capture what members watch and do inside Genuin views as events in your own analytics: live from the SDKs, and in batches to your warehouse.

Genuin records an event for what members do in its views: views, plays, searches, joins, posts, comments, shares, and app actions. You can receive them two ways. The SDKs expose a callback that fires as events are recorded, for your in-app analytics. Brand Control Center exports the full event history to a warehouse on a schedule, for reporting and joins with your own data. When you finish, Genuin events arrive in your analytics tool from the SDK, and your warehouse receives the history.

Before you begin

• A Genuin view in your product: a Web SDK embed, or the iOS or Android SDK. See Embed the Genuin Web SDK on your website, Integrate the Genuin iOS SDK, and Integrate the Genuin Android SDK.
• An analytics destination with a track(name, properties) style call, such as your product analytics tool.
• For the warehouse export: Create or Edit permission on Settings > Data Sources in Brand Control Center, and a BigQuery dataset, an S3 bucket, or a Mixpanel project.

Step 1: Subscribe to events in the SDK

Each SDK has one hook that fires with the event name and its properties. Forward both to your tool.

window.genuin.on("onAnalyticsTrack", (event) => {
  const { eventName, eventPayload } = event.payload;
  analytics.track(eventName, eventPayload);
});

import GenuinCore

extension AppDelegate: GenuinAnalyticsDelegate {
    func onAnalyticsEvent(eventName: String, properties: [String: Any]) {
        Analytics.track(eventName, properties: properties)
    }
}

// After GenuinSDK.shared.initialize(...):
GenuinSDK.shared.analyticsDelegate = self

import com.begenuin.core.GenuinSDK
import com.begenuin.core.core.interfaces.GenuinEventCallback

GenuinSDK.registerEventCallback(object : GenuinEventCallback {
  override fun onEventCallback(name: String, properties: HashMap<String, Any>) {
    Analytics.track(name, properties)
  }
})

The callbacks fire for the events the SDK itself records, so you see the same activity Genuin's reports are built on, as it happens, for the member using your app.

Step 2: Forward with your own identity

Genuin identifies the member by its own account. When members sign in through Auto Login or single sign-on, you already know who they are, so attach your user id to the forwarded event in your tool. That lets you join Genuin events with the rest of a user's journey in your product. See Choose how members sign in to the Genuin SDK.

Step 3: Export the history to your warehouse

The SDK hooks only see one member on one device. For every member, every surface, and the past, connect a data source in Brand Control Center under Settings > Data Sources. Rows arrive in batches on the daily, weekly, or monthly schedule you pick.

Step 4: Run a first query

Once BigQuery is connected, see which events your communities produce before building reports on them. Replace project_id.dataset_name with your Dataset ID.

SELECT
  DATE(_timestamp) AS day,
  event,
  COUNT(*) AS events
FROM `project_id.dataset_name.genuin_data`
WHERE _timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
GROUP BY day, event
ORDER BY day DESC, events DESC;

The master_* columns are joined from Genuin's own records, so filters such as WHERE master_community_handle = 'trail-runners' work without a second table. Run SELECT column_name FROM project_id.dataset_name.INFORMATION_SCHEMA.COLUMNS WHERE table_name = 'genuin_data' to list every column.

Limitations

• SDK hooks are per device and per session. They fire only while a Genuin view or screen is on screen in your app or page.
• Exports are batch, not real time. The schedule is daily, weekly, or monthly; a day of events arrives on the next run.
• Event names aren't published as a list. Discover them with the query above, and expect new ones with product releases.
• One warehouse destination of each kind per brand.

See also

• Embed the Genuin Web SDK on your website
• Receive zero-party data in BigQuery
• Query Genuin event data in BigQuery