Release version: 3.0.2 | Release date: 17.01.2023

Follow this guide to get the best out of Appodeal.

The Appodeal SDK gives you access to 70+ Ad Demand Sources and makes them compete against each other in a real-time auction, maximizing your ad revenues. The Appodeal SDK also provides In-app Bidding, Automatic UA Optimization, User Segmentation & A/B Testing, Cross-Promotion and Direct Deals, Instant Payouts, and much more.

1. The Appodeal SDK Full Package - The Appodeal SDK provides you with tools to grow your mobile apps and games.
   In addition to the monetization services, you can benefit from UA (User Acquisition) and in-app analytics services. 
   Here is the list of services Appodeal SDK Full Package includes :
   

   • Get started with Appodeal to gain access to Monetization and Analytics.

   • Connect with Adjust or Appsflyer to unlock Attribution features.

   • Connect with Meta (formerly known as facebook-core) for User Acquisition.

   • Connect with Firebase for Analytics + remote config for product A/B tests and settings.

   If you plan to run UA campaigns, want to analyze your metrics in our Appodeal’s business intelligence tool without using MMP, or want to use remote config for tests and settings, your option is - the full package.
   
   
2. The Appodeal SDK Mediation only - If you do not plan to run (UA) User Acquisition campaigns, nor want to use Appodeal advanced analytics, we have created a lite version of our SDK, only with mediation. 
   During the integration, you will not be required to install any additional services apart from mediation.
   This may speed up your integration process, and you can always upgrade to the Full Package whenever you’re ready.

Please follow this integration guide step by step and choose your integration option when needed.

The following document shows how to integrate Appodeal in your iOS project with your desired networks via CocoaPods and manual setup, and configure all your ad formats.

You can use our demo app as a reference project.

Step 1. Import SDK

Fat and CocoaPods 3.0.2 versions work in pure Obj-C, and Swift as well as mixed Obj-C or Swift projects.

sudo gem install cocoapods

rm -rf "${HOME}/Library/Caches/CocoaPods"
rm -rf "`pwd`/Pods/"
pod update

source 'https://github.com/appodeal/CocoaPods.git'
source 'https://cdn.cocoapods.org/'

Step 2. Prepare Your Application

Add SKAdNetworkIds

Ad networks used in Appodeal mediation support conversion tracking using Apple's SKAdNetwork, which means ad networks are able to attribute an app install even when IDFA is unavailable. To enable this functionality, you will need to update the SKAdNetworkItems key with an additional dictionary in your  Info.plist.

1. Select Info.plist in the Project navigator in Xcode
2. Right-click on Info.plist file → Open as → Source Code
3. Copy the SKAdNetworkItems from below and paste it into your Info.plist file

There is SKAdNetworks IDs in Info.plist format:

Configure App Transport Security Settings

In order to serve ads, the SDK requires you to allow arbitrary loads. Set up the following keys in info.plist of your app:

1. Go to your info.plist  file, then press  Add+ anywhere in the first column of the key list.
2. Add App Transport Security Settings key  and set its type to  Dictionary in the second column.
3. Press Add+  at the end of the name  App Transport Security Settings key  and choose  Allow Arbitrary loads . Set its type to  Boolean  and its value to  Yes .

You can also add the key to your info.plist directly, using this code:

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

Location Description (Optional)

NSLocationWhenInUseUsageDescription - Entry is required if your application allows Appodeal SDK to use location data.

<key>NSLocationWhenInUseUsageDescription</key>
<string><App Name> needs your location for analytics and advertising purposes</string>

Other Feature Usage Descriptions

To improve ad performance the following entries should be added:

1. GADApplicationIdentifier - When including AdMob in your project, you must also add your AdMob app ID to your info.plist . Use the key GADApplicationIdentifier with the value being your AdMob app ID.
   For more information about Admob sync check out our Admob guide.
2. NSUserTrackingUsageDescription - Starting from iOS 14, using IDFA requires permission from the user. The following entry must be added in order to improve ad performance.
3. NSCalendarsUsageDescription - Recommended by some ad networks.
   
   

<key>GADApplicationIdentifier</key> 
<string>YOUR_ADMOB_APP_ID</string>
<key>NSUserTrackingUsageDescription</key>
<string><App Name> needs your advertising identifier to provide personalised advertising experience tailored to you</string>
<key>NSCalendarsUsageDescription</key>
<string><App Name> needs your calendar to provide personalised advertising experience tailored to you</string>

Step 3. Initialize SDK

Import Appodeal into AppDelegate (AppDelegate.m) class and initialise the SDK: 

import Appodeal

#import <Appodeal/Appodeal.h>

@UIApplicationMain 
final class MyAppDelegate: UIResponder, UIApplicationDelegate, AppodealInitializationDelegate { 
	func application( 
		_ application: UIApplication, didFinishLaunchingWithOptions
		launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil ) -> Bool {
		Appodeal.setAutocache(false, types: .interstitial) 
		Appodeal.setLogLevel(.verbose) 

		// New optional delegate for initialization completion 	
		Appodeal.setInitializationDelegate(self) 
		/// Any other pre-initialization 
		/// app specific logic 
		Appodeal.initialize( 
			withApiKey: "APP_KEY", 
			types: .interstitial 
		) 
		return true 
	} 
	func appodealSDKDidInitialize() { 
		// Appodeal SDK did complete initialization 
	} 
}

@interface MyAppDelegate () 
<AppodealInitializationDelegate> 

@end 

@implementation MyAppDelegate 
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
	[Appodeal setAutocache:NO types:AppodealAdTypeInterstitial]; [Appodeal setLogLevel:APDLogLevelVerbose];

	// New optional delegate for initialization completion 
	[Appodeal setInitializationDelegate:self]; 

	/// Any other pre-initialization 
	/// app specific logic 
	[Appodeal initializeWithApiKey:@"APP KEY" types:AppodealAdTypeInterstitial];
	return YES; 
} 

- (void)appodealSDKDidInitialize { 
	// Appodeal SDK did complete initialization 
} 

@end

Step 4. Configure Ad Types

Appodeal SDK is now imported and you're ready to implement an ad. Appodeal offers a number of different ad formats, so you can choose the one that best fits your app's user experience.

Step 5. Publish Your Application

Update App Store IDFA usage. When you submit your application to the App Store you need to update its "Advertising Identifier (IDFA)" settings in order to comply with Apple advertising policy.

1. Go to the Advertising Identifier section.
2. Set Yes on the right panel.
3. Tick Serve advertisements within the app .
4. Tick confirmation box under Limit Ad tracking setting in iOS .

Configure App Privacy according to this doc: 

App Privacy Details

Step 6. Add App-ads.txt File

The app-ads.txt file is a text file which provides a mechanism for publishers to declare their authorized digital sellers. Created by IAB, it is an extension of the original ads.txt standard that was used for the same purpose in web advertising. It helps ad networks and DSPs easily verify whether an ad network or exchange they are buying your traffic from is allowed to sell it.

If you don't have app-ads.txt file yet:

1. Add developer website URL to your Google Play and App Store apps.

2. Download Appodeal's app-ads.txt from this page. 

3. Upload app-ads.txt file to the root path of your developer website (it should look like this: example.com/app-ads.txt).

If you already have app-ads.txt:

1. Copy Appodeal's app-ads.txt from this page.

2. Paste the content to your app-ads.txt.