Integração da Mediação Yandex

Importante

Certifique-se de atualizar para as versões mais recentes do adaptador (Mediação Móvel Yandex e adaptadores para redes de mediação de terceiros). Caso contrário, podem ocorrer erros de integração inadequada do adaptador, impedindo a veiculação do anúncio.

A Mediação Móvel é uma plataforma que seleciona automaticamente anúncios de uma variedade de redes de anúncios usando algoritmos de aprendizado de máquina, o que ajuda a maximizar sua receita. Todas as configurações são pré-configuradas, portanto, você pode começar a usá-la imediatamente sem precisar configurar cada rede individualmente.

Se você estiver usando o SDK do Mobile Ads com uma única rede Yandex, a migração para a Mediação Yandex não exigirá alterações no código. Você só precisa predefinir as seções das interfaces da Web das redes de publicidade de terceiros.

O Mobile Ads Unity é um plug-in para a plataforma de jogos Unity3d que inclui suporte para Yandex Mobile Ads SDK.

Pré-requisitos

Para preparar seu aplicativo, siga as etapas descritas nas seções a seguir.

Requisitos do app

  • Para usar este SDK, o nível da API de destino do seu aplicativo deve ser definido como 31 ou superior.
  • Para carregar qualquer tipo de anúncio, é necessário ter o iOS versão 13 ou superior.
  • Use Xcode 16.1 ou superior.

Configure o aplicativo em sua conta Yandex Advertising Network

Veja como registrar seu aplicativo na Yandex Advertising Network:

  1. Faça login ou registre sua conta na Yandex Advertising Network.
  2. Registre seu aplicativo na Yandex Advertising Network.

Integração

Importante

yandex-ads-unity-plugin só funciona em ambientes Android e iOS. No momento, os anúncios não podem ser carregados e exibidos no editor do Unity.

Há dois métodos de integração:

  • Configuração única (recomendada): Todos os adaptadores disponíveis são conectados automaticamente.
  • Conexão de adaptadores individuais: Instale o Yandex SDK com o pacote lite e conecte adaptadores específicos separadamente usando os pacotes apropriados.

Você pode conectar todos os adaptadores disponíveis automaticamente usando o pacote comum yandex-mobileads-mediation.

  1. Configure a mediação na interface do Yandex Advertising Network.

  2. Baixe o diretório yandex-ads-unity-plugin e adicione o pacote yandex-mobileads-mediation-7.16.0.unitypackage. Além disso, será solicitado que você instale o resolvedor do Google. Se você já adicionou o resolvedor do Google ao projeto, desmarque a caixa.

    Como adicionar um pacote

    Selecione o plugin necessário (Assets → Import Package → Custom Package) e clique em Import.

  3. Use o resolvedor do Google para instalar dependências: ative auto-resolve ou selecione o item de menu Assets → External Dependency Manager → Android Resolver → Resolve.

  4. Para testar o plugin Mobile Ads Unity, use um dos scripts de demonstração no diretório samples do repositório yandex-ads-unity-plugin. Copie o script para o diretório do projeto e adicione-o como um Component à câmera principal.

  5. Configurações adicionais para a rede Google AdMob (ex. AdMob).

    • Para Android, crie o arquivo principal AndroidManifest.xml em File → Build Settings → Android → Player Settings → Publishing Settings → Custom Main Manifest (marque a caixa).

      Adicione seu ID do app ao arquivo de aplicação AndroidManifest.xml criado usando a tag <meta-data> chamada com.google.android.gms.ads.APPLICATION_ID.

      <manifest>
          <application>
      <!--...-->
              <meta-data
                  android:name="com.google.android.gms.ads.APPLICATION_ID"
                  android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
      <!--...-->
          </application>
      </manifest>
      
    • No projeto do Xcode gerado para iOS, adicione a chave GADApplicationIdentifier com seu app ID ao arquivo Info.plist.

      <key>GADApplicationIdentifier</key>
      <string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>
      

    Saiba mais sobre onde você pode encontrar o ID do app do Google.

Para conectar adaptadores individuais, adicione um pacote com uma versão compatível de yandex-mobileads-lite-x.x.x.unitypackage e siga as instruções específicas de cada adaptador para ativar eles:

  1. Configure a mediação na interface do Yandex Advertising Network.

  2. Baixe o diretório yandex-ads-unity-plugin e adicione o pacote yandex-mobileads-lite-7.16.0.unitypackage. Você também será solicitado a instalar o resolvedor do Google. Se você já tiver adicionado o resolvedor do Google ao seu projeto, desmarque a caixa.

    Como adicionar um pacote

    Selecione o plug-in necessário (Assets → Import Package → Custom Package) e clique em Import.

  3. Use o resolvedor do Google para instalar dependências: ative auto-resolve ou selecione o item de menu Assets → External Dependency Manager → Android Resolver → Resolve.

  4. Para testar o plug-in Mobile Ads Unity, use um dos scripts de demonstração no diretório samples do repositório yandex-ads-unity-plugin. Copie o script para o diretório do projeto e adicione-o como Component à câmera principal.

  5. Conecte os adaptadores necessários separadamente usando os pacotes apropriados.