Android Ad Units Integration

Headline ads are designed to be integrated into recycler views. The best practice is to extend your  RecyclerView.Adapter and RecyclerView.ViewHolder (AdHolder is available in the example below), in order to pass the relevant Placement and AdRequest IDs .

Inside the adapter’s onCreateViewHolder use
HeadlineAdContainer.getAdView(Context context) method to get the ad view and return it in a ViewHolder.

Inside the adapter’s onBindViewHolder you will need to retrieve HeadlineAdContainer object from the Placement object by calling it’s getHeadlineContainer method and passing it the ApplicationContext and the AdRequest id as parameters. Then use headlineAdContainer.bindTo method to bind the Ad to the ViewHolder’s itemView.

@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent,
 int viewType) {
     context = parent.getContext().getApplicationContext();
     RelativeLayout adView = HeadlineAdContainer.getAdView(context);
     return new AdHolder(adView);
}

@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, 
int position) 
{
     try {
        HeadlinePlacement headlinePlacement = 
              (HeadlinePlacement) Controller.getInstance()
              .getPlacement(placementId);
           // use next methods to customize UI (optional)
       headlinePlacement.setBackgroundInfeedColor(Color.RED);
       headlinePlacement.setTitleInfeedColor(Color.YELLOW);
       headlinePlacement.setAdvertiserNameInfeedColor(Color.MAGENTA);
       headlinePlacement.setButtonTextInfeedColor(Color.BLACK);
       headlinePlacement.setButtonBackgroundInfeedColor(Color.TRANSPARENT
       headlinePlacement.setButtonContourInfeedColor(Color.GREEN);
       headlinePlacement.setBackgroundHeadlineColor(Color.GREEN);
       headlinePlacement.setTitleHeadlineColor(Color.DKGRAY);
       headlinePlacement.setAdvertiserNameHeadlineColor(Color.BLUE);
       headlinePlacement.setButtonTextHeadlineColor(Color.GREEN);
       headlinePlacement.setButtonBackgroundHeadlineColor(Color.WHITE);
       headlinePlacement.setButtonContourHeadlineColor(Color.YELLOW);
       headlinePlacement.setSwipeOffLineColor(Color.BLACK);
        
       headlinePlacement.setTitleText("Some title");
       headlinePlacement.setAllowSwipeOff(false);
       headlinePlacement.setHeadlineMode(false);
       headlinePlacement.setButtonText("Click me");
       HeadlineAdContainer container = headlinePlacement 
             .getHeadlineContainer(context, requestId);
        container.bindTo((ViewGroup) holder.itemView);
     } catch (DioSdkException e) {
          // error handling
     }
}

In order to customize frame and text colors use optional setters on HeadlinePlacement object as showed in example.

Note: Headline ad will appear in case it is loaded before RecyclerViev called onBindViewHolder for it’s position. If you want Headline to expand after (in the middle of the screen) you have to call notifyDataSetChanged() on adapter after the ad is loaded:

recyclerView.getAdapter().notifyDataSetChanged();

There are additional methods available in order to control behavior in case of switching between  fragments:

• Call (HeadlineAdInterface)ad.finishHeadlineSession() to stop the ad and release the resources associated with it.

And for video ads:

• Call ad.leave() to pause the video ad.
• Call ad.reenter() to resume the video ad. It is very important to notify SDK with these methods in order to get best performance and stable work.

To use the ‘snap-animation’ feature for Headline ad unit when attaching the ad to the top of the feed UI you should add HeadlineSnapListener to recyclerView and implement an additional method, which defines how to remove the ad position from a feed.

Reference the code below as an example:

recyclerView.addOnScrollListener(new HeadlineSnapListener(AD_POSITION) {
    @Override
    public void removeAdPositionFromList(int adPosition) {
        items.remove(adPosition); // items is a dataset for your adapter
        adapter.notifyDataSetChanged(); 
    }
    @Override
    public void onAdSwipedOut() {
      Log.d(TAG, "User closed video with swipe");
   }
 });

Check the Sample App for a fully-working example.