Integrar o myTarget com a Mediação da AdMob

Este guia mostra como usar o Google Mobile Ads SDK for React Native para carregar e exibir anúncios da myTarget usando a mediação, incluindo integrações em hierarquia. Ele explica como adicionar a myTarget à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador da myTarget a um app React Native.

Integrações e formatos de anúncio aceitos

Integração
Lances
Cascata
Formatos
Abertura do aplicativo
Banner
Intersticial
Premiado
Intersticial premiado
Nativo

Pré-requisitos

Antes de continuar, verifique o seguinte:

Etapa 1: definir as configurações na interface da myTarget

Faça login na sua conta do myTarget. Acesse a página "Apps" clicando em APPS no cabeçalho. Clique em ADICIONAR APP.

Se o app for compatível com as plataformas Android e iOS, configure cada uma delas separadamente.

Android

Em seguida, informe o URL do Google Play do seu app.

iOS

Em seguida, informe o URL do iTunes** do seu app.

Ao adicionar um app, o myTarget exige que você crie um bloco de anúncios antes de concluir o processo.

Selecione BANNER entre os formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Intersticial

Selecione INTERSTICIAL entre os formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Premiado

Selecione VÍDEO PREMIADO entre os formatos de anúncio disponíveis e clique no botão ADICIONAR BLOCO DE ANÚNCIOS.

Nativo

Selecione NATIVO entre os formatos de anúncio disponíveis e clique em ADICIONAR BLOCO DE ANÚNCIOS.

Na página de detalhes do bloco de anúncios, anote o ID do espaço, que pode ser encontrado nas configurações do bloco como slot_id. Esse ID será usado para configurar seu bloco de anúncios da AdMob na próxima seção.

Além do slot_id, você também vai precisar do token de acesso permanente da myTarget para configurar o ID do bloco de anúncios da AdMob. Acesse a guia Perfil e selecione Tokens de acesso. Clique em Create Token ou Show Token para ver seu token de acesso permanente do myTarget.

Atualizar o app-ads.txt

Vendedores autorizados do inventário de anúncios de apps (app-ads.txt) é uma iniciativa do IAB Tech Lab que ajuda a garantir que o inventário de anúncios do seu aplicativo seja vendido apenas por canais autorizados. Para evitar uma perda significativa na receita de publicidade, implemente um arquivo app-ads.txt. Se ainda não fez isso, configure um arquivo app-ads.txt para seu app.

Para implementar o app-ads.txt para a myTarget, consulte Como criar e publicar um arquivo.

Ativar o modo de teste

Siga as instruções na documentação da myTarget para adicionar e configurar um dispositivo de teste na interface da myTarget.

Etapa 2: configurar a demanda da myTarget na interface da AdMob

Definir as configurações de mediação do bloco de anúncios

Android

Para ver as instruções, consulte a etapa 2 no guia para Android.

iOS

Para instruções, consulte a etapa 2 no guia para iOS.

Adicionar o Mail.ru à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações das regulamentações europeias e Configurações das regulamentações estaduais dos EUA para adicionar o Mail.ru à lista de parceiros de publicidade das regulamentações europeias e estaduais dos EUA na interface da AdMob.

Etapa 3: importar o SDK e o adaptador da myTarget

No diretório raiz do projeto, instale o adaptador de mediação Google Mobile Ads SDK for React Native para o myTarget. Preencha os campos:

  1. Copie o arquivo tar do adaptador Google Mobile Ads SDK for React Native do diretório gma-sdk-react-native/adapters/mytarget/ para o diretório local_packages/ do projeto. Se você não tiver a pasta adapters, consulte Pré-requisitos.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/mytarget/gma-mediation-mytarget-0.1.0.tgz local_packages/

    Substitua EXTRACT_DIR pelo caminho para o diretório em que você extraiu o arquivo.

  2. Instale o pacote do adaptador usando o gerenciador de pacotes de sua preferência:

    npm

    npm install ./local_packages/gma-mediation-mytarget-0.1.0.tgz

    novelo

    yarn add ./local_packages/gma-mediation-mytarget-0.1.0.tgz

