App Install

Attribution & matching

How Circuul clicks, first-open match, and CPA accrual work.

Attribution & matching

This page is for teams wiring Circuul into an app. Brands setting up a campaign can stay on Brand setup.

Click (share link)

When someone opens a creator’s share link, Thspian:

  • Records the click and referral code
  • Remembers enough context to match a later first open
  • Sends the person to the right store or web URL

First open (match)

On first open, your app’s Circuul SDK tells Thspian who installed. Matching tries, in order:

  1. Clipboard / pasteboard referral (when the user allows it)
  2. Deep link or URL referral
  3. Play Install Referrer (Android)
  4. Probabilistic signals when needed

A successful match credits the install to the creator and accrues CPA from campaign float.

Rules of thumb

  • One earning per device / install (duplicates don’t pay twice)
  • Organic opens with no creator link don’t pay CPA
  • Referral clicks usually stay valid for about 7 days
  • Keep campaign float funded or matching may pause

Share previews

Share links can show a friendly preview (inviter name, CPA in the viewer’s currency, campaign art, and title) for social posts and messaging apps.

See also