Nimbus Sample App

In this article, you will learn about the Nimbus Sample App which can be used as a reference when integrating Nimbus into your app and testing Ads markups.

What is the Nimbus Sample App

The Nimbus Sample App demonstrates how you can integrate Nimbus Ads into your mobile applications and what is the expected behavior once your implementation is done.

Build Setup

Requirements

Xcode version must be at least 14 (macOS 12.5+)
NimbusSDK and it's subspecs requires Cocoapods >= 1.11.0

Installation

After cloning this repo, run pod install --repo-update in the root folder

Required Keys

Nimbus Sample App has already configured a publisher and API keys for testing purposes. Get your Publisher Key and Nimbus SDK API Key by contacting Nimbus Support
These keys are configured in the secrets.json file at Config folder

Optional IDs

In order to see APS/FAN/MoPub/GAM/Unity examples you must also supply their IDs

Locate secrets.json file at Config folder
Replace the empty fields with the IDs you have

GAM Extra Configs

For GAM Ads it is also required to inform the string value of your Ad Manager app ID for the key GADApplicationIdentifier in the Sample App plist. GAM Update your Info.plist
For testing in real devices please refer to GAM Enable test devices

How to run

After running pod install and setting up the required keys you're good to go

Locale nimbus-ios-sample.xcworkspace
Open it with Xcode
Run the app

What you'll see

You will be able to see several examples categorized by specific sections, such as:

Examples of different types of Ads
Ads by mediation platforms (Google, MoPub)
Ads with MOAT viewability integration
Ad Markup Renderer

Testing Ad Markup

The Test Render section of the sample app provides basic functionality for rendering ad markup using the latest version of the Nimbus SDK. The tool provides a text input field that can receive any well formed HTML or VAST markup and will render the ad as a full screen ad.

Open the sample app
Tap on Test Render
Copy the contents of the markup field, without the any leading or trailing quotes, from a Nimbus response and paste it into the input field.
Click the Test button. The markup will be rendered into a full screen container.

Sample markups

If you want to quickly see how the test render works, check out the sample markups below.

Static ad (Banner)

Paste this code to the test render to see a sample banner ad.

<html>
<head>
    <meta name="viewport" content="width=device-width,initial-scale=1.0,user-scalable=no">
    <style type="text/css">
        html,
        body {
            overflow: hidden;
            margin: 0;
            padding: 0;
            height: 100%;
            width: 100%;
            display: flex;
            justify-content: center;
            align-items: center;
        }
    </style>