Etapa 4: implementar configurações de privacidade no SDK da myTarget

Para cumprir a Política de consentimento de usuários da União Europeia do Google, você precisa fazer certas divulgações aos seus usuários no Espaço Econômico Europeu (EEE), no Reino Unido e na Suíça e obter o consentimento deles para usar cookies ou outra forma de armazenamento local, quando exigido por lei, e para coletar, compartilhar e usar dados pessoais para personalização de anúncios. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Você é responsável por verificar se o consentimento é propagado para cada origem de anúncios na sua cadeia de mediação.

A versão N/A e mais recentes do adaptador do React Native da myTarget aceitam a transmissão de indicadores de consentimento do GDPR do SDK da UMP e de plataformas de gestão de consentimento que se integram à especificação de consentimento adicional do Google para o SDK da myTarget.

Leis Estaduais de Privacidade dos EUA

As leis de privacidade dos estados dos EUA exigem que os usuários tenham o direito de recusar a "venda" das próprias "informações pessoais" (conforme a definição desses termos na lei). Essa opção é disponibilizada por um link com a mensagem "Não vender minhas informações pessoais" em destaque na página inicial do terceiro. O guia de conformidade com as leis estaduais de privacidade dos EUA oferece a opção de ativar o tratamento de dados restrito para a veiculação de anúncios do Google, mas não é possível aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, identifique cada rede de publicidade que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

Consulte a seção sobre as leis estaduais de privacidade dos EUA nos guias para desenvolvedores do Android e do iOS.

Etapa 5: adicionar o código necessário

Android

Não é necessário nenhum código adicional para a integração com a myTarget.

iOS

Integração da SKAdNetwork

Siga a documentação da myTarget para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Não se esqueça de registrar seu dispositivo de teste na AdMob e ativar o modo de teste na interface da myTarget.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste da myTarget, ative o teste de uma única origem de anúncios no Ad Inspector usando as origens de anúncios myTarget (hierarquia).

Etapas opcionais

Parâmetros específicos da rede

O adaptador da myTarget permite transmitir um objeto MyTargetMediationExtras à solicitação de anúncio para definir parâmetros específicos da rede.

Use o parâmetro isIosDebugMode para ativar ou desativar o registro de depuração do adaptador do iOS do myTarget. O adaptador do iOS ativa a geração de registros por padrão. Para mais informações, consulte o guia de parâmetros específicos de rede do iOS.

O exemplo de código a seguir mostra como definir isIosDebugMode:

import { MyTargetMediationExtras } from '@google/gma-mediation-mytarget';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new MyTargetMediationExtras({
      isIosDebugMode: true, // Enable debug logging on iOS
    }),
  ],
};

Códigos de erro

Se o adaptador não receber um anúncio da myTarget, os publishers poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

Confira os códigos e as mensagens correspondentes gerados pelo adaptador da myTarget quando um anúncio não é carregado:

Android

Código do erro Motivo
100 O SDK da myTarget retornou um erro.
101 Os parâmetros do servidor da myTarget configurados na interface da AdMob estão ausentes ou são inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela myTarget.
103 A solicitação de anúncio não é uma solicitação de anúncio nativo unificado.
104 O anúncio nativo carregado do myTarget é diferente do solicitado.
105 O anúncio nativo carregado do myTarget não tem alguns recursos obrigatórios (por exemplo, imagem ou ícone).
106 O SDK da myTarget não conseguiu mostrar o anúncio.

iOS

Código do erro Motivo
100 O SDK da myTarget ainda não tem um anúncio disponível.
101 Os parâmetros do servidor da myTarget configurados na interface da AdMob estão ausentes ou são inválidos.
102 O adaptador do myTarget não é compatível com o formato de anúncio solicitado.
103 Tentativa de mostrar um anúncio do myTarget que não foi carregado.
104 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela myTarget.
105 Recursos de anúncios nativos obrigatórios ausentes.

Versão 0.1.1 (em andamento)

Versão 0.1.0

  • Versão inicial.