Skip to main content

How to set up mappings between Facebook and Keitaro?

Mappings combine Facebook spend with Keitaro conversions to calculate real ROI.

What is a mapping?​

A mapping is a rule that automatically matches Facebook data with tracker (Keitaro) data based on matching certain parameters.

Why needed:

  • See Facebook spend and Keitaro revenue in one place
  • Calculate real ROI with all data considered
  • Automatic statistics combining

Mapping Types​

Most accurate method:

Facebook Ad ID: 23851234567890
Keitaro parameter: external_id=23851234567890
→ Data links automatically

How to set up:

  1. In Facebook campaigns use unique Ad ID
  2. In Keitaro pass Ad ID via external_id parameter
  3. System automatically links data by ID match

2. Campaign Name Mapping​

Simple method:

Facebook Campaign Name: "Gambling_UK_Desktop"
Keitaro Campaign: "Gambling_UK_Desktop"
→ Link by name match

3. Sub ID Mapping​

For split tests:

Facebook: utm_content=sub1
Keitaro: stream_id=sub1
→ Link by Sub ID

4. Combined Mappings​

For maximum accuracy:

Date: 2024-01-15
Campaign Name: "Gambling_UK"
→ Link by two parameters

How to Create Mapping​

  1. Open Agency → Mappings
  2. Click "Create Mapping"
  3. Select:
    • Facebook account (spend source)
    • Keitaro integration (conversion source)
  4. Configure linking parameters:
    • Choose mapping type (Ad ID, campaign, etc.)
    • Specify fields to match
  5. Check data preview
  6. Save and activate mapping

Verifying Mapping​

How to ensure mapping works:

  1. Run ads in Facebook with correct labels
  2. Wait for sync (5-10 minutes)
  3. Open Agency → Statistics
  4. Check that both spend and revenue are visible
  5. Ensure ROI calculates correctly
  1. Check that labels in Facebook and Keitaro match
  2. Ensure both integrations are syncing
  3. Verify mapping settings
  4. Review matching logs
  5. Contact support

More details: