Configuração

Este guia destina-se aos editores que têm interesse em usar a mediação de anúncios para dispositivos móveis do Google. Explicaremos detalhadamente a configuração de um adaptador de mediação com seu aplicativo Android atual, além de outros parâmetros de solicitação adicionais.

Pré-requisitos

Como adicionar adaptadores de mediação ao seu projeto

Inclua adaptadores de rede e SDKs

Depois de escolher as redes cujos anúncios você deseja veicular, é possível fazer o download do SDK e do adaptador para essas redes na página de redes de mediação. Alguns SDKs já vêm com um adaptador de anúncios para dispositivos móveis do Google incluído.

No Android Studio, inclua os arquivos JAR na pasta libs do seu projeto. É necessário que seu build.gradle file inclua

compile fileTree(dir: 'libs', include: ['*.jar'])

Configure o AndroidManifest.XML

Adicione entradas ao seu AndroidManifest.xml, conforme exigido pelas redes de anúncios que você planeja usar. As instruções de cada rede estão disponíveis na página de redes de mediação. Sigas as instruções relacionadas à modificação do arquivo AndroidManifest.xml.

Seu aplicativo não precisará chamar nenhuma rede de anúncios. O SDK dos anúncios para dispositivos móveis do Google chamará os adaptadores da rede de anúncios de terceiros para buscar anúncios de terceiros em seu nome. Se você não quer especificar parâmetros de solicitação adicionais, não é necessário realizar mais nenhuma ação. Caso contrário, continue a leitura para aprender como fornecer mais informações para as redes de anúncios em mediação.

Inicialize o objeto do seu anúncio com uma instância "Activity"

No criador de um novo objeto de anúncio (por exemplo, AdView), é necessário passar um objeto do tipo Context. Esse Context é passado adiante para outras redes de anúncios quando a mediação é usada. Algumas redes de anúncios requerem um Context mais restritivo do tipo Activity e podem não conseguir exibir anúncios sem uma instância Activity. Dessa forma, recomendamos que você passe uma instância Activity ao inicializar objetos de anúncios para garantir uma experiência consistente com as suas redes de anúncios mediadas.

Tratamento para direcionamento a crianças na mediação

A mediação do DFP facilita a conformidade com a Lei de proteção à privacidade on-line infantil (COPPA).

Configure o tagForChildDirectedTreatment(true) no SDK dos anúncios para dispositivos móveis do Google para indicar se seu conteúdo deve ser tratado para direcionamento a crianças de acordo com a COPPA. O Google disponibiliza esse sinal para as redes de anúncios de terceiros na mediação para facilitar a conformidade com a COPPA. Consulte Rotular uma solicitação de anúncio para tratamento para direcionamento a crianças (TFCD, na sigla em inglês) para mais informações.

O DFP atua simplesmente como uma plataforma. A relação de publicidade é entre o desenvolvedor do aplicativo para dispositivos móveis e a rede de anúncios de terceiros e a AdMob. Assim, é responsabilidade do desenvolvedor garantir que as redes de anúncios de terceiros exibam anúncios que tratem o conteúdo do desenvolvedor como direcionado a crianças nos termos da COPPA.

Especifique parâmetros de solicitação adicionais (opcional)

Se você preferir, adicione informações de segmentação demográfica, como o sexo e a data de nascimento de um usuário, ao seu PublisherAdRequest. Esses tipos de informações podem ser usados pelas redes para exibir anúncios com uma segmentação mais precisa.

Fornecemos métodos para a definição do sexo e da data de nascimento. Essas informações serão passadas para todas as redes que as aceitarem. Veja um exemplo:

PublisherAdRequest adRequest = new PublisherAdRequest.Builder()
    .setGender(PublisherAdRequest.GENDER_FEMALE)
    .setBirthday(new GregorianCalendar(1985, 1, 1).getTime())  // January 1, 1985
    .build();

