Playback of companion adverts
You can add companion adverts if the screen layout of the application allows them. Multiple differently sized slots can be set aside for companion adverts. The dimensions selected depend on the style of companion adverts that you want to display. In the following examples, more than one configuration is shown and provided as a
IMAWrapperCompanionAdContainer objects. An instance of one of these objects is created by providing a pair of integers for the dimensions and a reference to the
There may be subtle differences in how the application is organised, so there are alternatives for how companion adverts are configured and enabled. Still, in both cases, you provide a
IMAWrapperCompanionAdContainer objects, just at different points.
Generating companion advert list
ViewGroup companionAdPlaceholder = (ViewGroup) findViewById(R.id.companionAdSlot); ViewGroup anotherCompanionAdPlaceholder = (ViewGroup) findViewById(R.id.anotherCompanionAdSlot); List<IMAWrapper.IMAWrapperCompanionAdContainer> companionList = new ArrayList<IMAWrapper.IMAWrapperCompanionAdContainer>(); companionList.add(new IMAWrapper.IMAWrapperCompanionAdContainer( new Pair<Integer, Integer>(300, 250), companionAdPlaceholder)); companionList.add(new IMAWrapper.IMAWrapperCompanionAdContainer( new Pair<Integer, Integer>(728, 90), anotherCompanionAdPlaceholder));
Editing the layout XML to support companion adverts
The following example provides a pair of companion advert slots with different dimensions to accommodate different companion advert sizes. The number and dimensions of slots provided will depend on the style of adverts required to be shown and the available screen space.
To enable companion adverts, references to these slots and their dimensions must be provided to the
<LinearLayout android:id="@+id/companionAdSlot" android:layout_width="300px" android:layout_height="250px" android:background="@android:color/transparent" android:gravity="center" android:orientation="horizontal" android:visibility="gone"/> <LinearLayout android:id="@+id/anotherCompanionAdSlot" android:layout_width="728px" android:layout_height="90px" android:background="@android:color/transparent" android:gravity="center" android:orientation="horizontal" android:visibility="gone"/>
Setting up the companion adverts
In a simple application, the activity layout could be the video view, and companion ad slots are configured together such that the video is overlaid with a companion advert when one is rendered.
In this case, the
IMAWrapper allows for the linear advert overlay and companion adverts to be configured in one go. The
List can be provided to the
IMAWrapper at the same time as the linear adverts
ViewGroup in the call to
A more complex application may have activity fragments that are put together to form the overall user experience. Here, it may be more complicated to configure the companion advert placeholders and the main video advert overlay together, so the
IMAWrapper allows for this to be enabled separately with a later call to