Support Center

Web Dashboard - Publisher Apps & Zones Setup

UPDATED: Aug 09, 2017 03:54PM PDT


​​​1. Introduction

As a publisher, you'll need to set up applications and zones for each of your mobile titles that you would like to monetize. You can set up an application in minutes, whether it is live on the iOS App Store, Google Play, Amazon App Store, or in development.
 
If you need help setting up your applications and zones, configuring allowable ads, implementing V4VC or anything else and you can't find the solution in our help center, please email support@adcolony.com.
Back to Top



2. Setting Up an Application

This is a step-by-step tutorial on how to setup an app in AdColony's self-serve client portal.
 
— Step 1: Go to Publisher Dashboard, Setup New App 
Go to the "Monetization" or Apps section of the client dashboard (clients.adcolony.com/apps) and click on the green button labeled "+ Setup New App" near the right side of the screen.



— Step 2: Select Platform and Application 
Select the application's store location, iOS, Android or Amazon. Then select the country for which your app is localized. If your app is not localized to any particular country, you can select the "Global" option.

If the application is not yet live and still in development, enter an app name for reference and skip the search process. If it is already live on an app store, search for the application by name and select the application from the drop-down list. If our search does not return your app, you can also search by the developer name registered to your app. When you select the application from the search results list, your app becomes associated with the application displayed.


— Step 3: Optional COPPA & Allowable Ads Configuration
If your application is directed to children under 13, your app should comply with COPPA. It is the publisher's responsibility to ensure compliance. If the box is checked, ad targeting capabilities for your application will be limited to those which comply with COPPA.

Select the ad types you will allow in your application. By default, all categories are selected so uncheck boxes to disallow. If your apps are aimed at a younger or general audience, be sure to restrict ads that may be inappropriate or offensive to your audience. Note that disallowing ad types can reduce your fill rate and/or eCPMs as it limits your ads.

When finished, click the green button labeled "Create" to create your new application.
Back to Top

 

3. Application Details & Completing Integration 

Your application has now been created and set up. You will automatically be directed to the application detail page where you can view/edit your application configuration, see a chart of recent earnings, create/edit your app's ad zones, and a button to view reports. When you create a new application, there will be an ad zone named "Ad Zone #1" which is automatically created and set to "Testing" status, meaning it is showing test ads. The AdColony App ID seen on this page is used in the SDK integration to identify your application in communication with AdColony servers.

Back to Top



4. Setting Up Ad Zones in your Application

Once you have an application created, you'll need to have ad zones set up to play ads. Ad zones are designated placements for ads that can be trafficked and analyzed. You can have up to 15 active ad zones per application. Learn more about ad zones in the following articles: 
  • Ad Zone Placements
  • Using Multiple Video Zones

    — Step 1: Configure Zones in Selected Application 
    Select the application in the "Monetization" section of the client dashboard to manage the applications zones and click on the "Ad Zone #1" link to view/edit the ad zone configuration. 

The "Integration" section shown below is where you can toggle your ad zone as active or inactive (inactive will not show ads), get your Zone ID for integration, rename your ad zone, and enter in any comments.

The "House Ads" setting lets you define whether house ads you have can play in this zone and how. Backfill is the default, meaning house ads play when there are no monetizing ads available. Setting House Ads to None will play only monetizing ads in that zone. Setting it to 100% House Ads will allow only the cross-promotional ads set up with our Monetization team to play.

The "Options" setting lets you define per session play caps and play frequency. These settings can be used to limit ads shown in this zone, but by default they are set to no limit and to play ads every time.


— Step 2: Videos-For-Virtual-Currency Setup
The "Virtual Currency Rewards" section is where you set up V4VC. The process is outlined in detail here in the iOS Integration Guide's section for Adding Videos-For-Virtual-Currency.

If you are implementing V4VC on the server-side, you will need to set up a Callback URL, configure currency name, and reward amounts and limits. Server-side implementation is more secure (cannot be hacked locally) and rewards configs can be modified here at any time.


— Step 3: Toggle Test Ads
Lastly, the "Development" section is where you set the zone to live or testing. If set to testing, you will receive 100% fill of test ads which will help you complete, confirm, and debug integrations. Once zones are set to live, they will be requesting live ads which may or may not display ads in your application based on the app configurations and our ad server.

AdColony provides test ads that perform identically to live ads, with a few exceptions. Test ads will not affect your account balance. In V4VC zones, test ads will not obey the ‘Daily Max Per User’ setting. We have a policy to avoid directing live ads to applications that are still in development or testing.

New video zones automatically default to receive test ads. Please note that if you set your zone to receive live ads before your application is live on a user-facing marketplace with AdColony included, it may not receive any ads. When finished, click the green button labeled "Save" to save your zone settings.

The process is the same for adding new zones. Just click the green "Setup New Ad Zone" in the application details page, configure your zone, and save.

Back to Top



5. Application & Zone Status

— Application Status
In the AdColony Publisher section, you will notice the application status when you create new applications. 



The following is an explanation of each status.
Market ID not provided: The app's market ID has not been linked through our search function.
SDK not integrated: Our SDK has not been integrated in the app or a live video view has not yet been reported in our dashboard. Once a live view is reported, this status requirement will be fulfilled. 
Active zone status bar: This bar indicates the number of zones in the app and divides the bar by color based on the status of each zone. Green indicates the zone/s have live ads enabled. Red indicates the zone/s have test ads enabled. Grey indicates the zone/s are inactive. This view will not appear until you have provided your app's Market ID and you've completed the SDK integration.

— Ad Zone Status
There are three states your app's zones can fall under.


Testing: This is the default status of your newly created zone. It indicates that your zone is currently receiving test ads.


ActiveYour zone will enter active status once you manually disable test ads on the edit zone page. In this state, your zone will receive live ads. 


Inactive: Your zone will enter inactive status if you manually deactivate your zone on the edit zone page. In this state, your zone will not receive any ads.

Back to Top

Do you need help?

  • SDK Integration Email Support
help@adcolony.com
http://assets1.desk.com/
false
assistly
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete