Integrar a Tapjoy com a mediação

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

Integrações e formatos de anúncio compatíveis

O AdMob adaptador de mediação para Tapjoy tem os seguintes recursos:

Integração
Lances
Cascata
Formatos
Banner
Intersticial
Premiado

Requisitos

  • Unity 4 ou mais recente
  • SDK dos anúncios para dispositivos móveis do Google mais recente
  • [Para lances]: plug-in de mediação de anúncios para dispositivos móveis do Google para a Tapjoy 2.3.0 ou mais recente (versão mais recente recomendada)
  • Para implantar no Android
    • Android API de nível 19 ou mais recente
  • Para implantar no iOS:
    • Meta 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.
  • Concluir o Guia explicativo de mediação

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

Inscreva-se ou faça login no painel da Tapjoy.

Adicionar app

Para adicionar seu app ao painel do Tapjoy, acesse a lista de apps no canto superior direito e clique no botão Adicionar app. Em seguida, você vai precisar inserir detalhes sobre o app.

Preencha o formulário e clique no botão Create Now para adicionar seu app ao painel do Tapjoy.

É possível pular as etapas de integração apresentadas pela Tapjoy e passar para a criação de posições a serem usadas com a AdMob mediação.

Se o app for compatível com as duas plataformas, escolha Ambas como a plataforma.

Android

iOS

Canal, moeda virtual e conteúdo

Canal

Acesse Monetização > Canais e clique no botão Criar posição no canto superior direito. Mesmo que você já tenha uma posição, é melhor criar uma nova para AdMob . Assim, ela pode ser rastreada e informada separadamente.

Insira um Nome para sua posição, marque a caixa de seleção Mediação e selecione AdMob na lista suspensa. Clique em Criar quando terminar.

O nome da posição inserido aqui é usado para configurar seu AdMob bloco de anúncios para mediação na próxima seção. A "AdMob Mediação" foi usada neste exemplo, mas você pode chamar a posição como quiser.

Moeda virtual

Navegue até Monetização > Moeda virtual e clique no botão Criar moeda virtual no canto superior direito.

Preencha o formulário e clique em Criar agora. Use NO_CALLBACK como o URL de callback. Isso garante que o SDK do Tapjoy evite uma chamada desnecessária para o servidor.

O valor e o nome da moeda não são encaminhados pelo adaptador da Tapjoy. Portanto, qualquer valor genérico pode ser escolhido para o nome e o valor da moeda.

Android

iOS

Conteúdo

Acesse Monetização > Criar conteúdo para criar o conteúdo que será exibido com as posições.

Para mais instruções sobre como criar conteúdo, selecione a guia correspondente ao formato de anúncio de sua preferência:

Lances

Intersticial

Clique no botão Criar para o conteúdo de Vídeo intersticial programático. Dê um Nome para o conteúdo e escolha sua Plataforma. * {Android} * {iOS} Selecione a moeda virtual criada anteriormente como Moeda virtual. Selecione a posição intersticial criada anteriormente. Clique no botão Salvar na parte de baixo quando terminar para criar seu conteúdo.

Premiado

Clique no botão Criar para o conteúdo de vídeo programático premiado. * {Android} * {iOS} Selecione a moeda virtual criada anteriormente como a Moeda virtual. Selecione a posição premiada criada anteriormente. Clique no botão Salvar na parte de baixo quando terminar para criar seu conteúdo.

Cascata

Intersticial

Clique no botão Criar para o conteúdo de vídeo intersticial. Dê um Nome para o conteúdo e escolha sua Plataforma. * {Android} * {iOS} Selecione a moeda virtual criada anteriormente como Moeda virtual. Selecione a posição intersticial criada anteriormente. Clique no botão Salvar na parte de baixo quando terminar para criar seu conteúdo.

Premiado

Clique no botão Criar para o conteúdo de vídeo premiado. Dê um Nome para o conteúdo e escolha sua Plataforma. * {Android} * {iOS} Selecione a moeda virtual criada anteriormente como Moeda virtual. Selecione a posição premiada criada anteriormente. Clique no botão Salvar na parte de baixo quando terminar para criar seu conteúdo.

Localizar chave do SDK

Além do nome da posição, você também precisa da chave do SDK para configurar seu AdMob bloco de anúncios.

Acesse Settings > App Settings. Sua chave do SDK está disponível nas Informações do app, na guia Plataformas de aplicativos.

Android

iOS

Localizar chaves de relatórios

Lances

Esta etapa não é necessária para integrações de lances.

Cascata

Você precisa da sua chave OAuth do editor e da sua chave de mediação para continuar. Sua chave OAuth do editor pode ser encontrada na mesma página, na guia Chaves de API.

Encontre sua chave de mediação na mesma página, na guia Chaves de mediação da coluna Chave de API de relatórios. A chave é identificada como "AdMob".

