Getting Started

This document details the process of integrating YouAppi’s SDK with your Unity app.

If you have any question you can email us to: support@youappi.com

Requirements:

• Android: Minimum API level: 16, Android 4.1
• iOS:
  • XCode 9+ (Swift 3.3+, Objective C).
  • iOS 9.0+ target deployment.
  • armv7, arm64 devices, and the simulator.

Download YouAppi’s Unity SDK

Unity SDK –> Download the latest YouAppi Unity SDK

The ZIP file contains:

• SDK unity package – youappi-sdk-unity.unitypackage
• Sample app – youappi-sdk-unity-test

Import YouAppi Package

• Open the Unity project you would like to integrate with YouAppi SDK.
• Go to Assets → Import Package → Custom Package
  
• Select youappi.unitypackage from its location on disk.
• A dialog will be opened showing the package contents.
• Make sure all assets are selected and press import copy the content of the package to your project.
  

Using YouApi SDK on your project

Example is shown for rewarded ad unit, but behavior is the same for all ad units.

• Create YouAppi instance an initialize it using your Access Token:

  // Use YouAppi library
  using YouAPPiSDK.Api;
   
  // Create YouAppi instance and initialize it
   
  youAppi = new YouAppi();
  Debug.Log("Initialize YouAppi SDK");
  youAppi.initialize("<Your Access Token>");

• Create a rewarded video instance with and arbitrary ad unit id. Please make sure that ad unit id is constructed only from letters, numbers or underscores.
• Connect the rewarded video with LoadSuccess and LoadFailure events. If rewarded video is loaded successfully then show it.
• Load rewarded video ad unit.

  rewardedVideoAd = youAppi.rewardedVideo("RewardedVideoAdUnitId");
  rewardedVideoAd.LoadSuccess += (sender, AdUnitEventArg) => {
      Debug.Log("Rewarded video was loaded");
      rewardedVideoAd.show();
  };
   
  rewardedVideoAd.LoadFailure += (sender, ErrorEventArgs) => {
      Debug.Log("Failed loading rewarded video. Reason: " + ErrorEventArgs._errorCode + ", message: " + ErrorEventArgs._errorMessage);
  };
   
  rewardedVideoAd.load();

youAppi.initialize(accessToken, userConsent, gdpr);

youAppi.userConsent = true;

youAppi.gdpr = false;

youAppi.ageRestrictedUser = true;

• • Go to File → Build Settings…
    
  • Choose Android from the left list.
  • Change Build System to Gradle (New).
  • Check Export Project.
  • Check Development Build.
    
  • Press Export and select the folder on which the Android project will be created.

Build for iOS

• Go to File → Build Settings…
  
• Choose iOS from the left list.
  
• On Player Settings… under Other Settings section make sure that:
  • Archtecture is set to Universal
  • Scripting Backend is set to IL2CP
    
    
• Press Export and select the folder on which the iOS project will be created.
• Add the YouAppi.framework to General → Embedded Binaries
  
• Change to YES inside the build settings under the option ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES.
  
• Change to YES inside the build settings under the option DEFINES_MODULE.
  

Build and archive for Apple store

In order to build and archive your app for the Apple Store you need to add the following:

• Go to your app target.
• Select Build Phases.
• Go to Run Script section (you can add it by pressing + button if it doesn’t exist).

• Add the following line in the text box:

  "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/YouAppi.framework/strip-frameworks.sh"

• Please, make sure that ‘Run Script’ phase including the script above is the last one! It should look like this:
  

Load and Show best practices

• Make sure to init the SDK as soon as the app starts. It might take few seconds to complete the init process.
• Make sure to load the ad about 30 seconds before you want to show it, since it takes time for the ad and assets to be prepared.
• make Make sure to show an ad as close as possible to loading an ad, in order to have a better fill rate and relevant ads.
• Make sure not to wait too long before showing an ad, since the ad will be expired 5 hours after being called for. In other words, “show” must be performed no more than 5 hours after the “load”.
• Use ad event listeners in order to be notified when an ad is ready to be shown.
• Use ad event listeners to handle load and show.
• Loading an ad too many times without showing it might cause YouAppi servers to block the SDK from requests.