Skip to content

Turn On S2S Clicks for a Partner ​

Let a connected affiliate partner report clicks and impressions from its own server

Some partners send users straight to the Play Store or App Store without opening a tracking link, for example OEM app-store placements on Xiaomi, OPPO and vivo. Linkrunner never sees those clicks. These partners report each click from their own server instead, using S2S clicks.

Other partners call your tracking link from their own server rather than from the user's browser. Linkrunner then sees the partner's server, not the user's device, and can't match the click to an install. With this switch on, Linkrunner records the device IP and user agent the partner passes on the link instead. See Calling the link from your server.

S2S clicks are off for every partner until you turn them on. Until then, Linkrunner rejects the partner's server requests with partner_not_enabled.

Only project admins and managers can change this setting.

Before you start ​

  • The partner is connected to your project in Integrations → Affiliate Partners. See Connect your affiliate partners.
  • The partner has asked for S2S clicks, or calls your tracking links from its own server. Partners whose links open in the user's browser don't need it.

Turn it on ​

Open the partner

Go to Integrations → Affiliate Partners and click Configure on the partner's card.

Switch on S2S clicks and impressions

Turn on the S2S clicks and impressions switch at the top of the page.

The S2S clicks and impressions switch, turned on, at the top of the partner's page

Confirm

Click Turn on.

Confirmation dialog: Turn on S2S clicks for Orbit Ads?

The change reaches Linkrunner's click servers within 6 minutes. Tell the partner they can start sending traffic after that.

What the partner can do ​

With S2S clicks on, the partner canThey still can't
Report clicks from their server for their own campaigns on this projectReport clicks for campaigns that belong to another partner or to you
Report impressions, if view-through is also on (see below)See your spend or revenue
Pass the user's device IP and user agent on tracking links their server calls (see Calling the link from your server)Change the IP recorded on clicks from other partners or from browsers

Each request to the S2S click API must carry the partner's own secret token, so another company can't send clicks in their name. Tracking links carry no token: anyone who calls this partner's link can pass a device IP on it. That only affects clicks on this partner's own campaigns. Linkrunner attributes installs to S2S clicks the same way as to clicks on a tracking link, within your attribution window.

Impressions need view-through as well. This switch lets the partner send impressions, but Linkrunner only credits installs to them once view-through attribution is on for the partner. To turn on view-through or change its window, contact support@linkrunner.io.

Turn on CTV impressions ​

If the partner reports connected TV (CTV) impressions, turn on the Connected TV (CTV) impressions switch under the S2S switch on the same page. S2S clicks must be on first. CTV installs are credited only when view-through is also on for the partner. For all three switches, how much to trust CTV matches, and results, see the CTV attribution guide.

Once CTV is on, the dashboard shows the partner's CTV impression URL on their campaigns, so you can copy it and send it to the partner.

Turn it off ​

Turn the same switch off. There is no confirmation. Within 6 minutes, the partner's server clicks and impressions are rejected, and their tracking links go back to recording the IP of whoever calls them. Their tracking links keep working. Turning S2S clicks off also turns CTV impressions off.

Disconnecting the partner also turns S2S clicks off. If you reconnect them later, turn it on again.

Troubleshooting ​

The switch is greyed out. You are not an admin or manager on this project. Ask an admin to change it.

The partner still gets partner_not_enabled. Wait 5 minutes after turning it on. If it persists, check that the campaign code c in their request belongs to that partner. A campaign created under another network doesn't count.

The partner calls your tracking link from its server, and installs are still not attributed. Wait 6 minutes after turning it on. Then check with the partner that every call carries the user's public device IP in ip. Private, loopback and malformed addresses are ignored.

Turning it on fails with "Affiliate partner not connected". The partner was disconnected, or their account is suspended. Reload the page and check the partner's card.

Need help? Contact support@linkrunner.io.

Need help? Contact support@linkrunner.io