</head>
<body>
    <a href="https://www.adsbynimbus.com" target="_blank"><img src="https://ad-assets.adsbynimbus.com/Nimbus_testad_static_320x50.png"></a>
    <script src="https://dev-turbo.adsbynimbus.com/impression_tracker/T1QzTklsaEdLS01kK9yzmio5lTvk7K_lbr4p6yVKI50sG9ku-llDIi9tSsPa-x1coB7H5LsXiSB6vl8Dl6V4nrC9qwxl_TXFoy4EtCfZfiCHxdCed8WDmwmALDV1O8s2OjYsk1kDppKIAPwm3oaUUoULRzQQk1lgPFVCBQJhP2d3rqi1IB843zBH0ku35KJgrTG4fQdUqBEPqsZcHxmsmiPfRQYGrdSl4fh82AONjRd0-9GjMASy23S-g4nZXvYPMc2fRM55X8are1A131xyQHKW3qqJGhhXDRi7vkVsmF7Vh0SJc4vKA46dJ_qcF2BWK7COFn3-Ln7gDJQwb-6-izPAuFQiJCmnxy5VKRhx-o3tRAj0n7ivsChYM-qcalHtajJDnjY2WVdsAiCB78x2aitlBfl74xylK_rURLUQRMRWtT8zmigknRP5dbnry05ozcVoHMOfVg1ths41gAtgPn3KcrPlKnt5-sV3yvcF38u56KWfbzFSovehWlmbRcvG5MPl-rrATr8WMcpQ0UQ8AZRjvHJmow038otvMChz-MaEKZXe2426pCw9Z0SrFFAyyZIfAlVJtK6A5WhavB8_9mpynUnsWclJzgluVGMt65LSC0lbsIRxJM0jp2WNZHkVxg1kNjaLpflupuNRnB2N0QMLwSkDsLu_YyipBUMKjisYLJSZafienMTKKmifikAlG9fM5W2ZJX5RfAWIKGfWoJwJOaOfwNEAG-UrKyBANftT10ewt2xzppLGseHWv84YebWGejvVd1P0KRlA53NEA4MJca5rmId3cgZ3Yq9K8oZzo7mVEoPyH__dOvSKUU5uUOdKGbx35j2pY5OYpCcUaYgI7cxSUtl8VsR7dWNQJYBPfYZwcA7SPd0qHakH3eKVgnIXAaORx1xiW7nbZVUcnRxS_uoCtmj7WpAa3ioCcNmrRG-nWPLAzPvVbgWUAVDiX402Q6WS6TSEz-r-bhjLSFo-f9xpbw0tiy6r-eGlxfknqAEKbY9Iao2WyEkZsAiIPuYtovkTVspdPc1kFr2l3xlrKpnrJl9HOBktJ9_JSFep1RCESwIis9W0vYqWAJrIuDUfC3L1VfJSHPjSjZ7jCJy91MXel13dFg3rm7g-QOdi6MhoSuY9OpPDiIzY2ziGRgcoIXowgMMll2Or7brxnrlMIidt20Pka11xjVJELabQWaY8Gg_HcCS5Toa6LMnA0pZrZjQXD2S3F7TQ8Ou7tgBb8AeTJeece8zC3pVNt9wwEMU3rSsKpnri6NKsAdoNukAaTDqkwtcTOSThyFNteBoGqGY3Ya6WcuA2DSxyvlNPFsKmnQrjk89dzzkK4O8g-uHj2lnPXPyVl2442wtI2W7d2A4Z6zCAZd_KFyNZI1BCGDA3EcZZkw1wJ9zCnJqwRYqGb7ss0Dj4ApI6vZcMkUtn4o2XeYNkN7iddts-avNh6G4wQ9NTPeIQXGm6cNuAh8Bd8IFlzTljjgNfADRIvDM8hfU0Zu7BE6Pc2NjUCMfktoOC0w"></script>
    <noscript><img src="https://dev-turbo.adsbynimbus.com/impression_tracker/T1QzTklsaEdLS01kK9yzmio5lTvk7K_lbr4p6yVKI50sG9ku-llDIi9tSsPa-x1coB7H5LsXiSB6vl8Dl6V4nrC9qwxl_TXFoy4EtCfZfiCHxdCed8WDmwmALDV1O8s2OjYsk1kDppKIAPwm3oaUUoULRzQQk1lgPFVCBQJhP2d3rqi1IB843zBH0ku35KJgrTG4fQdUqBEPqsZcHxmsmiPfRQYGrdSl4fh82AONjRd0-9GjMASy23S-g4nZXvYPMc2fRM55X8are1A131xyQHKW3qqJGhhXDRi7vkVsmF7Vh0SJc4vKA46dJ_qcF2BWK7COFn3-Ln7gDJQwb-6-izPAuFQiJCmnxy5VKRhx-o3tRAj0n7ivsChYM-qcalHtajJDnjY2WVdsAiCB78x2aitlBfl74xylK_rURLUQRMRWtT8zmigknRP5dbnry05ozcVoHMOfVg1ths41gAtgPn3KcrPlKnt5-sV3yvcF38u56KWfbzFSovehWlmbRcvG5MPl-rrATr8WMcpQ0UQ8AZRjvHJmow038otvMChz-MaEKZXe2426pCw9Z0SrFFAyyZIfAlVJtK6A5WhavB8_9mpynUnsWclJzgluVGMt65LSC0lbsIRxJM0jp2WNZHkVxg1kNjaLpflupuNRnB2N0QMLwSkDsLu_YyipBUMKjisYLJSZafienMTKKmifikAlG9fM5W2ZJX5RfAWIKGfWoJwJOaOfwNEAG-UrKyBANftT10ewt2xzppLGseHWv84YebWGejvVd1P0KRlA53NEA4MJca5rmId3cgZ3Yq9K8oZzo7mVEoPyH__dOvSKUU5uUOdKGbx35j2pY5OYpCcUaYgI7cxSUtl8VsR7dWNQJYBPfYZwcA7SPd0qHakH3eKVgnIXAaORx1xiW7nbZVUcnRxS_uoCtmj7WpAa3ioCcNmrRG-nWPLAzPvVbgWUAVDiX402Q6WS6TSEz-r-bhjLSFo-f9xpbw0tiy6r-eGlxfknqAEKbY9Iao2WyEkZsAiIPuYtovkTVspdPc1kFr2l3xlrKpnrJl9HOBktJ9_JSFep1RCESwIis9W0vYqWAJrIuDUfC3L1VfJSHPjSjZ7jCJy91MXel13dFg3rm7g-QOdi6MhoSuY9OpPDiIzY2ziGRgcoIXowgMMll2Or7brxnrlMIidt20Pka11xjVJELabQWaY8Gg_HcCS5Toa6LMnA0pZrZjQXD2S3F7TQ8Ou7tgBb8AeTJeece8zC3pVNt9wwEMU3rSsKpnri6NKsAdoNukAaTDqkwtcTOSThyFNteBoGqGY3Ya6WcuA2DSxyvlNPFsKmnQrjk89dzzkK4O8g-uHj2lnPXPyVl2442wtI2W7d2A4Z6zCAZd_KFyNZI1BCGDA3EcZZkw1wJ9zCnJqwRYqGb7ss0Dj4ApI6vZcMkUtn4o2XeYNkN7iddts-avNh6G4wQ9NTPeIQXGm6cNuAh8Bd8IFlzTljjgNfADRIvDM8hfU0Zu7BE6Pc2NjUCMfktoOC0w" alt="" height=1 width=1 style="display:none; height:1px; width:1px;" /></noscript>
</body>
</html>

VAST ad

Paste this code to the test render to see a sample video ad.

