Skip to content
GROWTH DEPT.MTA
DocsConnections: Rokt

Connections

Rokt connection

Connect Rokt with personal API credentials to pull spend, referrals and Rokt's own conversions by creative for every account the credentials reach.

What it reads

For each Rokt account the credentials reach, Growth Dept MTA reads spend, impressions and referrals (Rokt's clicks) by creative and day, with campaigns and creatives. Rokt has no ad set level. Dates follow the account's time zone and amounts its currency. Campaign and creative names come from the report rows, since Rokt's API does not list campaigns or creatives on their own.

Rokt's conversions come in with each day's spend, under the account's attribution settings: by default 7 days after a click and 1 day after a view. Rokt dates a conversion by the referral that led to it, so recent days keep rising until that window closes. View-through conversions, which Rokt reports without a value, are read too, and Rokt's acquisitions and conversions, by click and by view, fill the Rokt platform-reported columns.

A pull runs about once an hour and re-reads the last 7 days, and a nightly pull re-reads the last 30. Each pull replaces the rows for its window, so days that Rokt restates end up matching Rokt. Spend is converted to the brand's currency as it arrives, at the European Central Bank rate for each day.

Connecting

Rokt connects with credentials you paste instead of a sign-in screen.

  1. In Rokt One Platform, open Profile Settings > Generate Personal API Credentials, name the app, and copy the App ID and App Secret. Rokt shows the secret once.
  2. Sign in to Growth Dept MTA as an owner or admin of the brand's organization. Other members can see Settings > Connections but cannot change it.
  3. Open Settings > Connections. On the Rokt card, paste them into Rokt App ID and Rokt App Secret, then click Connect.
  4. Growth Dept MTA checks them with one small read on Rokt. If Rokt accepts them, they are stored encrypted, every account they reach appears on the card, and a backfill starts over the brand's lookback window (Settings > Lookback window), or as far back as Rokt keeps data if that is shorter. If the check fails, the form shows the error and nothing is saved.

The credentials belong to the Rokt user who made them, so they stop working if that user loses access to Rokt. If no one at the brand has One Platform access, ask your Rokt account manager to add you.

To replace the credentials, for example before a token ends, paste the new ones into the same form. The connection keeps its data and carries on with the new ones.

If you have been sending Rokt spend through the spend API or a spreadsheet, remove those rows before you connect. They carry their own account ID, so they would be counted on top of the connected account's spend. Settings > Data Spreadsheets lists each upload. Once the connection is live, the spend API and spreadsheets refuse new Rokt rows.

Tracking parameters

The UTM guide has no Rokt entry. Where Rokt ads link to your site, tag those links with the guide's template for other platforms, with utm_source=rokt and utm_medium=paid, so the visits count as paid traffic from Rokt.

Template
utm_source=<platform>&utm_medium=<paid, email, sms, affiliate or influencer>&utm_campaign=<campaign>&utm_term=<ad set>&utm_content=<ad>

Replace each <placeholder> with the platform's own macro for it, or with a fixed value.

Limits

  • There are no hourly rows and no thumbnails.
  • The newest days' conversions keep rising until the attribution window closes, a week by default, because late conversions are dated back to their referrals.
  • Rokt's conversions are Rokt's own credit and are not part of Growth Dept MTA's attribution.
  • Growth Dept MTA only reads from Rokt. It does not change campaigns, budgets or ads.

Disconnecting

Each linked account has its own Disconnect button in its row on the Rokt card. Only owners and admins can use it. After you confirm:

  • Syncing for that account stops.
  • The stored App ID and App Secret is deleted.
  • Data already pulled stays in your reports.

Connecting the account again later starts a new backfill.

All connections · API docs · Questions: support@growthdept.ai