Integrar a DT Exchange à Mediação da AdMob

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

Integrações e formatos de anúncio aceitos

O adaptador de mediação do React Native para a DT Exchange tem os seguintes recursos:

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 DT Exchange

Adicionar um novo app e posição do anúncio

Inscreva-se ou faça login no console da DT Exchange.

Clique em Adicionar app.

Gerenciar apps

Escolha a plataforma e as posições, preencha o restante do formulário e clique em Create App.

Android

iOS

Insira os nomes e selecione os tipos de canais. Em seguida, clique em Salvar posição.

Configuração

ID do app e ID da posição

Passe o cursor sobre a barra de navegação à esquerda para abri-la e clique em Gerenciamento de apps.

Na página Gerenciamento de apps, anote o ID do app ao lado do seu app.

Selecione seu app e acesse a guia Posições. Anote o ID de lugar.

ID da posição

ID do publisher, token do cliente e segredo do consumidor

Clique no seu nome de usuário no menu à esquerda e selecione Perfil de usuário.

Anote o ID do publisher, o token do cliente e o secret do cliente, porque eles serão necessários na próxima etapa.

Perfil do usuário

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 DT Exchange, adicione a DT ao seu arquivo app-ads.txt.

Etapa 2: configurar a demanda da DT Exchange 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 a DT Exchange à 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 a DT Exchange (Fyber Monetization) à 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 DT Exchange

No diretório raiz do projeto, instale o adaptador de mediação do Google Mobile Ads SDK for React Native para a DT Exchange. 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/dt-exchange/ 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/dt-exchange/gma-mediation-dtexchange-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-dtexchange-0.1.0.tgz

    novelo

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

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

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 0.1.0 e mais recentes do adaptador do DT Exchange para React Native aceitam a transmissão de indicadores de consentimento do GDPR de plataformas de gestão de consentimento que se integram à Estrutura de Transparência e Consentimento (TCF) do IAB para o SDK do DT Exchange. Para mais informações, consulte a documentação do GDPR para Android e iOS.

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.

O exemplo de código a seguir demonstra como transmitir informações de consentimento para o adaptador da DT Exchange manualmente:

import { DTExchangeMediation } from '@google/gma-mediation-dtexchange';
// ...

DTExchangeMediation.setUSPrivacyString('myUSPrivacyString');

// You can also clear CCPA consent information using the following method:
DTExchangeMediation.clearUSPrivacyString();

Consulte o artigo da DT Exchange sobre o código aberto da CCPA para mais informações e os valores que podem ser fornecidos no método.

Etapa 5: adicionar o código necessário

Android

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

iOS

Integração da SKAdNetwork

Siga a documentação da DT Exchange (em inglês) para adicionar os identificadores da SKAdNetwork ao arquivo Info.plist do seu projeto.

Etapa 6: testar a implementação

Ativar anúncios de teste

Registre seu dispositivo de teste na AdMob.

Verificar anúncios de teste

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

Códigos de erro

Se o adaptador não receber um anúncio da DT Exchange, os publishers poderão verificar o erro subjacente na resposta do anúncio usando ResponseInfo na seguinte classe:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

Código do erro Motivo
101 Os parâmetros do servidor da DT Exchange configurados na interface da AdMob estão ausentes ou são inválidos.
103 O tamanho de anúncio solicitado não corresponde a um tamanho de banner aceito pela DT Exchange.
105 O SDK da DT carregou um anúncio, mas retornou um controlador inesperado.
106 O anúncio não está pronto para ser veiculado.
107 O contexto não é uma instância de atividade.
108 Falha ao exibir o anúncio.
200-399 O SDK da DT retornou um erro. Consulte o código para mais detalhes.

iOS

Código do erro Motivo
0-10 O SDK da DT retornou um erro. Acesse a documentação para mais detalhes.
101 Os parâmetros do servidor da DT Exchange 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 DT Exchange.
103 Falha ao mostrar o anúncio porque o objeto de anúncio já foi usado.
104 Falha ao mostrar anúncios da DT Exchange porque o anúncio não está pronto.
105 O SDK da DT retornou um erro de inicialização.

Versão 0.1.0

  • Versão inicial.