Skip to main content

Marketing Flow

Implement the full impression → click → conversion attribution chain to measure campaign ROI.

Overview​

Marketing attribution connects three events in sequence:

impression → click → conversion

These events are typically sent from your backend via the S2S API, not from the game client.

Implementation​

1. Track Impressions​

When your ad platform reports an impression:

requests.post(
    "https://sdk-api.gamerebellion.com/api/v1/event",
    headers={"X-API-Key": "<YOUR_API_KEY>"},
    json={
        "event_type": "impression",
        "payload": {
            "campaign_id": "summer_2026",
            "ad_group": "lookalike_us",
            "creative_id": "video_v3",
            "platform": "facebook"
        }
    }
)

2. Track Clicks​

When the player clicks through:

requests.post(
    "https://sdk-api.gamerebellion.com/api/v1/event",
    headers={"X-API-Key": "<YOUR_API_KEY>"},
    json={
        "event_type": "click",
        "payload": {
            "campaign_id": "summer_2026",
            "ad_group": "lookalike_us",
            "creative_id": "video_v3",
            "click_url": "https://play.google.com/store/apps/details?id=com.yourgame"
        }
    }
)

3. Track Conversions​

When the player completes the desired action:

requests.post(
    "https://sdk-api.gamerebellion.com/api/v1/event",
    headers={"X-API-Key": "<YOUR_API_KEY>"},
    json={
        "event_type": "conversion",
        "payload": {
            "campaign_id": "summer_2026",
            "conversion_type": "install",
            "conversion_value": 0
        }
    }
)

Viewing Results​

Campaign attribution data appears in the Acquisition Dashboard:

  • Impressions, clicks, and conversions per campaign
  • Click-through rates (CTR)
  • Cost per acquisition (CPA) when cost data is provided
  • Creator code performance in the Creator Dashboard