SDK INTEGRATION GUIDE

Table of Contents
Start Here .............................................................................................................................. 3
Facebook ............................................................................................................................... 4
Steps .............................................................................................................................................4
AppsFlyer .............................................................................................................................. 5
Steps .............................................................................................................................................5
Applovin MAX ....................................................................................................................... 6
Steps .............................................................................................................................................6
Networks .......................................................................................................................................6
Add Formats ..................................................................................................................................7
Rewarded .............................................................................................................................................................. 7
Interstitals ............................................................................................................................................................. 7

Firebase................................................................................................................................. 8
Steps .............................................................................................................................................8
Analytics Events .............................................................................................................................8
Remote Config ...............................................................................................................................8
Last But Not Least .................................................................................................................. 9
Audience Network ATE Flag ............................................................................................................9
Other GUIDES ...................................................................................................................... 10
Facebook App Creation Guide....................................................................................................... 10
App-ads.txt Configuration ............................................................................................................ 16
Start Here
This Integration Guide will provide which SDK you should install your game and basic
informations about those SDKs.

With this guide you will receive additional document, that contains unique SDK keys. Those keys
generated for each game and should be matched with bundle Id you provided to Joygame.
Facebook
SDK Main Page -> https://developers.facebook.com/docs/unity/

Steps:
• Create a Facebook App in Facebook (Facebook App Creation Guide)
• Send administrator invite to Our Team Member (Facebook ID: 539540337)
• Update app-ads.txt file (App-ads.txt Guide)
• Initialize the Facebook SDK with FB.Init() method.
https://developers.facebook.com/docs/unity/gettingstarted

Do not forget to add Facebook app id to your game. Unity editor, select Facebook > Edit
Settings.

Do not forget to add Facebook Client Token to your game. Unity editor, select Facebook > Edit
Settings > Advanced
AppsFlyer
For AppsFlyer Dev Key is same for all games: NWGwb8RaDx8vxg5nZ47TR6

SDK Main Page -> https://github.com/AppsFlyerSDK/appsflyer-unity-plugin

Steps:
• IOS Only, Wait for AppTrackingTransparency before Init SDK
• Initialize the AppsFlyer SDK
• Integrate Required Events [![Gül, Pavel]!]
Applovin MAX
SDK Main Page -> https://dash.applovin.com/documentation/mediation/unity/getting-
started/integration

In Unity, select AppLovin > Integration Manager. The AppLovin Integration Manager dialog
appears. You can set SDK key & Install networks via this dialog.

Steps:
• Integrate the SDK
• Install required networks in AppLovin Integration Manager
• Insert Admob App Id (Provided from PM) in AppLovin Integration Manager
• Set Advertising Attribution Report Endpoint in Info.plist to true in AppLovin Integration
Manager
• Enable Terms Flow in AppLovin Integration Manager
• Set Advertising Attribution Report Endpoint in Info list (iOS only) in AppLovin Integration
Manager

Networks:

• Applovin
• GoogleAdmob
• GoogleAdManager
• MetaAudienceNetwork (Facebook)
• Unity
• Pangle
• Liftoff
• DTExchange(Fyber)
• IronSource
• Mintegral
• Inmobi
• Smaato
• Ogury
• Verve
• Mobilefuse
Add Formats:

• Banners https://dash.applovin.com/documentation/mediation/unity/ad-
formats/banners
• Interstitials https://dash.applovin.com/documentation/mediation/unity/ad-
formats/interstitials
• Rewarded https://dash.applovin.com/documentation/mediation/unity/ad-
formats/rewarded-ads

Rewarded:

• Before showing the ad MaxSdk.IsRewardedAdReady(adUnitId) flag should be checked.

If ad not ready, a message can be shown to user.
• Before load the next ad, be sure OnRewardedAdHiddenEvent or
OnRewardedAdFailedToDisplayEvent events triggered.

Interstitals:

• Before showing the ad MaxSdk.IsInterstitialReady(adUnitId) flag should be checked. If

ad not ready, a message can be shown to user.
• Before load the next ad, be sure OnInterstitialHiddenEvent or
OnInterstitialAdFailedToDisplayEvent events triggered.

Don’t forget to Show Ad Not Ready feedback to User if Ad is not ready from the Max SDK.
Firebase
SDK Main Page -> https://firebase.google.com/docs/unity/setup

Steps:
• Create Firebase App
• Add platforms (IOS, Android)
• Download configuration file and import to Assets folder (GoogleService-Info.plist for IOS
& google-services.json for Android)
• Import Firebase SDK (Analytics & Remote Config)
• Invite [email protected] as an owner to firebase app

Analytics Events

No event trigger is required. Just initialize analytics.

Remote Config

On remote config you can control timer for interstitial ads. It is possible to set a integer type key
(Example 30 seconds). The game will know how many seconds wait to show another interstitial
ad.

Also it is good to set this value high when game is in the review on any store.
Last But Not Least

Audience Network ATE Flag

PreRequisites
• Facebook SDK Installed
• Max SDK Installed
• Audience Network Installed in Max SDK

Navigate the page ATE Flag Guide Page

https://developers.facebook.com/docs/audience-network/setting-up/platform-
setup/ios/advertising-tracking-enabled/

Add the AdSettings Class to your project, and invoke SetAdvertiserTrackingEnabled method
before Init Max SDK.
Other GUIDES

Facebook App Creation Guide

Step 1 - Login Facebook developer account. Register if you don't have one already.

https://developers.facebook.com/docs/development/register

Step 2 - Create Facebook App

Step 3 – Choose the app type
Step 4- Fill the app name and contact email and proceed to create the fb app
(Please use the same app name as in the store listing to avoid confusion)

Step 5 - Complete the additional information

Go to app dashboard and fill the required fields in Settings > Basic setup
Step 6 - Add the required platforms and fill platform fields accordingly
Be sure that the ownership is confirmed through app-ads.txt on both platforms
More information for {app-ads.txt configuration}
If not please contact your PM
Step 7 - Add user to app
Add UA Manager as Admin with provided FB ID
You can get the relevant FB ID from your PM
Facebook ID: 539540337
App-ads.txt Configuration

App-ads.txt file contains 2 major information(s) for verification

• Facebook App (1 line per game/app)
• Ad network (Multiple lines)

For Ad network lines your PM will provide the informations. If game published in Joygame
related account, there is no action required.

For Facebook also no action required if game published in Joygame related account. If not you
need to add a new line to your app-ads.txt file.

The line template below, replace the YOUR_FACEBOOK_APP_ID with your Facebook app id. (Do
not delete the quotes)

facebook.com, "YOUR_FACEBOOK_APP_ID", RESELLER, c3e20eee3f780d68

General Rules of App-ads.txt file

• The file should be in root directory.
• File should be accessed securely (https)
• For IOS app’s marketing URL should be root directory
• For Android Store presence -> Store settings -> website URL should be root directory

Example:

IOS marketing URL -> https://www.joygamemobile.com/

AOS website URL -> https://www.joygamemobile.com/

App-ads.txt URL -> https://www.joygamemobile.com/app-ads.txt