Note: If you are looking for the Android version get it here! This tutorial is for iOS games. It works with Buildbox 2.2.8 which is compatible with Heyzap SDK 10 and above (take note that Buildbox 2.2.9 went back to the more stable SDK 9). It's now pretty much straight forward and easy to use Heyzap's mediation service which you can use for rewarded videos, interstitial ads and/or banners. Interested? Just follow this tutorial step by step and you will have set it up in no time: UNIFIED PLATFORM - iOS SDK 10 & Xcode The unofficial Buildbox Tutorial PART 1 BUILDBOX SETUP 1. Go to https://developers.heyzap.com/account and copy your Publisher ID (if you do not have an account yet, register first for an account at https://www.heyzap.com/register, then copy your ID) 2. Open your Buildbox game and go to Project Settings/Advertisements 3. Select Apple iOS App Store as your Application Store 4. Paste your Heyzap Publisher ID into the corresponding field 5. Click on OK IMPORTANT: Do not set up any other Ad Networks here because we will run everything through Heyzap Mediation. Leave all other IDs blank. Do not use any Banners or Interstitial Priority List either. 6. From the Buildbox Flow Chart page, select an UI box (for example Game Over). Under "Advanced Options" on the right sidebar, choose Heyzap for the "Ad Interstitial" and the "Banner" field. Then set the frequency of the ads and repeat this step for all other menus you want Heyzap Mediation ads to appear (Game Field, Pause Menu, Main Menu). 7. Generate your iOS project by selecting File/Export/iOS. Ignore the Heyzap warning from the pop-up and click on "Continue". HEYZAP APPLICATION SETUP 1. Go back to your Heyzap "Dashboard" (https://developers.heyzap.com/dashboard/) and choose "All apps" and "+ Claim an App" at the top of the left side panel 2. Click on iOS and add your app (if it is not yet in the App Store, click on "clicking here" to add it manually) Note: to get your Bundle ID go to https://itunesconnect.apple.com, Select "My Apps" and then choose your app. The ID is in the current window under General Information. HEYZAP 3rd PARTY AD NETWORK SETUP 1. Go to your Heyzap Dashboard Integration Wizard (https://developers.heyzap.com/integration_wizard) 2. Select the Ad Networks you want to set up and click on “Continue". Note: I personally recommend to use AdMob, Applovin, Facebook, UnityAds and Vungle. I also know of several publishers who use these specific ad networks because they give the best results at the moment. 3. Select your App and click on “Continue" 4. Add all your credentials from your 3rd party Ad Networks and click each time on “Continue” (you need to register for each Ad Network and setup your app individually before you’ll get all the information needed). You can easily follow the instructions for each ad network provided by Heyzap and use the links available for each credential. 5. After adding all your credentials - and as a final step - choose “iOS" in the "SDK Integration” tab. 6. You should have been re-directed to Heyzap Docs iOS SDK Setup and Requirements page (https://developers.heyzap.com/docs/ios_sdk_setup_and_requirements) and the Ad Networks you chosen previously should have been selected automatically. If not, select them now like that: 7. Download the latest Heyzap SDK (from step 2), but don’t install/add it yet. 8. Download the latest 3rd-party SDKs (step 4), but don’t install/add them yet. 9. From your download folder on your Computer, select all downloaded zip files and drag and drop them into a new folder called "Heyzap SDKs”. 10. Uncompress all zipped SDKs and copy all files to another new folder called “Ready to Install” Note 1: from your "heyzap-ads-sdk-x.x.x" folder, you only need to copy the "HeyzapAds.framework" and the "FYBHZMediationTestSuite.framework" from the "iOS-sdk” folder. Ignore everything else. If you have selected the same ad networks as I did, it looks like that (make sure you copy the embeddedframework files/folders): Note 2: the folder called "Ready to Install" is not obligatory, but I recommend to do it anyway as with each update or Buildbox export of your game you will need them again and again. So it is very handy to have them ready immediately when you need them. 11. Leave the Heyzap Docs page open. We still need it later. Now we are ready to work with Xcode.