- 30 Sep 2024
- 4 Minutes to read
- Print
- DarkLight
Callback setup
- Updated on 30 Sep 2024
- 4 Minutes to read
- Print
- DarkLight
Callback setup
Show more
Events are sent to Tenjin on a real time basis from the device. Event callbacks can be configured to send data to any ad network on a real time basis.
If you're using the Tenjin callbacks, you will not need to integrate another ad network SDK when using Tenjin because you can configure install events to get sent to the ad network in real time from Tenjin.
Install callbacks
Tenjin notifies ad networks of an install when it occurs. This is also part of the attribution process in step 10.
To configure a specific ad network install callback, first make sure you:
After you completed the above you can configure any callbacks on the Apps tab. The below example is specifically for Applovin callbacks on Tenjin's Word Search iOS app, but it's the same process for any other ad network.
Go to the CONFIGURE -> Apps tab and click on your app. Click on + New Callback.
Filter for the ad network you want to advertise on and send install events to. The example below is filtered for "AppLovin".
Select the AppLovin install callback.
Follow the directions on the right hand side to configure the callback properly. In this case you will need to get the Applovin SDK Key from your Applovin dashboard.
Hit Save Callback.
This will automatically forward all completed install events to Applovin when users are attributed to the Applovin campaigns that you create.
Custom event callbacks
Show more
App developers can send other real time custom events (not just the installs) to networks. These non-install events can further optimize campaigns to get better users. Examples of other events include: purchase events or milestones that your app is measured successfully on.
To configure a specific ad network event callback, first make sure you:
After you complete the above you can configure any real time callbacks on the Apps tab. The following will be specifically for Applovin callbacks, and is the same process for any other ad network.
Go to the CONFIGURE -> Apps tab and click on your app. Click on + New Callback.
Filter for the ad network that you are advertising on. The example below is filtered for "AppLovin".
Select the specific custom event callback you want to send. Here you can see the IAP event and the custom event.
Follow the directions on the right hand side to configure the callback properly. In this case you will need to enter your custom event name, and get the AppLovin SDK Key from your AppLovin dashboard.
Select custom event from the drop down list.
Hit Save Callback.
With this callback configured, you will be sending Applovin events for each of the user's custom events.
Custom callbacks
Show more
App developers can send custom callbacks to their own server or any networks that are not pre-configured. This will allow developers to collect and analze those user-level attribution data in real-time. Here are the possible use cases using Tenjin custom callback:
- If you have your own data anlytics tool, custom callback will allow you to tie the attribution data to your in-game data per device level.
- Show the different app content depending on where the user comes from. For example, if user A is attributed to organic and user B is attributed to Facebook. Since user B is likely to be more engaged with your app, you might want to show the special in-game offer after the user installs the app. If you want to discuss more specific use cases, please contact to Tenjin success manager.
The configuration is flexible for you to set up any endpoint URL, with a variety of parameters using Tenjin's pre-defined macros.
NOTE: Custom callbacks are paid feature, so please contact your Tenjin account manager if you are interested in.
Ad revenue callbacks
Show more
Tenjin can notify your ad networks of events that correspond to your impression level revenue data (ILRD) every time an advertisement is shown to a user. We can process data from the following mediation providers:
- Applovin
- Unity LevelPlay
- Hyperbid
- AdMob
- Topon
- CAS
- TradPlus
You can send data to the following networks:
- IronSource
- Unity
- Meta
- Liftoff
- TikTok
- Aura from Unity
- Mintegral
- Adjoe
- Smadex
- Moloco Ads
- Adkomo
- Yelohi
- Kwai for Business
- Appier
- YSO Network
- Axponent
We do not collect this data by default. You would need to update the SDK to a version that allows us to process the impressions level revenue data. Since this is a paid feature, please contact your Tenjin Account Manager for the SDK documentation. When the supported SDK version is integrated, you will be able to setup callbacks on the Tenjin dashboard, similar to the process described in the documentation above.
:::
Checking callback status
Show more
On the Callback page, you can see the percentage of callback success for the last hour, and last day(last 24 hours). If the success rate is low, that means callback is not working. You can also see the log for recent callback successes.
The callback error logs are also shown on the dashboard. Tenjin usually make several retries when we see an error with sending the callbacks. If you see a lot of errors during a short period of time, please contact the partner you are working with, or contact Tenjin support.