Ativar modo de teste

Os anúncios de teste podem ser ativados no painel da Tapjoy em Settings > App Settings > Test Devices. Crie um novo dispositivo de teste usando o ID de publicidade dele:

Android

Para localizar o ID de publicidade do dispositivo, acesse Google > Anúncios nas Configurações do dispositivo.

iOS

Para conseguir o ID de publicidade do seu dispositivo, adicione o seguinte código no seu app. Importe o framework AdSupport para seu app antes de usar o código abaixo.

Swift

let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")

Objective-C

NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);

Em seguida, modifique o conteúdo criado anteriormente.

Para modificar seu conteúdo, primeiro navegue até Monetização > Posições e clique na guia Iniciado pelo usuário. Em seguida, selecione o menu suspenso do conteúdo que você quer editar e escolha Editar.

Na seção Basic do conteúdo, marque a caixa de seleção Only for Test Devices. Clique em Salvar na parte inferior da página. Pronto! Agora você tem uma integração de mediação funcionando com a Tapjoy.

Android

iOS

Etapa 2: configurar a demanda da Tapjoy na AdMob interface

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

Android

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

iOS

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

Adicionar Tapjoy à lista de parceiros de publicidade do GDPR e das regulamentações estaduais dos EUA

Siga as etapas em Configurações do GDPR e Configurações das regulamentações estaduais dos EUA para adicionar Tapjoy à lista de parceiros de anúncios do GDPR e das regulamentações estaduais dos EUA na AdMob IU.

Etapa 3: importar o SDK e o adaptador da Tapjoy

Faça o download da versão mais recente do plug-in de mediação dos anúncios para dispositivos móveis do Google para a Tapjoy pelo link de download no Registro de mudanças e extraia GoogleMobileAdsTapjoyMediation.unitypackage do arquivo ZIP.

No editor de projetos do Unity, selecione Assets > Import Package > Custom Package e selecione o arquivo GoogleMobileAdsTapjoyMediation.unitypackage que você fez o download. Verifique se todos os arquivos estão selecionados e clique em Import.

Em seguida, selecione Assets > Play Services Resolver > Android Resolver > Force Resolve. A biblioteca do resolvedor do Play Services do Unity executará a resolução de dependências do zero e copiará as dependências declaradas para o diretório Assets/Plugins/Android do seu app Unity.

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

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 fornecidas aos usuários no Espaço Econômico Europeu (EEE) e recebam os consentimentos deles em relação ao uso de identificadores de dispositivos 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 solicitar consentimento, você precisa identificar cada rede de publicidade na cadeia de mediação que pode coletar, receber ou usar dados pessoais e fornecer informações sobre o uso de cada uma delas. No momento, o Google não pode transmitir automaticamente a escolha de consentimento do usuário a essas redes.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para a Tapjoy versão 1.1.1 inclui os métodos SetUserConsent() e SubjectToGDPR(). O exemplo de código abaixo mostra como transmitir informações de consentimento para o SDK da Tapjoy. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUserConsent("myUserConsent");

Além disso, há uma sinalização opcional que pode ser definida para indicar se o usuário está sujeito ao GDPR.

Tapjoy.SubjectToGDPR(true);

Consulte o guia Privacidade do usuário (em inglês) da Tapjoy para mais detalhes e os valores que podem ser fornecidos no método.

Leis Estaduais de Privacidade dos EUA

Leis Estaduais de Privacidade 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) com um link "Não vender minhas informações pessoais" destacado na página inicial do vendedor. O guia de conformidade com as leis de privacidade dos EUA oferece a capacidade de ativar o processamento de dados restrito para a veiculação de anúncios do Google, mas o Google não pode aplicar essa configuração a cada rede de publicidade na sua cadeia de mediação. Portanto, você precisa identificar cada rede de publicidade na sua cadeia de mediação que pode participar da venda de informações pessoais e seguir as orientações de cada uma dessas redes para garantir a conformidade.

O plug-in de mediação dos anúncios para dispositivos móveis do Google para a Tapjoy versão 2.9.1 inclui o método SetUSPrivacy(). O exemplo de código a seguir mostra como transmitir informações de consentimento para o SDK da Tapjoy. Se você optar por chamar esse método, é recomendável fazer isso antes de solicitar anúncios pelo SDK dos anúncios para dispositivos móveis do Google.

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUSPrivacy("myUSPrivacyString");

Consulte o guia Privacidade do usuário (em inglês) da Tapjoy para mais detalhes e os valores que podem ser fornecidos no método.

Etapa 5: adicione o código necessário:

Android

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

iOS

Integração da SKAdNetwork

Consulte a documentação da Tapjoy (link em inglês) 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 em AdMob e ative o modo de teste na Tapjoy interface.

Verificar anúncios de teste

