Integrar myTarget com mediação

Este guia mostra como usar o SDK dos anúncios para dispositivos móveis do Google para carregar e exibir anúncios do myTarget usando a mediação, incluindo integrações em cascata. Ele aborda como adicionar o myTarget à configuração de mediação de um bloco de anúncios e como integrar o SDK e o adaptador do myTarget a um app Unity.

Integrações e formatos de anúncio aceitos

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado
Intersticial premiado

Requisitos

  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • Unity 2019.4 ou mais recente
  • Para fazer a implantação no Android,
    • API do Android de nível 23 ou mais recente
  • Para fazer a implantação no iOS:
    • Destino de implantação do iOS 12.0 ou mais recente
  • Um projeto do Unity em funcionamento configurado com o SDK dos anúncios para dispositivos móveis do Google. Consulte Começar para mais detalhes.
  • Conclua o Guia de primeiros passos da mediação.

Etapa 1: definir configurações na interface do myTarget

Faça login na sua conta do myTarget. Clique em APPS no cabeçalho para acessar a página "Apps". Clique em ADICIONAR APP para adicionar seu app.

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

Android

Em seguida, forneça o URL do Google Play do seu app.

iOS

Em seguida, forneça 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 slot, que pode ser encontrado nas configurações do bloco como slot_id. Esse ID de slot 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 do myTarget para configurar o ID do bloco de anúncios da AdMob. Navegue até a guia Perfil e selecione Tokens de acesso. Clique em Criar token ou Mostrar token para ver seu token de acesso permanente do myTarget.

Atualizar o app-ads.txt

O app-ads.txt de vendedores autorizados para apps é 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 app-ads.txt para myTarget, consulte Como criar e publicar um arquivo.

Ativar o modo de teste

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

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

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

Android

Para 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 do myTarget

OpenUPM-CLI

Se você tiver o OpenUPM-CLI instalado, execute o seguinte comando no diretório raiz do projeto para instalar o plug-in de mediação myTarget dos anúncios para dispositivos móveis do Google para Unity:

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

No editor do projeto do Unity, selecione Edit > Project Settings > Package Manager para abrir as Configurações do Unity Package Manager.

Na guia Registros com escopo, adicione o OpenUPM como um registro com escopo com os seguintes detalhes:

  • Nome: OpenUPM
  • URL: https://package.openupm.com
  • Escopos: com.google

Detalhes do OpenUPM

Em seguida, acesse Window > Package Manager para abrir o Unity Package Manager e selecione My Registries no menu suspenso.

Registros do Unity

Selecione o pacote Mediação do Google Mobile Ads MyTarget e clique em Instalar.

Instalar pelo OpenUPM

Pacote do Unity

Faça o download da versão mais recente do plugin de mediação dos anúncios para dispositivos móveis do Google para myTarget usando o link de download no Registro de alterações e extraia o GoogleMobileAdsMyTargetMediation.unitypackage do arquivo ZIP.

No editor do projeto do Unity, selecione Assets > Import Package > Custom Package e encontre o arquivo GoogleMobileAdsMyTargetMediation.unitypackage que você baixou. Verifique se todos os arquivos estão selecionados e clique em Importar.

Importar do Unity

Em seguida, selecione Recursos > Gerenciador de dependências externas > Resolvedor do Android > Resolução forçada. A biblioteca do External Dependency Manager vai realizar a resolução de dependências do zero e copiar as dependências declaradas no diretório Assets/Plugins/Android do seu app Unity.

Forçar resolução

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

De acordo com a Política de consentimento de usuários da União Europeia do Google, você precisa garantir que determinadas divulgações sejam feitas e que os consentimentos sejam obtidos dos usuários no Espaço Econômico Europeu (EEE) em relação ao uso de identificadores de dispositivo e dados pessoais. Essa política reflete os requisitos da Diretiva de privacidade eletrônica da UE e do Regulamento geral de proteção de dados (GDPR). Ao buscar consentimento, você precisa identificar cada rede de publicidade na sua cadeia de mediação que possa coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada rede. No momento, o Google não consegue transmitir automaticamente a opção de consentimento do usuário para essas redes.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para myTarget versão 2.1.0 inclui os métodos SetUserConsent() e SetUserAgeRestricted(). O exemplo de código a seguir mostra como transmitir informações de consentimento do usuário para o SDK do myTarget. Se você optar por chamar esse método, recomendamos que faça isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

Se você souber que o usuário está em uma categoria com restrição de idade, também poderá chamar o método SetUserAgeRestricted().

MyTarget.SetUserAgeRestricted(true);

Consulte o guia de Privacidade e GDPR do myTarget para mais informações.

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 legal desses termos). Essa opção é disponibilizada por um link em destaque com a mensagem "Não vender minhas informações pessoais" na página inicial do terceiro. O guia de compliance com as leis de privacidade dos estados 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 anúncios na sua cadeia de mediação. Portanto, identifique cada rede de publicidade na sua cadeia de mediação que possa participar da venda de informações pessoais e siga as orientações de cada uma delas para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para myTarget versão 3.13.3 inclui o método SetCCPAUserConsent(bool). O exemplo de código a seguir mostra como transmitir informações de consentimento do usuário para o SDK myTarget. Se você optar por chamar esse método, faça isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