<VAST version="2.0">
    <Ad id="68a4d4c4-389a-4c15-801e-9d19f72a6188">
        <InLine>
            <AdSystem version="1.0"><![CDATA[Nimbus Adserver]]></AdSystem>
            <AdTitle><![CDATA[Nimbus Test 480x320]]></AdTitle>
            <Impression id="sdk-dev"><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/aEQwUWdEbDVKcDRPTBTFK5dF3kL68FR16hVrBkUwBZOsTQDXM81u6rfJCK90XxsIjVXc-GhCK6mqCGIIepRh4W-jX2vl_OMW-ZaKOr0LS1PrUPQ9oiugs7ZHSzsdAeqcUdHtFCNT016jEKXvCa4NvCUbHVkcm79JKTVIzqpe_1yrP0SRrbKZDS43iQ-P5jTUXKtuSQrwEAAIPt16xkfyC8lTW7HPUl7S4L-V0AfVSfcX3WxQUEgdIWSSt-3xO-H1t269ncvoy6KJb5jeX9wHQ4RhvKlsI_uG6DWN9qzUq0ND2nSWdlrPuGh1gVtyc3SPrf0qq6rxR-LC_kBeVAGIc8ADEZhDbnSANKvDMGBTYLlSvtdHrPSvf8q8iS7YUQ1SAQuyUynhgUsdfqs41ESPeeBErh6tfKVh-wTCdGz0Og09kH2MOt1nsHi6bZd7qKqHOSCxoqsCz_ghmu3vPtqd7rBksm3H6_slI22XwWsuGfeD4kJ3bF1IK57n0EnE4yz_UYy6fdam-C7JXSw5Q6Erkr87VS_-Yz8JKikHQL4FOgdW-51pFqa-63ew3x-kY1dpbRyjUUAp61Kx2rxE5UO2sJYGfTpxtjhNYxMshgaypoVbjt7LE4xuWgX7PSmOtvSTGy3e3xGTbEUSJa_5WLf7nMTeuBxsco9W-Q-pf5r4gWopnQ7D6U1nF0d1sdbPLHduok2N_1JuNnEDzOS5XTZmOpbtVFkLL-PCdYCvr6Yx3yor6CzfNgK0HoukeiqJVwnWEG-Q5t4Hoj0B2zl95l6xQl6A0aiAWlf5rly8sw5KVi2mbdOaW_HrgKETS0h6zd6ltwCsmabejISlOvIMCB_xCIPngGFfOY9eiP7oeWWixJSLlQjHJqCcSnmL8QjBdSMlovFVXT_yYbbGpALAEb5SrBvObK6FBhN3Gr5Dya031Gb3TYt7FnmSSKctv9IuVlEZed6bm_4iYEtqplX7Jcyp7ZoDwEVtsAeGO9cz6vO-TR1rTpqWa96UnDdwYlw73aZnuWH63pbJ8GNq9QsW6zz4qn9aGhfZZioiVMPUwceua0R1sck5Qi3GLZ53hwwxqk8lMoXETWzZXM6CK2KggWVS_cyk_mP4GSKK4adEFOy3RVmkcDbRuuYYYnZFA4uGl40tU7hXWz0OowLj3DJn1bcS6WvZJezrax7e7Bd1f2EgsszVycpIW5SdAVW6lZBYQ2Y2lG1y-qEqcZZM0Awa0tZzr_yHdpFZ2hFU27eiG24N26-kotCk9pwnwIRDGVsUBXbmQ_m9g26qBKXolt5JVFoUkxO3tqeqToWHvXFIazxJIOfgGjqfHSzfNpA1h13AyBXGFsS7cVsafzRKclrt3_BlBPjo082SUMV8lDiSmyk59OvXTgqyPPbtqFUNhnMImcMEyP8VFz6P2-cOfxM9q_Ipqdmg9JoLXzcAFuPpz-s1ddX-YvoAX4NxixIH4ssIDw0Swap4Iij-w4hr5PVWz6dMkNOUJmIacZRyhKqOkf0UJF7A8UM9Sulvjiey2uoRlv7-]]></Impression>
            <Creatives>
                <Creative id="1" sequence="1">
                    <Linear>
                        <Duration>00:00:10</Duration>
                        <TrackingEvents>
                            <Tracking event="firstQuartile"><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/VE1BNDZjclJJM2U1y_6fE-fEk4exmihlzwjRXKLk1msE_cKGzdDdyOwTMRj-NMogmM3nSepGEXnqdEDZD7DjmzHoD3NqhDhB6W4HH4TS6ZdzWeWeV8Qqv2u2oxQbRGqm5ibe1SitVK4QQHfvAfY7iWIlbiuaKzY4iusXfp5WPLAeheeghN1d7wcqrgyNaSkEUqg55uWvkVv4s5bZwl1wePOz59nEtLdKVj1-98AaWmThavvbcK5D4t44AkPhE6vgI3URqRe0yMl72VqmG6aV32Z20RZpSYDwPYJc_1ML0aeUmfsFAKq9oimAngI6CVRyWQ4gL3J4ibH9z4rPoWN6_Yp7gWJ9Ff2LqW5g0b20mkuZ7Yxt9hImARRGVpD3vpfeliQuJXHdBaA8mFU3uxgpL3h4SjkIZLID9yH6mnd_FnDTChRIbf2mNAmiOwrPFA57dFx-lPShXnzL3E4SOOg9mB5z6yLhiRinjHSAN36N5FerllsVuPzpobgotNTbMGoHr0yV1PaZxrGwI6vfd2ULqCczy0dprAX17_tIlPPTEbsGBLUqQ77aTjlkG-bDa4xojN1gwSfnU8RepcKg1Lou06u9gHsCXuN1NZ3uQtIbISuKeLOkjW2GGt0DknfsqKhDqoXKrbe-YRy7GqcRvvnYoEeDBrOxpXZ_g77K57JDkAc2f-koED1PZ3l9owsG8KB-XsdRG1_C5Wddrm3py5qe5OmGe0OhW-LY0tDIhqDKOPx8tVl0fGc_SmEgQs1Q8Ixcse6FpHM6zGRW5e9CQJDcd78VbLzNPboLmqVtSe1y2xo10gIRZLt-COjvWb4tGdZ-pKc_fQhZkm364zW4udO6tYq5l49f2gWOrcZvpIGMAQF5zoEej8Vuc3elZ1SKRT4IzzBEGhaL68_1wA2EJ7KqQi4bS4aDviKoLdAO0IMEIidryIzTiVhaQg5T1WBeeqaAuOjlSC9HPC8AeHKrtj0XRuqIbwZSEHSWVx93AccYN1TrZakg6G-oT3PWOVxSEza7qzwz0D0MXJB0nyLBmrkGb0vCmNO-kodkjkC_aTlkIkkd-jXmGnBI5CGMiigz47l0Oyz9E3ZGCT2KRj-HiiuN5UlNkxR1XI6tmFnwrGqePyv4f9zO3geTpPZ9Fq0aT0TZi8uBtNg_GtccIVFEx9cF1pZbb7iWbmfaGhXqJiSyXxE03pVS3IAQCYgqWIF-Zm8XGGn7pdLL_wo1nFUib2qi2wcPT68zIGyrP35gV6X_4dR3dS3YlFw5NROFHWzP-NOT2pgJ2pvlx0PD-_-rLhzOYjwfHjObvGlVx2wfXlhj1oJqJaWaoKlWoFN3Rv3SzfmkvOJ_srTdGlBE7jZVqFof9-6UkbFXwB01k2YPTbRHkLuYJVbMhy4QiWwZptUvccmBHTH85y5sL7KVIFDKC_Nre6uPbob89vZmGfVVbItn6VgCoA4hRL76yMAUlt0oqlGyFprUgIYzDkUQ4j9iWXvfDB-UDVQtvWo6n-iNaBjOiTJUmOq5T3sEA6q7lOJE_R2v5w1WJHDmBo33kW8yUEng]]></Tracking>
                            <Tracking event="midpoint"><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/cVRfczdsUVZwTVRMeB7_L4rtMle2VJbm560e3lSZ_Ukq7fGYwdeiA6nOv6B4e3VSglpioSzQLgzGTM69iJ9EHuv6aGeawybc8eZtag6gs4TDw98exzdKY3lBNRwtZnh_VsJMDUuzbSNGqM8idsYvTzm6y2RTG0QaRCccv-cUPsBJOOA-zCCRtsujoqCJ7ShvZ6j7ERv70VJ1ZDIp_dmiVKbXTM7kV2YwzO199cCnIqiETh79MFkxr1mipgLAGkqfgwyDKSwWEHueMQuvlwp-ap85wrSNQ-y4iUTVSgDHucZ2ey6ppbbdIM2pyFPAGGovmxV58J27pn2dj8ImhfI09zSVKMg8-lsGSqGxye9byIdyBVOEX-NxspshCF8du26DrCYjStiQ7BX1AUjjOGBnYzmd4tSC6HbDvOo2eityVPOggLHqnXO_RCrBAePIE-I82wVw_KeHJ9U91q6v5gQ_zgY0uexJezfQcS4z-iD7fmYZmFWxPe7NfIt0xSwW6N-wKo6McM6ZQlCQTaBd_q4soqShJ2QB4cg2U59Z88pTsabdGW9v7Lo4-yh41vD3SYFq7RudMTmxl7M60QceK-Lym8BtyojT827VIsajBz2cHYNoOO0Po3WvhqUxUeZepEMwwsm3_BhJz1yBfaZ9_BDc6BemgDQPwvbHAzF7PwlF5lhB-sDhF7c7p9HQvdOJiAtHKzdUyGivN83SBNyBLwF3iC2yfNlEW48o4flY40dFVNxpkyHrgxmAbqF6Bjpi4towdjSGIMopt0nmQwFXt_QAvWKRyzwnepxGiAe4VXDphcoH8xQ1XEpSgEJWbPA-mS0jNtwEXpchlieZMKpgqUZEXc-3ESzuyWYsOnWLpgjqjYWB0SSAMPxng8krSzyVaJCgU84_Zs2_9UclHuwf4wPuNnNB2P7_MU2i6ZayUDKW2Txk0D5h3ABlgH1gb9MhBTWx79Z2ANddOjhzRcOq7rhpkky8aixGa4KYHUKb7bSdHl_LVuTx721RwEtUWKQd-WAJsrY8xvSfcTS65CQ2XMgGmy2BFZ-poXytefDz2WZKhH8HVA2opOO9tg_MA4FtciXGw0vY5GKEek3JhAlKo6LHdwwQzfTSWi1_wXxU8y8f0e55HhDotdzJx9osKKyRUgD_gUl0avZ-WqssA3Y0BB-3VZ1XGWnA9-K2qWa0H_7thmvUrVgsqdo8fqNgehPWLKv5-on-quvvTYLkroYFb8Dmy2xRzpTru5BIcRe7qRiM8WufwqCQtFf2DjDsPL5FVp0iSEHgvf4Fuja1GsGRko4GkUW6C2wKfzRxDj8H6fS8fJ6KrPw1tT-qiyPGo_6d8PfLL1E_fqN4YDed10e4IYKHTeXZpATYUia4QsPw0Yd47IKoKguvhJhFq-eAqPdEeJiYfTHL8DxqCSU7XKAWqqUCyO0qcCUAYv3e7YyVlUCIXcqATpOH5s7FeMLQ4qC_xDXZ3T8sme_jjssjbNCCWAC2f-39r1NlkzJSAuDiKxBA0kLhG2zDTWOJXcflnD1XdC1G_Z-CovzmHIBz5bH2SOEc5Q]]></Tracking>
                            <Tracking event="thirdQuartile"><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/R3g0bTkyTFBGTWlC7PJj9v5NIHQhwO2b2lsfM1ofI-i2GE5T0FcynClcXO11L_Ms3ZKBLw86AQk0x6WahHqj2zjHHz4NxcxEu8WYDdBFCUIqRxY1mvz0nEvkvlO7a2ALhNkvD7ePg4nfg8DosSPBmnX9D4jgdI79-QFzm0j54DuZ6zywAOR207vUNCI5FMWGoEmxoQZDulSrS3sBUSS-DDBOffYpxUCvAJ4hX1Ygh2_UNXiFq0o9Lb3i0PGqlEgecPq27rJ1sj6x7fvyQ4Jdzy9VkIVuAU-FbCtOXOc-ZSLo59iKI6-wsxgUUyFJC_Qga9Km9V97PsnCUxK2TH4mhY8cwGFbpggNLcWhBxNo_ktJfOUC95YR34hXlk4z1PsmLnZc_J_ndP4AW4vUFaoi-OEoSFFZG4Z4lTIFvUjRkhkO035KgmcoWBpG8pn534YTSp7DQKrpqjCYysFi170DufF90c3_U1dKcqceLi4uuAab29N_n0qCB0fK3G9A3oL5reZY_CQmdqIZNUBjpWMb6NnQHgRakDjm2exXFvLlKOQ9hZT89q0qkmtVFT5a54NldOrdxoiTgph4xWbKE7JAAkWHRHu_lJbAHXSn4OK7Fa5HljpEtl4pYqd12hDgEbOjMvwf8UE8aLaJ34tHWZGDnUgFVd3PgNPI2bMDZJ3dBhIPz0Y8qsQja8Mo9ETr-ZAZVcG_0yMFtq-M5CR1BPtXjO-K0jEjA7lRpD0z76sAJH0Q-xY1ggRWwQdlspdFs-YZxg3cko03ScLQ2cdEC6D0gzWp-dBjsZVn-JSzuaQ4GE8DEqNevF79g_16Tu1RXEtaXCN7bLn3tcOtOKIE3HeGjguAjUF1cveb4PvAHgEv-R7yyt-COhUw2XnarGRLx1Q0zZjBgJ9V3b6OJkCkFe9xGEKAw-QYFfbDjZCNJLZw6S11wvlcs3Nhb3KLXSzMeqMWG1A0Uf1is27VcI2rPgvU_vIEbg2tmbKNp1HJmZLyrSOrusyP28y96opCZET9GDlSJNgl0Z3RYhrjVndDMkd75-jApx2hK4bBVXBq-1D3bX3XwIgZLe0BOj28JHvjplizoAzr2fkQdM6jRgHocljTMKv6tdqQSkHIZADxO1Xsdf3w4XwUOwBk-DAo4TpirH2kEisEGTr4F-L8oCRjCPNcanQhT2Cy4-lxXez0N4EwCB0qQYZTidwXHErZj-u6dTB5JWDblMp4CVJHoO9XfVZtQYlWdXKRR7iIe0ubsUxwuyRfnW78tqn2TQEpL55t8kGhxugWL9qIWdFoK2aT0_HF9RCGEyl-9j9EQTu0l_9LrN5I_SO_rn7J9gGM-TCDCQnmbxzodylHIyajPSUl5M7QGCYdBvBJtewYD0kmSNsENcE0dz74QgqrEaaZe058rZUukygvInf5RawcqMYKpQLaIY4dLhkBNxa1b-yWTY7NEAhcOOFN70sMWaL5az_eWkdWpUTP85pYBOK2uiOsJVOc2skCXOddf3ZjnjI0Fhlyp5yO5OREqeczCzbGtBauS6IWbB1fySqlm8BX4eSrTlCZ]]></Tracking>
                            <Tracking event="complete"><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/SWZidmk2NEtEMmt0vrVInr_F2TvpaS2Xi-K5TcAfVUZmtXm1KfapPxdoqdE0rO1_WVEHi_wpHGJUVLkYFFGwAQPICTskcQVa1OqeLuqGG3OKgJaQPSWTyeBgHr4mE0G1vz7n8KFlUD3dGmf1h11PiPYXPsuTLWRZVoST8hunTl0p-jrKgOmoCd9pF1LvK3skQ8eTxaPFt6vyRJN3LY_M0pRpKx-IFf_Py2Sl0xcnfqvaFiVYrUd6m5BOhkJrzRxKVDjL8QlkmZ1oYCkBSW8jinHWEF52SaiW0XrNk6HFQPy1WYAI0hehK-SebhMhG1lhxkLG__fWEY6cjRRWal0a0-Z8F10TeMgTX033nUoNP72Moo56c2jeq-IdoXMCuBFgtJC2MmEXNDebSnGEdZQWyF8_JbQTvv_QO99vX54eCjH4ZXA5nr5sMO0UKSn8fLSEsxr3vqLdfgHdCtxUIUUr2fnAGD_yXCVQHehq7XaR1P3zAwmTVSOvAOy4qX-lNJ899vIIX4QXaEfQnmA1ln1kj9kcNT2fTkTbchM7BESIWmRZolJ938DIRMbEo1P6VuDm9nqKLV-41273wKTxGCjxxgZ_HHNP8aMsHGEvs4hZ2U-8pYkInzrL0fwSueuNoWjbGPWKGuWZhuTuqGhQJCMYYbv_A-dingGqIYPjro5nYdYqQGIa0zsSRELndSogWxRt9CmDP4aWoa0pWxs66RCA_HjtQ9KxDRX_V402cRe7IbJv7Ziaz_CYRr6zxrjoDPu99MxNvjt2S-Jmfwjyv0gZS-rl_X39GI_mz6tpZJbtLNApfdw1ZNArOFjUpr7ll6G_oPMsv33-vvxKbbi66oFMBEg0hTBVe1HC2gkTclni6u200kkvaGF8nhe4SL3vNq5FI5Si8HUBGFIo3COhD4yBXFVMY4aw0V5N7gzeaSRZx5ndJGpG0ty-bQUFZnmgZ1MNDoxU2Q5wHZTdzJlHVuNqSbm79ApjqiKo8YrBwE-_tN29ktvgWhip9ZB2vfYM7XUHpGzADsUlpaTbEFs1Rrg0-WsRN0A2pHArlQmtCE21jgAmGPz70xLHTQclr4sEdBaE34WnDHcYwgJg4-SB-NPrZIvUAdagqkaOn5jvhXYAZQseSD7iZygMWFHstGvD1qy8E_fEn33XWCROfTPe-sDG7lIoyIYuEyLW0zvOaFhAFWdOyN2_mlyChpQXHPMhSZpbRui2jXUzwNzejejMIDloRrvkvXmMsztz35iby3kT9PFa_KuUyQPoWQ1HiMtcF-f9nD7kl-5K9TJpARnKqnqVGjIkq8RVh9DccSQGVwSF1b_EjDgmH_nPb-gJ6KH9Rkzmry_umrHNjT0PuT1wjyh0O-UVAL6DOlNaWjFKLEompipg6243xtL05VBEMCZZ7t0He3Tpq9CFVssnV4WC_pA4qBEn89iJ7VEScnnAZlYJXBTMrPZoSTn-zF3EREn-DpJcDacHb-Bn03t2ndM848v_oYcBXQUjdLFaYcl1e6ZMcW0eovGFgIWnvxui4rPKOoY4xFi2F2f1fY34vYDLBLJhfw]]></Tracking>
                        </TrackingEvents>
                        <VideoClicks>
                            <ClickThrough><![CDATA[https://www.adsbynimbus.com]]></ClickThrough>
                            <ClickTracking><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/Vm5aNFVCRFkzYjRO5wI4hxtrt6ayidNmU8UjdHLBuceyv1nuhqHc1z1aqmnKNBKkQP9suqV7jdnc0IH3IehIkxEEFiRHszx3iAvQvzpMHOpFsLtlpJMpsUDW2Nl1jx4cCPfVr25tITbNxJkiWhTZD_waPX09Q3NLvtwatULyhS5JU6VF5xrPazzsgBi4VBRAM3UsZrtTk3xlaarigsKaWHaTHZ7fDONs3M6VnbziZRH3JnXS1oLuzZV5ILQxlRxOjMwAHNOnfGESbK4wiIdtuIBYQ8dlC0ChWXycW-BzBYdxDZ6oDoyZXOemdhp3UIN--VITGXpSBliMcqVAQaUU3KxGqZbVzQsVD-vzHjnj2sLs6DJynpnCdjAF91hq_NfhmNkZ1cvXSh8KMPji0-W3NQV56pOQoq7hmY23ioUxmEMUAz1N2Q48fm14dUO7KMlOVy4vfocDjx0-8euTyLVTfrRpWZteTKq8zUtx3t8NE2iiKRHb8vRQTHEIF-UZJVjH4w3L0Vjn8pNcLo0-y9ksuzv5C_k09FelsX3bDn1oK6yGx7jhAULCXLk_74w_y24gMKovKsRa5j7cPp2EMwvrXhTkiqs431Lp0wqMw1Yuk87uCBZkd3gg3yVwu6Z22SwPsrrDbC1rnVpoYcfpo-RTozgvmoIha3J2TacBhiSPV6UtRslv9WlK_k1uq6METmCK-Ff2f_SpiFaeyjY-VRhhvheGPBFDM5StIFq8rI4livC4J0TF0F498SWlyA9VwnacAQwL20bzdkjOfn6dA0tkcjMMSjn2YSB6yiVUpg0EgVPjcDCGlCDNa3UbP0Y3n7Xq1Esot9Nz5QsicxQD4iJyQ4VLr-UpoMqcuklirDCQLlesENNT31wv50hKi9V50Ycxhn3OMdDHt9ZibcyQ_hJC8HO5rFza6GX4J1VioMYe0vIX0MyZjxCDpH86s0vjHTn-iNWeLVXszfBjCxncJp6NuVHIECNkZ4XSEXAmqINCif-La_JjmShihmfONczz5BciTjFpW7EL4wcPaggMJRMgwcgWix4pOFQ-Lbhpy0gmiNSK0qosQnkVdqqQE7iXFmwcnx6jQpBYGgSS9S9sLZKP45frY6KE6ZlOnGVlrucUWEZzH99FFWo4C_mtfoqWAZ9el0J2dYX54vrosMFpjECIRNIWZjkmu0ZXfm7tSdAOunXBfjIvTim3SOi2FNCIbyKtICCvu5ibNa0LMqKFisZs-XYrrNJPAFPGL6SOmbRYdj4gk5prbOnHShJrcoUF33p4G4_LI6p7Ypq1RPVSjN_PdcbejZarhy8wOLCrg__cM1vhP6iYgSsB-CKey-MWDIdd2YIMACrNB40hpeHmqmLsalWCfRqFxxn0vaQ5o2oTwsUdcL5ESorAn-IpZtoiuhyG-RXGux8EBuGH2y7vODiJ7vtaJkzhOJT3a1QfphghtQTEUl1vR-T43sSlhKuo6y4TpVoadvBGC5u9DnHJtHrmVWBWUZgAt0m6ETgLAhLYqLqomaZMmd-LHxr_Si54KRcLGzz-WVYt]]></ClickTracking>
                        </VideoClicks>
                        <MediaFiles>
                            <MediaFile delivery="progressive" type="video/mp4" bitrate="2056" width="320" height="480"><![CDATA[https://ad-assets.adsbynimbus.com/Nimbus_testad_video_320x480.mp4]]></MediaFile>
                        </MediaFiles>
                    </Linear>
                </Creative>
                <Creative id="3c21ba52-c0b0-49a9-a258-173f34945776" sequence="1">
                    <CompanionAds required="any">
                        <Companion width="320" height="480" assetWidth="320" assetHeight="480">
                            <CompanionClickThrough><![CDATA[https://www.adsbynimbus.com]]></CompanionClickThrough>
                            <CompanionClickTracking><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/TkdZVW9Pd3dYb19Zm26KX9J22qOPHBPqwYzywzyMpYKFqPdR7HhEN9jR7nWIojlFPjIDbUbLY6_I2TBAv3qse3EE12bd8NFpgVN4LkNp66YttPGGD_3FMZ2yb95epIkIjZKjROfWiLli43QDFXX8jgfuHD-9-pZWNYG9MRvvl9EVqQuBAiotH3b57_SNiNscr23CTS4NrihM73gmZbiKklCC6IfaReLFP_ap5z00PWIFxvkUIXjuRsW5kMFjbpcXdNWODdRbOK6bzpJ4QCB3gLAp6V4lVc-VvwhhOwBq4Y_inigZBvHa45vweFeoKfDJQpwtyGkyaF8M4AqQNesTcHB9wqTJdc5XKLB6EFm7oO5GKYHANMTyQWZaTlnqcRtGHswgqzRiEdvJVcqHkLNqiDnV8Cka-c6widPUQLtxwbjGuiLUx-Ff51cdf3-_iSgD23aAN3XaceXuajhH77_n97jCPHk9oz_pbz7wEN_TWpeF3xUkV0w7aLibpdE0HicoZbjGmfQMXLesS4_1xWMjJZFffyHv3iKD0m7QYS-S_frFiz0TT8HsGyv_PHm2XzCTt9vexQK0uo1yIUPsrp0Jhbej-ORoQzINPTejK8L1_bZ96JJi23AkRUvIje5qWrHucJj2aYDYFuWTCioFOtONuDabaIjVjKhroD0uAiLPnd07eEfmnj9WbZoNBsLvMv4Ev77aM4DjuGF6aHuROxsYWPHN5pftJsQyn-8287GvIfZBfewGhcEuUxQRayHVawCoD8stpZBPcnfoeyTWrzN1zmLJShRHW5LeX4QpagQTPdrPT4X86CPlFbegLm4tgYyBBL56nQU-3lBDU4VoozZKVAsLl180zRQaCUCJcmmt7zEm6h0TL5XZ581mpVLk4dvb7Elr_w7Z0t1maeNPczg3jkCQR7NLaOX58G5xpbSR8UVWgxdoheYnuAlkKKBpqnfDyQK1NVmagpaXB84mmipWKd7RFPJTY9wWdKzCVfF2Na-ITH67AorJ9HxmbW1vTMBI5HZaydzKkJwvQCtryyB1gyCmoUFCM7ZOeTxVd-RIF9RKfBKJYDbvaavvBIcuYSPf5ZRv8QVslHzYS4rfmqY6zbUXDHCd4jmuIdOtfIG5Fba4zD9lSdpQkk6PinYsQeuYV7kRZoFZ2mJL8rE6r-RTe5bm1o_uAMpfRySIXsXD4YK04p766nVeIJaIg7Dh1zwOQ8JRE8e8CpFhVgBTUT7YFNJmeWr6B4yAY2pxhz4Vc-5cuCg5_Hx8bM2B77_UyHIKOwJ7EiJaDBCSSYG_eyvj9AeDJDY4HhZkG1oqad_BnZbfh9xs1KnOuXBDaF9ltswK88MlhzbaoHhkx27ZIuYYlRVSBlTOPYwpEjgXo0xT6IILRcBvflWZPMRH-Z7FFPpqUA3HqapoDWZ8vmH8sYGhSHbzEYWKkL3Pl9iCfP16SbXOR5vR2gz_QwxeiyQYcZrKQN5aPx1RpdL3ppwxuEmqRhaN5s1zQXwfmqLvywAZ3iM9jr5aFv1f4fr1BAT5Rtm-DG59ndh2ywTGTP2luFpZmA]]></CompanionClickTracking>
                            <TrackingEvents></TrackingEvents>
                            <StaticResource creativeType="image/png"><![CDATA[https://ad-assets.adsbynimbus.com/endcard_vertical.png]]></StaticResource>
                            <IFrameResource></IFrameResource>
                        </Companion>
                    </CompanionAds>
                </Creative>
            </Creatives>
            <Description></Description>
            <Survey></Survey>
            <Error><![CDATA[https://dev-turbo.adsbynimbus.com/impression_tracker/MHpQaEZRQ09NU1I4qIu6T29VTbuJnS4qVCQzEYfEGFxNKrWn1ieRaUhz-Dp-Zr6S_B1CT4MkiH_dt7D-uD7-KToUczFGrLWJ4_4Opm_9hMgcBGolqC_LrHtwdS3ccPnAVWrISgBI05rCoHMkv-ILA4w_v6TZOZsJ-SWkM05P69v0K07FJJoNBADzC6zK73_hjQWZw1ZJlslarvPn4ZcV4bC6KVRP7yHOCh7Cc6uPtykOPzMP6qOjroQxPDTh69fH9EnhczVraGgAvzAASt5eldOnPPHXT5--MfU2Oa2kqiv9W90jFMxWhmKcWIRxk3kk9-1ucPxsReskHG36FW-Xoc91i7ZaUInvhHgmhWP70k-zBJ68XUERXCwBVlqP53rk9vgeXZHU5RSv1L9qf2jDMbeQaYn2IQ5bTcBxAdbTEEPNnjSL7-QVXj3CNKtCkNbT1Jc4BHrWgvvWiN0fVZby-4TIHqEzXYTm-73-tovR0byvZx_ZGrq7uHDpk4AziE5PZNp9mIN5gjaZ4K7LnXWxf9XNKRZAGDAwjqBBBMsP2UqQJfyVyRWI2VCRegSTxOY-V3nbL733W90h96psk9D9lS0QygYvFOtzum7rTxAcWvMcskbFTZbr8rRzmjwqoLn9t-NgLv4ksGiP8MyBNbkBPmFRdG4VzEAAJIM2RdGikQe2l-vIfNbVd3Qcs8UwInpJPXDDT3s8ViIiimpTCtRolFjfFZvwBxL3_WGJTPaTPP-xVRXxgeKgbB8IgXOXyQY9uAYTOIBtAJFYCrXjnaqrc5TsSmocReQBOvhD0g6JH3bzXGJv4JMTt1leVnidClvCtKLEQbp1BPiw4edHAuQrqI7-3sESuLCkIaweW_AOfjEKm-dupqyDuRahRZ_35d7W_AtPptIiBcw6IdWNl0c3yP6AaQ2q4RRA4mqvXi08Cq74n_fLydKFDp2bcjHjqyCm5Ktskw32fVRK7_01HIBt8weKJ3OoXBlBeqQIlc3-OrwKE0Fr8OGyVZ0A8MCkiLywG-klFOkYGJhtBlOpJirj-fq-J4vTOZYGgJzhfoHBYH0BqJDd5nrBxzy-7UsVE7sGgHj57XwSJG7cnSjpZfWWPAmnDCLcPeRSFSX7b1MsTPMgai3_HHV277hkYy1aG4c5rozIrvIp6pyrgtZTn26d9Px8GPk3rsqNcvSTTmDJjPpgiojWqO_G7SGKXB66GlB4xK243fBWv_GtYci5wECA-IFqkaRsk6GNBMtoGNLxHGzhha6mz7WWiXOeEbzvxfkMq_JULDQ4xom7uYojF5kAipLxOafQxCyxFKJ6bhYIzRgtrFicIJFrAQcTBGy15lS6cWVMl0hIcK_lHDjAGBKsfRLnLcC9xS4X1o5ggBHRbHgmioKPhRqiIXCYeYjxhPD9rF1gZJNt3fbdxLAkZfUazwxGlK6IhFQl0GYkeg38R8gsG1mjbtOjCSvMI8qjbWpenKnWWBs87YZQ91AJ3s1wFGKGXMhpFOf0o6_L05ZikPrVtz9nha_xZTL3Ug&error_code=[ERRORCODE]]]></Error>
            <AdVerifications></AdVerifications>
            <Extensions></Extensions>
        </InLine>
    </Ad>
</VAST>

Verifying Static Ads

If the container shows a blank white screen (a potential bad ad) or further verification of functionality is required:

Ensure the Sample app is running using the simulator.
Open Safari and navigate to the Preferences screen from the Safari menu.
Ensure the Show Develop menu in menu bar option is checked.
Find the device or simulator running the Sample app in the Develop menu.
Select the Sample app from the list of inspectable applications.
In the Web Inspector window, select the Console tab and inspect the output for any errors.

Any errors that appear in the Web Inspector console can be ignored if the ad renders properly and there are minimal reporting discrepancies between Nimbus and the network serving the creative.

If the ad markup does not render using the test tool, first ensure that the markup pasted into the input field is valid. For example, if the markup was obtained from a server log it may contain additional formatting characters that must be removed or properly escaped prior to pasting it into the tool.

Verifying Video Ads

Errors rendering a video ad can be identified by a completely black screen with the the close button appearing at the top left of the ad container.

Companion Ads

If the VAST creative contains a companion ad that does not render, check the size of the Companion Ad in the markup. The Test Render tool is setup with a 320 by 480 end card Companion Ad by default; if another size Companion Ad is defined in the VAST it will not render without rebuilding the Sample app with an additional Companion Ad definition that matches the size defined in the VAST markup.

After reading the steps listed above, you will have an understanding of how to use the Nimbus Sample App to help your team to integrate Nimbus into your app and debug ads.

Last updated 7 months ago