Welcome

Getting Started

Audiencelab SDK Documentation

Welcome to Audiencelab! This guide will help you set up your account, connect your app, and integrate with ad networks to measure creative-level performance on iOS in a privacy-compliant way.

Quick Setup Overview

StepTaskEstimated Time
1Create an account1 min
2Add your application2 min
3Retrieve API key1 min
4Integrate SDK or S2S endpoint10 min
5Configure ad network pixels2 min

1. Create an Account

As we're currently not open for sign ups, you can only access an Audiencelab account if you:

  1. Have an active Geeklab subscription, or
  2. Reach out to us directly via mail

Once approved, you'll receive an invitation to create your account and access the Geeklab dashboard. You will use your Geeklab credentials to sign in to Audiencelab.

2. Add Your Application

After logging in:

  1. Click Create New Application in the dashboard.
  2. Select your platform (App Store or Google Play).
  3. Search for your app by name or App ID.
  4. Confirm to add the app to your organization.

Your app will now appear in the Applications list.

3. Retrieve API Key

Once your app is added:

  1. Open your app from the Applications list.
  2. Navigate to the Authentication section.
  3. Copy the generated API key — you’ll need this for SDK or server integration.

The API key is unique per app. You can view it anytime from the same page.

4. Integrate the SDK or S2S Endpoint

Audiencelab offers both client-side and server-side integration options:

Client-Side SDKs

Unity SDK

Integrate Audiencelab's Unity SDK to track events, measure ad performance, and optimize monetization in your Unity games.

React SDK

Integrate Audiencelab's React SDK to track events, measure ad performance, and optimize monetization in your web applications.

Angular SDK

Integrate Audiencelab's Angular SDK to track events, measure ad performance, and optimize monetization in your web applications.

For most mobile game developers, we recommend using our Unity SDK for the simplest integration experience.

Server-Side SDKs

Node.js SDK

Integrate Audiencelab's Node.js SDK to track events, measure user engagement, and analyze performance from your server-side applications.

Python SDK

Integrate Audiencelab's Python SDK to track events, measure user engagement, and analyze performance from your server-side applications.

5. Configure Ad Network Connections

Audiencelab allows you to attribute performance to self-attributing networks by configuring data sources (ad network connections). This process involves two main steps: setting up your data source and linking it to your application.

The user configuring the connection must have access to the ad account and datasets/pixels, with ads_management and business_management permissions in the ad network.

Step 1: Set Up Your Data Source

  1. Log in to your ad network (e.g., Meta) through Audiencelab from data sources page.
  2. Select which pages and businesses you want to grant access to.
  3. Audiencelab will automatically fetch available ad accounts, pixels (TikTok) or datasets (Meta), and other necessary assets.

You can re-authenticate at any time to fetch newly added pages, pixels, ad accounts, or update page and business access permissions.

  1. Navigate to your application from the sidebar.
  2. Open the Ad Network Settings tab.
  3. Click on the ad network you want to configure.
  4. Select the ad account used for running UA campaigns and the associated dataset (Meta) or pixel (TikTok) that will be used for attribution.

The dataset/pixel can be one that was automatically fetched during login, or you can manually enter it if you have access to send events to it.

Each application requires a separate dataset/pixel. If you need to reuse the same one or have questions, contact support@geeklab.app.

Managing Access Tokens

Audiencelab supports two authentication methods for Meta:

User Access Token (Default)

  • Provided when you first log in to the ad network
  • Used for all ad accounts under your team (across multiple applications if applicable)
  • Requires re-authentication every 60 days to maintain access
  • Missing re-authentication will cause Audiencelab to lose the ability to send postback events and fetch data

System User Access Token (Recommended)

  • Create a system user in your Meta Business Manager and request permission to the Audiencelab app
  • Create an access token for the system user
  • Copy and paste the access token in the Authentication tab under your application settings
  • Does not expire unless manually disconnected

For help setting up a system user, contact support@geeklab.app or reach out via customer support.

Testing Your Connection (TikTok)

For TikTok pixels, you can verify your connection by sending test events:

  1. Go to TikTok Ads Manager → Tools → Events
  2. Open your pixel and navigate to the Test Events tab
  3. Copy the Test Event Code from the Test Server Events section
  4. Paste this code in Audiencelab when prompted to test your pixel

🎉 You’re Ready!

With your app configured and integrations set up, Audiencelab will begin ingesting postbacks and displaying creative-level insights in the dashboard.

Check out Analytics to view your first campaign insights!

Are we a fit?

See what Audiencelab does, and if it helps your needs.

On this page

Quick Setup Overview1. Create an Account2. Add Your Application3. Retrieve API Key4. Integrate the SDK or S2S EndpointClient-Side SDKsServer-Side SDKs5. Configure Ad Network ConnectionsStep 1: Set Up Your Data SourceStep 2: Link Ad Account to Your ApplicationManaging Access TokensTesting Your Connection (TikTok)