Singular

Rokt Events Connection via Singular

This guide provides a straightforward process for integrating Rokt Events with Singular. It covers the event integration only.

note

You will need an API Key from your Rokt team.

1. Navigate to https://app.singular.net and log in.
2. Click Attribution Setup in the left hand menu.
3. Click Partner Configuration.
4. Click in the search bar.
5. Search Rokt.
6. Click Select an app to choose the app to integrate events from.
7. Choose the app you are integrating data from.
8. Click the Token field.
9. Enter the API Key provided by your Rokt account manager.
10. Leave "Enable Rokt Legacy Integration" unchecked. This setting is disabled by default. Rokt recommends using the standard (non-legacy) Rokt integration as it provides improved handling of user identity, device information, and user attributes. If your implementation specifically requires the legacy integration, contact your Rokt account manager before enabling this setting.
11. For the Install event, click Send All to integrate unfiltered data.
12. Click Next.
13. Click Select under Revenue Events Postbacks.
14. Choose which in-app events you want to integrate (e.g. registration, purchase).
15. Configure the events you want to integrate.
16. Click Send All to integrate unfiltered events.
17. Repeat for all necessary events.
18. Click Save.

Passing hashed email to Rokt

To improve match rates and enable Rokt to receive a hashed email, you can include it as a standard event attribute on the events you send to Singular. Singular provides a standardized, pre-configured attribute name (ehash) that works across its Conversion API integrations.

To pass a hashed email with your Singular events:

1. Normalize the user's email address by converting it to lowercase and removing any leading or trailing whitespace, then hash the email address using SHA-256.
2. When logging the conversion event in the Singular SDK, add the hashed email as a standard event attribute using the exact key name ehash. Event attribute names are case sensitive, so the key must be entered exactly as ehash. Learn more about standard event attributes on Singular's website.
3. Confirm with your Rokt account manager that hashed emails are being received correctly.