Para verificar se você está recebendo anúncios de teste do Tapjoy, ative os testes de uma única origem no Ad Inspector usando as Tapjoy (Bidding) and Tapjoy (Waterfall) origens de anúncios.

Etapas opcionais

Android

Permissões

Para um desempenho ideal, a Tapjoy recomenda adicionar as permissões opcionais abaixo ao arquivo AndroidManifest.xml do app. Modifique o arquivo AndroidManifest.xml, localizado na pasta Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation, e inclua estas permissões opcionais:

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

iOS

Não há etapas adicionais para a integração com o iOS.

Códigos de erro

Se o adaptador não receber um anúncio da Tapjoy, os editores podem verificar o erro subjacente da resposta do anúncio usando ResponseInfo nas seguintes classes:

Android

Formato Nome da classe
Intersticial TapjoyAdapter
Premiado TapjoyMediationAdapter

iOS

Formato Nome da classe
Intersticial GADMAdapterTapjoy
Premiado GADMAdapterTapjoy

Estes são os códigos e as mensagens associadas geradas pelo adaptador da Tapjoy quando um anúncio não é carregado:

Android

Código do erro Motivo
101 Os parâmetros do servidor Tapjoy configurados na interface AdMob estão ausentes/inválidos.
103 O editor precisa solicitar anúncios com um contexto Activity.
104 Falha ao inicializar o SDK do Tapjoy.
105 Ocorreu um erro de apresentação do Tapjoy durante a reprodução do vídeo.
106 O SDK do Tapjoy não consegue carregar dois anúncios para o mesmo ID de posição ao mesmo tempo.
107 O app não solicitou anúncios nativos.
108 O SDK da Tapjoy não tem conteúdo de anúncio disponível.

iOS

Código do erro Motivo
101 Os parâmetros do servidor Tapjoy configurados na interface AdMob estão ausentes/inválidos.
102 Falha ao inicializar o SDK do Tapjoy.
103 O adaptador Tapjoy não é compatível com o formato de anúncio solicitado.
104 A Tapjoy enviou um callback de carregamento bem-sucedido, mas nenhum conteúdo estava disponível.
105 Um anúncio já foi carregado para esta configuração de rede.
106 O SDK do Tapjoy retornou um callback de erro de falha de vídeo.

Registro de alterações do plug-in de mediação para Unity da Tapjoy

Versão 3.2.0

Versão 3.1.1

Versão 3.1.0

Versão 3.0.0

Versão 2.10.1

Versão 2.10.0

Versão 2.9.1

Versão 2.9.0

Versão 2.8.2

Versão 2.8.1

Versão 2.8.0

Versão 2.7.1

Versão 2.7.0

Versão 2.6.1

Versão 2.6.0

Versão 2.5.1

Versão 2.5.0

Versão 2.4.2

Versão 2.4.1

Versão 2.4.0

Versão 2.3.1

Versão 2.3.0

  • Oferece suporte ao adaptador Tapjoy para Android versão 12.3.1.0.
  • Oferece suporte ao adaptador Tapjoy para iOS versão 12.3.1.0.

Versão 2.2.0

  • Atualização do plug-in para oferecer suporte à nova API Premiada.
  • Oferece suporte ao adaptador Tapjoy para Android versão 12.2.1.0.
  • Oferece suporte ao adaptador Tapjoy para iOS versão 12.2.1.0.

Versão 2.1.0

  • Oferece suporte ao adaptador Tapjoy para Android versão 12.2.0.0.
  • Compatível com o adaptador para iOS da versão 12.1.0.0 do Tapjoy.

Versão 2.0.1

  • Oferece suporte ao adaptador Tapjoy para Android versão 12.0.0.1.
  • Compatível com o adaptador para iOS da versão 12.0.0.0 do Tapjoy.

Versão 2.0.0

  • Oferece suporte ao adaptador Tapjoy para Android versão 12.0.0.0.
  • Compatível com o adaptador para iOS da versão 12.0.0.0 do Tapjoy.

Versão 1.1.1

  • Oferece suporte ao SDK do Tapjoy para Android versão 11.12.2.
  • Compatível com a versão 11.12.2 do SDK do Tapjoy para iOS.
  • O método Tapjoy.SetUserConsent() foi adicionado para encaminhar o status de consentimento do usuário ao SDK da Tapjoy na forma de uma string de consentimento.
  • Adição do método Tapjoy.SubjectToGDPR() para indicar se o GDPR é aplicável ou não ao usuário.

Versão 1.1.0

  • Oferece suporte ao SDK do Tapjoy para Android versão 11.12.1.
  • Compatível com a versão 11.12.1 do SDK do Tapjoy para iOS.

Versão 1.0.0

  • Primeira versão!
  • Oferece suporte ao SDK do Tapjoy para Android versão 11.11.1.
  • Compatível com a versão 11.11.1 do SDK do Tapjoy para iOS.