Upinteractive Document Documentation
Total Page:16
File Type:pdf, Size:1020Kb
UPInteractive Document Documentation upltv Nov 09, 2018 Contents 1 About UPSDK 1 1.1 UPSDK Introduce............................................1 1.2 Get Started................................................1 1.3 How to download UPSDK........................................1 1.4 Support & Feedback...........................................1 2 UPSDK Android 3 2.1 Quick Start................................................3 2.2 Solving 65535-Limitation........................................ 12 2.3 SDK Initializating............................................ 14 2.4 Banner Ad................................................ 14 2.5 Interstitial Ad............................................... 17 2.6 Rewarded Video Ad........................................... 19 2.7 GDPR.................................................. 23 2.8 Demo................................................... 27 3 UPSDK IOS 29 3.1 Xcode Access Document......................................... 29 3.2 CocoaPods Access Document...................................... 34 3.3 SDK Initial................................................ 35 3.4 Banner Ad................................................ 36 3.5 Interstitial Ad............................................... 39 3.6 Rewarded Video Ad........................................... 42 3.7 GDPR.................................................. 46 3.8 Demo................................................... 49 4 UPSDK UnityPlugin 51 4.1 UnityPlugin Guide............................................ 51 4.2 How to add plugin in Unity project................................... 52 4.3 UnityPlugin Access........................................... 56 4.4 UnityPlugin API Introduction...................................... 65 4.5 UnityPlugin Sample........................................... 71 4.6 UnityPlugin Android MultiDex..................................... 83 5 UPSDK Cocos2d-X Cpp 91 5.1 Quick Start................................................ 91 5.2 UPSDK cocos2d-X Cpp API....................................... 107 i 5.3 CppPlugin Sample............................................ 114 6 UPSDK Cocos2d-X Lua 133 6.1 LuaPlugin................................................ 133 6.2 LuaPlugin Sample............................................ 148 7 UPSDK Cocos2d-X JavaScript 163 7.1 JavaScriptPlugin............................................. 163 7.2 JavaScriptPlugin Sample......................................... 179 8 UPSDK Layabox JavaScript 193 8.1 JavaScriptPlugin............................................. 193 8.2 JavaScriptPlugin Sample......................................... 208 9 UPSDK Egret TypeScript 221 9.1 TypeScriptPlugin............................................. 221 9.2 TypeScript................................................ 227 10 UPSDK Download 237 10.1 Android SDK............................................... 237 10.2 iOS SDK................................................. 237 10.3 Unity SDK................................................ 237 10.4 Cocos2D-X................................................ 237 10.5 Layabox................................................. 238 10.6 Egret................................................... 238 10.7 Google-Play-Services Download.................................... 238 11 GDPR 239 11.1 Support List............................................... 239 11.2 Sample.................................................. 239 12 FAQ 241 12.1 Q: What should I do if there is no advertisement displayed correctly after embedding the SDK?... 241 12.2 Q: What advantages does UpLTV have over a single advertising platform , such as AdMob , Mobvista , Vungle, etc.?.............................................. 241 12.3 Q: Why is UpLTV more efficient than other integration platforms such as YoMob , Heyzap , and Fyber ?241 12.4 Q: How long does it take to embed the SDK?.............................. 242 12.5 Q: How can AI improve monetization based on integration?...................... 242 12.6 Q: Can I check the benefits brought by each advertising platform in the background?......... 242 12.7 Q: Can I choose to block ads from the competitors ?.......................... 242 12.8 Q: Can I choose the certain type of advertisement, such as a rewarded video?............. 242 12.9 Q: Can I check the data of rewarded video, interstitial, and banner separately?............. 243 12.10 Q: Shall we re-embed the SDK after updating the game version?.................... 243 12.11 Q: Since the Chartboost has been embedded in the SDK , can you exchange the traffic?........ 243 12.12 Q: What is the size of the SDK currently? Is it related to the number of ad platforms integration?.. 243 12.13 Q: If our game has embedded a single advertising platform such as vungle , unityads , and your SDK integrates the platform as well. Will there be any conflicts?....................... 243 12.14 Q: How do you get priority to show the relatively high price Offer of advertising? Is it a real-time bid? 244 12.15 Q: Will your SDK be added to your own interactive advertising platform?............... 244 12.16 Q: Can you set up the horizontal or vertical screen ads display?.................... 244 12.17 Q: Is it enough to access your SDK and API only? Is it still necessary to access our own data platform for you to collect data?.......................................... 244 12.18 Q: Can eCPM set a low price?...................................... 245 12.19 Q: To what extent can user tags be refined after API access?...................... 245 12.20 Q: How to avoid the tax generated by the payment ?.......................... 245 ii 12.21 Q: How do you distinguish between subscribers and non-paying users to targeted delivery group ?.. 245 12.22 Q: Will accessing two CPs at the same time increase the package size?................ 245 12.23 Q: What is the current price of eCPM in North America for words game?............... 246 iii iv CHAPTER 1 About UPSDK 1.1 UPSDK Introduce UPSDK (UPLTV ADSDK) is a mediation product developed by UPLTV. You can visit its webiste http://upltv.com UPSDK strive to help publishers maximize the total app monetization revenue and optimize users’ life-time- value(LTV). By optimizing with big data and AI adjust technique, UPSDK helps publishers increase the monetization revenue stably without sacrificing retention. 1.2 Get Started Please go to http://upltv.com to sign up. Or you can contact any of our Business Representative colleagues for further supports. 1.3 How to download UPSDK If you have not downloaded or updated UPSDK to its latest version, please go to UPSDK Download Page to download the most well-matched version. > We have designed different versions according to the different frame- work/engineering structure of Eclipse and AndroidStudio. Please download the most well-matched version refer to your actual development tool. If you are a Unity programme, We *Strongly* recommend you “Unity Plugin” for using. It will help you integrate with ADSDK in an easier way. Please go to Unity Plugin Download Page for more information. 1.4 Support & Feedback If you have, you could contact any of our Business Representative colleagues for further supports. Or you can also email us directly via [email protected] 1 UPInteractive Document Documentation 2 Chapter 1. About UPSDK CHAPTER 2 UPSDK Android 2.1 Quick Start Although UPLTV ADSDK has done well in mediation and packaging, but there will be some problems when some of our partners integrate at first time. So we optimized the process for integration, and we also gave some suggestion towards those FAQ. In order to help you integrate UPLTV ADSDK successfully, please read and refer to the contents under this label carefully. We, with all our heart wish that it will help you and bring much convenience to your business. 2.1.1 Android Studio I. Structure of UPSDK Directory Regarding to Android Studio or Gradle built project, UPSDK suggests it should be import by other main project in *.aar format. You will see the structure of directory for UPSDK Studio when you unzip it: 3 UPInteractive Document Documentation 1. Main Package of UPSDK Please refer to the screenshot above, the file named UPAdsSdk_x.x.xx.aar is the main package of UPSDK, you have to add it into your main project. 2. Networks Dependencies of UPSDK The relationships between UPSDK and other networks are loose and coupled. You could remove some ads dependen- cies from the main project to reduce the size of application. The dependencies of networks except Admob and Facebook, they are existing in xxxx_ads.aar format. 3. Ads Dependencies of Admob and Facebook Among UPSDK local files, it provides aar dependencies for Admob and Facebook in case of the situation of bad internet or other unexpected problems happened. Even so, we still suggest you to update the dependencies online from gradle of Admob and Facebook long-distance warehouse. > Regarding to the specification of how to integrate with Admob and Facebook, it will be particularly introduced later in this section. II. Using Gradle of Android Studio to import the main package of UPSDK Please refer to the introduction above, add the downloaded files which named UPAdsSdk_x.x.xx.aar into libs directory in your project. After they are added, the effects of Studio project acts like the following screenshot: 4 Chapter 2. UPSDK Android UPInteractive Document Documentation UPAdsSdk_3.0.03.aar is specified only for example 2.1. Quick Start 5 UPInteractive Document Documentation To make sure aar package which in libs directory could be import correctly