Mediação

Este guia mostra como integrar um adaptador de mediação à sua App Flutter.

Pré-requisitos

Antes de integrar a mediação a um formato de anúncio, você precisa integrar essa formato do anúncio no seu app:

Ainda não conhece a mediação? Lida Introdução à mediação.

Inicializar o SDK de anúncios para dispositivos móveis

O guia de início rápido mostra como inicializar os anúncios para dispositivos móveis SDK do Cloud. Durante essa chamada de inicialização, os adaptadores de mediação também é inicializado. É importante aguardar a conclusão da inicialização antes você carrega anúncios para garantir a participação plena de todas as redes de anúncios no a primeira solicitação de anúncio.

O exemplo de código a seguir mostra como verificar a inicialização de cada adaptador antes de fazer uma solicitação de anúncio.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  
  MobileAds.instance.initialize()
    .then((initializationStatus) {
      initializationStatus.adapterStatuses.forEach((key, value) {
        debugPrint('Adapter status for $key: ${value.description}');
      });
  });
  
  runApp(MyApp());
}

Atualizar as configurações do Gradle (somente Android)

Adicione as seguintes linhas ao arquivo settings.gradle para usar o APIs do Android do plug-in:

def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withInputStream { stream -> plugins.load(stream) }
}

plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

Adicionar dependências para redes de parceiros

Os adaptadores de mediação e as dependências deles precisam ser adicionados ao seu e iOS. Para adicioná-las, atualize o build.gradle no nível do app no Android e Podfile no iOS. O Google tem adaptadores de código aberto no GitHub para ambos Android (em inglês) e No iOS.

Consulte a Android e iOS documentação de cada rede de parceiros para orientações detalhadas sobre como adicionar as adaptador em seu app.

Verifique qual classe de adaptador da rede de publicidade carregou o anúncio

O exemplo de código a seguir demonstra como registrar o nome de classe da rede de publicidade para um anúncio de banner:

final bannerAd = AdManagerBannerAd(
      size: [AdSize.banner],
      adUnitId: '<your-ad-unit>',
      listener: AdManagerBannerAdListener(
        onAdLoaded: (ad) {
          debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
        },
      ),
      request: AdManagerAdRequest(),
    );

Usar anúncios de banner com mediação

Desative a atualização em todas as interfaces de origem de anúncios terceirizadas para anúncios de banner usadas na mediação. Isso evita que uma uma atualização dupla, já que o Ad Manager também aciona uma atualização com base na taxa de atualização do seu bloco de anúncios de banner.

Usar anúncios nativos com mediação

Confira a seguir algumas práticas recomendadas para considerar ao implementar anúncios nativos mediação.

Política de apresentação de anúncios nativos
Cada rede de publicidade tem as próprias políticas. Ao usar a mediação, é importante mas lembre-se de que seu app ainda precisa obedecer às políticas de rede que forneceu o anúncio.

Leis Estaduais de Privacidade dos EUA e GDPR

Se você precisar estar em conformidade com a Política de define a privacidade leis ou de Proteção geral de dados (GDPR), siga a etapas nas regulamentações estaduais dos EUA configurações ou GDPR configurações para adicionar suas de parceiros de mediação na seção "Privacidade e de mensagens estados dos EUA ou lista de parceiros de publicidade do GDPR. Não fazer isso pode levar os parceiros não veicular anúncios no seu app.

Saiba como ativar o processamento de dados restrito (RDP) e acesso ao GDPR consentimento com a plataforma de mensagens de usuários (UMP, na sigla em inglês) do Google do SDK.