Setting Up and Reporting on Placements

Contents

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 which 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.

    • Notice that in the upper right corner of the Publisher Application Management page, you can now toggle between Applications and the new Placements tab. One way to add a new placement is to toggle to Placements and click Add New Placement.
      image7.png

    • Another way to create a placement is to choose and app and click on its name. This takes you to the placements page for that app, where you can click Add New Placement.

    • Finally, you can select an app and click the image6.png (edit settings) button to its right, which takes you to the Application Details page. There, you can click the Add New Placement link in the right panel.

    • Basically, anytime you are editing an app, you can work with its placements.

  3. In the Create Placement page, select the Application to which you are adding the placement. The app name may already be filled in for you if you accessed the Create Placement page from a specific app.
    image5.png
  1. Now enter the placement Name of your first placement (the Reference ID will be assigned automatically), and indicate whether it is a Rewarded ad experience.

  2. Click Submit. You see the placements defined for that app.
    image3.png

    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.

      image4.png

      Now when you look at your account in the dashboard and toggle to the Placements page, the apps are broken down by placements.

      image1.png

      And toggling to the Placements page enables you to review all your placements. You can edit a placement from this page. This is also a good place to find the placement Reference ID, if you need it.

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.
    image1.png

  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.
Have more questions? Submit a request

Comments