Adicionar suporte a anúncios complementares

Este guia é destinado a publishers interessados em adicionar anúncios complementares à implementação do IMA para Android.

Pré-requisitos

• App Android com o SDK do IMA integrado. Consulte o BasicExample se você ainda não tem um app com o SDK integrado. Se precisar de ajuda para implementar o SDK do IMA no seu app, confira Configurar o SDK do IMA.
• Uma tag de anúncio configurada para retornar um anúncio complementar. Se precisar de um exemplo, confira nossas perguntas frequentes.

Adicionar anúncios complementares ao seu app

Siga as instruções para adicionar um espaço do anúncio complementar e exibir anúncios complementares no seu app.

Criar um ViewGroup para mostrar o complementar

Antes de solicitar um anúncio complementar, é necessário criar um espaço para ele no seu layout. No XML de layout, adicione um elemento ViewGroup. Este exemplo usa um LinearLayout. Em uma etapa posterior, você vai transmitir uma referência desse elemento para o AdDisplayContainer.

Se você estiver integrando ao app BasicExample, adicione isso ao arquivo activity_my.xml, abaixo de videoPlayerContainer.

<LinearLayout
    android:id="@+id/companionAdSlot"
    android:layout_width="match_parent"
    android:layout_height="250dp"
    android:layout_gravity="center_horizontal"
    android:gravity="center"
    android:orientation="vertical"
    android:textAlignment="center" />
companion_ad_slot_snippet.xml

Criar um CompanionAdSlot

A próxima etapa é criar um objeto CompanionAdSlot, que é adicionado a uma instância ArrayList<CompanionAdSlot>. A interface AdDisplayContainer usa uma lista de espaços do anúncio complementar para que você possa exibir vários anúncios complementares de uma só vez. Você precisa criar uma instância da classe ImaSdkFactory para criar o objeto CompanionAdSlot.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

Crie um espaço do anúncio complementar para cada tamanho de complemento que você pretende mostrar no seu app. O SDK do IMA preenche o espaço do anúncio complementar com todos os complementos da resposta VAST que têm dimensões correspondentes à altura e à largura da visualização. O SDK do IMA também é compatível com o uso de complementares de tamanho flexível. Depois de criar os companionAdSlots, adicione-os ao AdsLoader. Os exemplos a seguir mostram como fazer isso dependendo se você está usando a extensão ExoPlayer-IMA ou outras implementações do IMA que não usam a extensão.

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

Isso é tudo! Seu aplicativo agora está exibindo anúncios complementares.

Exibir anúncios complementares flexíveis

O IMA é compatível com anúncios complementares flexíveis. Esses anúncios complementares podem ser redimensionados para corresponder ao tamanho do espaço do anúncio. Eles preenchem 100% da largura da visualização da família e, em seguida, redimensionam a altura para se ajustar ao conteúdo do dispositivo complementar. Eles são definidos usando o tamanho complementar Fluid no Ad Manager. Veja na imagem a seguir onde definir esse valor.

Atualizar apps Android para dispositivos complementares fluidos

Para declarar um espaço complementar flexível, atualize o método CompanionAdSlot.setSize() para usar CompanionAdSlot.FLUID_SIZE como os dois parâmetros.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

Perguntas frequentes

Segui o guia, mas não estou vendo anúncios complementares. O que devo fazer?

Primeiro, verifique se a tag realmente está retornando complementares. Para fazer isso, abra a tag em um navegador da Web e procure uma tag <CompanionAds>. Se isso acontecer, verifique se o tamanho do complementar retornado é o mesmo das dimensões que você está transmitindo para o objeto CompanionAdSlot.

Como será o espaço do meu anúncio complementar ao seguir este guia?

A imagem a seguir foi criada com base no BasicExample e mostra o vídeo de conteúdo sendo reproduzido na parte de cima e o anúncio complementar na parte de baixo.