Algumas redes também suportam outros parâmetros de solicitação que são específicos delas. Consulte as instruções da "v1" ou "v2" abaixo para saber como fornecer esses parâmetros para as redes. Se você não tem certeza se o adaptador é v1 ou v2, faça um teste chamando addNetworkExtrasBundle com a classe do adaptador (conforme detalhado na seção v2 abaixo). Se o adaptador compilar, você saberá que ele é v2. Caso contrário, é um adaptador v1. É importante ressaltar que você pode usar adaptadores v1 e v2 no mesmo aplicativo.

v1

Para passar parâmetros extras para redes de mediação específicas, use o método addNetworkExtras() do PublisherAdRequest. O método addNetworkExtras() recebe uma instância de uma classe que implementa NetworkExtras.

Cada rede define suas próprias classes extras. A tabela a seguir mostra os nomes dessas classes em algumas redes.

Rede de anúncios Classe de parâmetros adicionais
Millennial Media com.google.ads.mediation.millennial.MillennialAdapterExtras
InMobi com.google.ads.mediation.inmobi.InMobiAdapterExtras

Por exemplo, a Millennial Media e a InMobi permitem especificar a renda do usuário para fornecer anúncios mais relevantes. Para fazer com que a estrutura de mediação passe uma renda durante a solicitação de um anúncio dessas redes, você pode usar este código:

import com.google.android.gms.ads.doubleclick.PublisherAdRequest;
import com.google.android.gms.ads.doubleclick.PublisherAdView;
import com.google.ads.mediation.inmobi.InMobiAdapterExtras;
import com.google.ads.mediation.millennial.MillennialAdapterExtras;

/* … */

    /* Set parameters common to all networks in ad request. */

    // Millennial Media extra parameters.
    MillennialAdapterExtras millennialExtras = new MillennialAdapterExtras();
    millennialExtras.setIncomeInUsDollars(65000);

    // InMobi extra parameters.
    InMobiAdapterExtras inMobiExtras = new InMobiAdapterExtras();
    inMobiExtras.setIncome(65000);

    // Create the ad request with these extra parameters.
    PublisherAdRequest adRequest = new PublisherAdRequest.Builder()
        .addNetworkExtras(millennialExtras)
        .addNetworkExtras(inMobiExtras)
        .build();

    // Finally, request the ad.
    adView.loadAd(adRequest);
v2

Para passar parâmetros extras para redes de mediação específicos, use o método addNetworkExtrasBundle() no PublisherAdRequest.Builder. Passe a classe do adaptador para o qual você deseja enviar parâmetros, além de um pacote de valores para o consumo do adaptador.

Na maioria dos casos, se um adaptador suportar parâmetros extras, ele terá as constantes necessárias para representar as chaves adequadas para o pacote ou algum método para ajudar a gerar um pacote válido e passá-lo para a rede.

Perguntas frequentes

Os listeners de anúncios continuam funcionando com a mediação?
Sim, eles funcionam com todas as redes de mediação.
Os adaptadores de mediação v1 funcionam com os serviços do Google Play?
Sim. O SDK dos anúncios para dispositivos móveis incluído nos serviços do Google Play foi criado para manter compatibilidade reversa com os nossos adaptadores de mediação v1.
Gostaria de adicionar uma nova rede à minha configuração de mediação para a próxima versão do meu aplicativo. Como isso afeta a atual versão do meu aplicativo, que não inclui essa rede?
O SDK detectará que não há um adaptador e gerará uma falha normal. A solicitação seguirá para a próxima rede na hierarquia de mediação.
O que a mensagem de erro "Não foi possível instanciar o adaptador da mediação: x.y.z.SomeAdapter" significa?
Provavelmente, seu projeto não tem a biblioteca de adaptadores que contém essa classe. Você precisa incluir adaptadores de rede e SDKs para todas as redes de anúncios que você está mediando.

Enviar comentários sobre…

SDK for DFP Users on Android
Precisa de ajuda? Acesse nossa página de suporte.