Entre em contato com o suporte do myTarget para mais informações.

Etapa 5: adicionar o código necessário

Android

Nenhum código adicional é necessário para a integração do myTarget.

iOS

Integração da SKAdNetwork

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

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob e ative o modo de teste na interface da myTarget.

Verificar anúncios de teste

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

Códigos de erro

Se o adaptador não receber um anúncio do myTarget, os editores 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 do myTarget quando um anúncio não é carregado:

Android

Código do erro Motivo
100 O SDK do myTarget retornou um erro.
101 Os parâmetros do servidor myTarget configurados na interface da AdMob estão ausentes/inválidos.
102 O tamanho de anúncio solicitado não corresponde a um tamanho de banner compatível com o 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).

iOS

Código do erro Motivo
100 O SDK myTarget ainda não tem um anúncio disponível.
101 Os parâmetros do servidor myTarget configurados na interface da AdMob estão ausentes/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 compatível com o myTarget.
105 Faltam recursos obrigatórios de anúncios nativos.

Registro de alterações do plug-in de mediação do Unity myTarget

Versão 3.28.0

Versão 3.27.1

Versão 3.27.0

Versão 3.26.0

Versão 3.25.0

Versão 3.24.0

Versão 3.23.0

Versão 3.22.0

Versão 3.21.1

Versão 3.21.0

Versão 3.20.0

Versão 3.19.0

Versão 3.18.2

Versão 3.18.1

Versão 3.18.0

Versão 3.17.1

Versão 3.17.0

Versão 3.16.2

Versão 3.16.1

Versão 3.16.0

Versão 3.15.0

Versão 3.14.0

Versão 3.13.2

Versão 3.13.1

Versão 3.13.0

Versão 3.12.0

Versão 3.11.4

Versão 3.11.3

Versão 3.11.2

Versão 3.11.1

Versão 3.11.0

Versão 3.10.2

Versão 3.10.1

Versão 3.10.0

Versão 3.9.0

Versão 3.8.2

Versão 3.8.1

Versão 3.8.0

Versão 3.7.0

Versão 3.6.1

Versão 3.6.0

Versão 3.5.2

Versão 3.5.1

Versão 3.5.0

Versão 3.4.0

Versão 3.3.0

Versão 3.2.0

Versão 3.1.0

Versão 3.0.0

  • Atualizamos o plug-in para oferecer suporte à nova API Rewarded Beta aberta.
  • Compatível com a versão 5.3.9.0 do adaptador Android myTarget.
  • Compatível com a versão 5.0.4.0 do adaptador myTarget para iOS.

Versão 2.3.2

  • Compatível com a versão 5.2.5.0 do adaptador myTarget para Android.
  • Compatível com a versão 4.8.9.0 do adaptador iOS do myTarget.

Versão 2.3.1

  • Compatível com a versão 5.2.5.0 do adaptador myTarget para Android.
  • Compatível com a versão 4.8.5.0 do adaptador iOS do myTarget.

Versão 2.3.0

  • Compatível com a versão 5.2.2.0 do adaptador myTarget para Android.
  • Compatível com a versão 4.8.0.0 do adaptador iOS do myTarget.

Versão 2.2.0

  • Compatível com a versão 5.1.4.0 do adaptador Android myTarget.
  • Compatível com a versão 4.8.0.0 do adaptador iOS do myTarget.

Versão 2.1.2

  • Compatível com a versão 5.1.3.0 do adaptador Android myTarget.
  • Compatível com a versão 4.7.11.0 do adaptador iOS do myTarget.

Versão 2.1.1

  • Compatível com a versão 5.1.1.0 do adaptador Android myTarget.
  • Compatível com a versão 4.7.10.0 do adaptador iOS do myTarget.

Versão 2.1.0

  • Compatível com a versão 5.1.0 do SDK do Android myTarget.
  • Compatível com a versão 4.7.9 do SDK do myTarget para iOS.
  • Os seguintes métodos foram adicionados:
    • MyTarget.SetUserConsent() para encaminhar o status de consentimento do usuário ao SDK do MyTarget.
    • Método MyTarget.SetUserAgeRestricted que define uma flag para indicar se o usuário está em uma categoria com restrição de idade (ou seja, menor de 16 anos).
    • Método MyTarget.IsUserConsent() para receber o status de consentimento atual do usuário.
    • Método MyTarget.IsUserAgeRestricted() para receber a flag que indica que o usuário está em uma categoria com restrição de idade (ou seja, com menos de 16 anos).

Versão 2.0.1

  • Suporta a versão 5.0.2 do SDK do Android myTarget.
  • Compatível com a versão 4.7.8 do SDK do myTarget para iOS.

Versão 2.0.0

  • Compatível com a versão 5.0.0 do SDK do Android myTarget.
  • Compatível com a versão 4.7.7 do SDK do myTarget para iOS.

Versão 1.1.0

  • Compatível com a versão 4.7.2 do SDK do Android myTarget.
  • Compatibilidade com a versão 4.7.6 do SDK do iOS myTarget.

Versão 1.0.0

  • Primeira versão!
  • Compatível com a versão 4.6.27 do SDK do Android myTarget.
  • Compatível com a versão 4.6.24 do SDK do myTarget para iOS.