Getting Started

This document details the process of integrating YouAppi iOS AdMob adapter with your iOS app.

If you have any questions, please, feel free to email us: [email protected]

Setup

Automatic: Setup your project with CocoaPods

You can setup your project with YouAppi’s SDK automatically using CocoaPods.

Steps for using CocoaPods:

• Make sure CocoaPods is installed on your Mac.
• Make sure your project has a pod file.

• Add to your pod file YouAppi’s framework and YouAppi’s AdMob adapter:

  target 'MyApp' do
    pod 'YouAppiMoatSDK'
    pod 'YouAppiAdMobAdapter'
    pod 'Google-Mobile-Ads-SDK'
    pod 'PersonalizedAdConsent'
  end

• Please note that: Google-Mobile-Ads-SDK and PersonalizedAdConsent might have already been added to your pod file if you are working with AdMob mediation.
• Open a terminal and change the current directory to your project directory.

• Run the command:

  pod install

• After YouAppi framework is setup for your project, you can move on to the integration section of the document.

Manual: Setup your project for YouAppi’s SDK

• YouAppi SDK and YouAppi AdMob adapter can be found in YouAppi iOS SDK zip file.
• Install YouAppi iOS SDK as described in the document.
• Add YouAppiMoat.framework and libYouAppiAdMob.a static library to your project.
• After YouAppi framework is setup for your project, you can move on to the integration section of the document.

Create a new iOS app

• On ad mob platform go to apps section.
• Press ADD APP button.

• Follow through the steps of creating a new app.

Add to your iOS app ad units

Add new ad units to your app by choosing your app and pressing ADD AD UNIT button

Rewarded Video

• After pressing ADD AD UNIT button select Rewarded:

• Fill your ad unit details and press CREATE AD UNIT button:

Interstitial Video and Interstitial Ad

• After pressing ADD AD UNIT button select Interstitial

• Fill your ad unit details and press CREATE AD UNIT button:

Create Mediation Group for YouAppi Rewarded Video

• Choose Mediation tab and press CREATE MEDIATION GROUP button.
• Fill mediation group details and press CONTINUE:

• Fill mediation group details and press ADD AD UNITS to connect your mediation group with the rewarded video ad unit.

• Press DONE to add the ad unit.
• After the popup is closed and the ad unit is selected, on Ad Sources section press ADD CUSTOM EVENT button.
• On the popup name your custom event, fill relevant eCPN and press CONTINUE:

• On the next popup fill the class name of YouAppi rewarded video custom event: YAAdMobRewardedVideoAdEvent
• Fill the Parameter field with a JSON containing information about your access token and ad unit id. For example:

{ "accessToken": "821cfa77-3127-42b5-9e6b-0afcecf77c69", "adUnitId": "tesRewardedVideoAdUnit" }

• Make sure to use your access token and to put ad unit id that contains only letters, numbers or underscores.

• Press DONE to save the custom event.
• Press SAVE to create the new mediation group.

Create Mediation Group for YouAppi Interstitial Video and Interstitial Ad

• Choose Mediation tab and press CREATE MEDIATION GROUP button.
• Fill mediation group details and press CONTINUE:

• Fill mediation group details and press ADD AD UNITS to connect your mediation group with the interstitial ad and interstitial video ad units.

• Press DONE to add the ad unit.
• After the popup is closed and the ad unit is selected, on Ad Sources section press ADD CUSTOM EVENT button.
• On the popup name your custom event, fill relevant eCPN and press CONTINUE:

• On the next popup fill the class name of YouAppi rewarded video custom event: YAAdMobInterstitialVideoAdEvent or YAAdMobInterstitialAdEvent.
• Fill the Parameter field with a JSON containing information about your access token and ad unit id. For example:

{ "accessToken": "821cfa77-3127-42b5-9e6b-0afcecf77c69", "adUnitId": "tesRewardedVideoAdUnit" }

• Make sure to use your access token and to put ad unit id that contains only letters, numbers or underscores.

• Press DONE to add the ad unit.
• Press SAVE to create the new mediation group.

Use AdMob SDK to show YouAppi ad units

Rewarded Video

Load

[GADRewardBasedVideoAd sharedInstance].delegate = self;
[[GADRewardBasedVideoAd sharedInstance] loadRequest:[GADRequest request] withAdUnitID:@"Ad Unit ID From AdMob"];

Show

if ([[GADRewardBasedVideoAd sharedInstance] isReady]) {
  [[GADRewardBasedVideoAd sharedInstance] presentFromRootViewController:self];
}

Interstitial Video

Load

self.interstitialVideoAdMob = [[GADInterstitial alloc] initWithAdUnitID:@"Ad Unit ID From AdMob"];
GADRequest *request = [GADRequest request];
[self.interstitialVideoAdMob loadRequest:request];

Show

if (self.interstitialVideoAdMob.isReady) {
  [self.interstitialVideoAdMob presentFromRootViewController:self];
}

Interstitial Ad

Load

self.interstitialAdAdMb = [[GADInterstitial alloc] initWithAdUnitID:@"Ad Unit ID From AdMob"];
GADRequest *request = [GADRequest request];
[self.interstitialAdAdMb loadRequest:request];

Show

if (self.interstitialAdAdMb.isReady){
  [self.interstitialAdAdMb presentFromRootViewController:self];
}