Skip to main content

Documentation Index

Fetch the complete documentation index at: https://theoptimizer.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Keitaro is a self-hosted tracking platform built for professional affiliates and media buying teams who want full control over their tracking infrastructure. It runs on your own server and supports advanced traffic distribution, A/B testing, and click-level reporting. Keitaro is widely used by teams that prioritise data ownership and custom filtering logic.

​
Where to Find Your API Key

Log in to your Keitaro installation → go to Settings → API → copy the API Token shown.

​
Connecting to TheOptimizer

1

Open Integrations

From the left-hand menu, go to Integrations. Scroll to the Tracking Platforms section, find the Keitaro card and click Connect →.
2

Enter Your API Credentials

Fill in the connection form:
  • Integration name — a label for this connection (e.g. “Keitaro – Brand A”).
  • Api Key — paste the API Token you copied from Keitaro.
  • Currency — the currency your tracker reports revenue in. Must match your tracker’s settings.
  • Conversion registration time — choose Visit time (conversion counted when user lands) or Postback time (counted when conversion fires). Match this to your tracker’s setup.
    Image
The Currency and Conversion Registration Time settings must match what you have configured in Keitaro. Mismatched settings will cause data discrepancies.
3

Configure for Your Ad Networks

After saving the credentials, TheOptimizer prompts you to configure the tracker for each connected ad network. This step tells the platform how to match Keitaro data to your campaigns.Click Configure → next to each ad network and select the tracking template that matches how you set up Keitaro for that network.Understanding tracking templatesA tracking template is a set of macros that maps your tracker’s URL parameters to ad network identifiers (Campaign ID, Ad Set ID, Ad ID, Placement). The dropdown shows all templates available from your Keitaro account. Select the one you use for that ad network.
Required macros: a template must include mappings for Campaign ID, Ad Set ID, Ad ID, and Placement. If any are missing, TheOptimizer will flag the issue — fix the template in Keitaro before proceeding.
Once a template is selected, the connection status for that ad network updates to Connected.
Ad networks where you have not selected a tracking template will not receive any data from Keitaro. Configure every network you actively use.
4

Add Tracking Parameters to Your Campaigns

TheOptimizer generates a tracking parameters code at the end of setup. Add this URL parameter string to your campaigns on each ad network. This is what allows Keitaro to receive the correct campaign and ad identifiers and report them back.Without this step, Keitaro will receive visits but won’t be able to match them to specific campaigns — no conversion or revenue data will appear in TheOptimizer.

​
One Tracker Type Per Campaign

Only one instance of a tracker type should track any individual campaign at a time. Running two Keitaro integrations against the same campaign causes attribution conflicts. Running different tracker types side by side on the same campaign is fine — for example, Keitaro for affiliate attribution alongside Google Analytics for on-site behaviour.