Setting Up and Reporting on Placements


About Placements

Starting with Vungle SDK v.5.1, placements support enables publishers to customize the ad experience that shows in each placement. Use it to test which ad types are working best for each placement with placement-specific reporting.

Consider these applications for the placements feature: 

  • Optimize for specific goals: Defining different placements for ads within your app enables you to optimize some for performance and others for fill. For example, some developers prefer to optimize for performance for interstitial ads; whereas rewarded placements may be resilient enough to optimize for fill.

  • Multiple positions in the mediation waterfall: With the placements feature, and if your mediation partner supports it, Vungle can now exist more than once in your mediation waterfall. Mediation partners typically keep the order of ad networks static, so that after a number of ad requests, the top ad network is delivering poorly performing ads until it stops filling ads for that device altogether, and another network gets a chance to optimize for performance.

    Now, with a compatible mediation partner, you can position Vungle at the top of the waterfall, placing it in a premium performance slot. Ad requests for this placement optimize for performance. Enter Vungle again as a remnant inventory slot at the bottom of the waterfall, and now ads requested for this placement can focus on filling at volume after all the top-performing ads have been served.

Setting up Placements in Your Vungle Dashboard

Head over to the familiar Vungle dashboard, which you can now use to define the placements in your app. We assume you are setting up placements for an existing app that is already registered with Vungle. 

  1. Log in to the Vungle dashboard.

  2. There are several ways to get to the Create Placements screen, and we will use the most common one.

    • Click the button "add placement" that in the upper right corner when you click the application detail you created.

  3. In the Placement page, you can edit your placements by clicking the edit button on the right.


Note that:

  • Vungle will automatically generate a Reference ID for each placement you enter; this is the placement’s unique identifier and is required information for identifying a placement (for example, if you query the Reporting API and want to filter on a placement, you will need to provide this Reference ID).

  • Vungle will only auto-cache ads on the user’s device for one placement. Ads for other placements are cached when your app calls the loadAd method in the SDK.

    The first, or default, placement for an app is automatically designated as the auto-cached placement for that app. Once you have multiple placements defined, you can designate the auto-cached one in the placements screens. Typically, developers select their most frequently occurring placement for auto-caching.

    Now your Application Details page includes any placements defined for the app. You can find the placement Reference ID in the Application Details page.


Reporting on Placements in Your Vungle Dashboard

Back in our Vungle dashboard, reporting on one of your apps now includes information on all its placements.

  1. Log in to the Vungle dashboard.

  2. Recall that you can now toggle between the Applications page and the new Placements page. Toggle to Applications.

  3. Now when you look at your apps in the dashboard, the Accounts page shows all the placements you have defined for each app, along with the views, new devices, and revenue for each placement.

  4. Navigate to Reports from your Publisher menu. You can now download reports for your apps that are broken down by placement.

  5. You can also use the Vungle API for advanced reporting that now includes placement information. Refer to Reporting API 2.0 for Publishers.
Was this article helpful?


Need further assistance, feel free to reach out to us, we’re here to help!