Integração da mediação do Yandex

Importante

Atualize seus adaptadores de mediação do Yandex e adaptadores de redes de mediação de terceiros para a versão mais recente. Versões mais antigas podem causar erros de integração de adaptadores que podem impedir que os anúncios sejam exibidos.

O Yandex Mediation é uma plataforma que seleciona automaticamente anúncios de uma variedade de redes usando algoritmos de aprendizado de máquina para maximizar sua receita. Todas as configurações estão prontas para uso e, portanto, não há necessidade de depurar cada rede separadamente.

Se você usou anteriormente o Yandex Mobile Ads SDK com apenas uma rede Yandex, não precisará mudar nada no código para alterar para a mediação do Yandex. Você só precisa pré-configurar os blocos na interface web das redes de anúncios externas.

Configuração preliminar

Para preparar seu aplicativo, siga os passos nas próximas seções.

Requisitos do aplicativo

  • Use Android Studio 2021 ou superior.
  • Use o Plugin Android Gradle 8.7.0 ou superior.
  • O arquivo de build do seu aplicativo deve usar os seguintes valores:
    • minSdkVersion 21 ou posterior.
    • compileSdkVersion 34 ou posterior.
  • Para carregar anúncios, independentemente do tipo, você precisa do Android 4.1 ou posterior.
  • Anúncios em vídeo são selecionados apenas para dispositivos com Android 5 ou superior.
  • Se você estiver usando o SDK AppMetrica em seu aplicativo, certifique-se de ter instalado a versão 7.2.1 e superior (dentro da 7ª versão principal).

Configure o aplicativo na sua conta da 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

Existem duas maneiras de ativar a mediação móvel:

  • Build unificado (recomendado): Todos os adaptadores disponíveis são adicionados automaticamente.
  • Adição de adaptadores individualmente: O Yandex SDK é instalado separadamente, então adaptadores específicos são adicionados um a um usando seus respectivos pacotes.

Você pode ativar automaticamente todos os adaptadores disponíveis usando o pacote de mediação geral yandex-mobileads-mediation.

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

  2. Adicione a dependência YandexMobileAdsMediation ao arquivo build.gradle no módulo do seu aplicativo:

    dependencies {
           ...
           implementation 'com.yandex.android:mobileads-mediation:7.16.0.0'
    }
    

    Para cada adaptador, a versão compatível mais recente é selecionada automaticamente.

  3. Adicione suporte ao Java 8 no arquivo build.gradle no módulo do seu aplicativo:

    android {
    
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }
    
  4. Adicione o seguinte código ao arquivo build.gradle no módulo do seu aplicativo:

    // IronSource
    maven {
           url 'https://android-sdk.is.com/'
    }
    
    // Pangle
    maven {
           url 'https://artifact.bytedance.com/repository/pangle'
    }
    
    // Tapjoy
    maven {
           url "https://sdk.tapjoy.com/"
    }
    
    // Mintegral
    maven {
           url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
    }
    
    // Chartboost
    maven {
           url "https://cboost.jfrog.io/artifactory/chartboost-ads/"
    }
    
    // AppNext
    maven {
           url "https://dl.appnext.com/"
    }
    
  5. Configure a permissão para usar o ID do anúncio (opcional a partir da versão 4.5.0).

    Como configurar a permissão para usar o ID do anúncio

    O ID do anúncio é um identificador único fornecido pelos serviços do Google Play para exibir anúncios a usuários que optam por anúncios personalizados. Os usuários podem desativar a personalização de anúncios ou redefinir o ID nas configurações. Nesse caso, as redes de publicidade não poderão usar o ID para selecionar anúncios relevantes para o usuário.

    Se o seu aplicativo utilizar uma versão do Yandex Mobile Ads SDK abaixo da 4.5, adicione com.google.android.gms.permission.AD_ID ao arquivo AndroidManifest.xml:

    <manifest>
        <application>
        <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
        </application>
    </manifest>
    

    A partir da versão 4.5.0, o Yandex Mobile Ads SDK adiciona com.google.android.gms.permission.AD_ID por padrão. Dessa forma, você não precisa especificá-lo no manifesto principal do aplicativo. Com essa permissão, você pode usar um ID de anúncio para selecionar anúncios mais relevantes das redes de publicidade.

    Você pode excluir a permissão, se necessário. Por exemplo, se uma política não permitir o uso de um ID para seleção de anúncios, como a Política para famílias.

    Para evitar que a permissão seja adicionada ao manifesto principal do aplicativo, adicione o seguinte código ao AndroidManifest.xml:

    <manifest>
        <application>
            <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
        </application>
    </manifest>
    

    Importante

    A falta dessa permissão e de acesso ao ID pode reduzir a relevância dos anúncios e, consequentemente, sua receita.

  6. Configuração adicional para a rede Google AdMob (ex. AdMob).

    Adicione seu ID do Google AdMob (ex. AdMob) ao arquivo AndroidManifest.xml criado para seu aplicativo usando a tag <meta-data> chamada com.google.android.gms.ads.APPLICATION_ID (veja aqui como encontrar seu ID do AdMob).

    <manifest>
        <application>
    <!--...-->
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <!--...-->
        </application>
    </manifest>
    

Para adicionar adaptadores individuais, ative o Yandex Ads SDK e os adaptadores relevantes seguindo as seguintes instruções:

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

  2. Adicione a dependência YandexMobileAds ao arquivo build.gradle no módulo do seu aplicativo:

    dependencies {
       ...
       implementation 'com.yandex.android:mobileads:x.x.x' // add supported version
    
       // Add dependencies on Yandex mediation adapters.
    
    }
    
  3. Adicione suporte ao Java 8 no arquivo build.gradle no módulo do seu aplicativo:

    android {
    
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }
    
  4. Adicione o seguinte código ao arquivo build.gradle no módulo do seu aplicativo:

    // IronSource
    maven {
           url 'https://android-sdk.is.com/'
    }
    
    // Pangle
    maven {
           url 'https://artifact.bytedance.com/repository/pangle'
    }
    
    // Tapjoy
    maven {
           url "https://sdk.tapjoy.com/"
    }
    
    // Mintegral
    maven {
           url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
    }
    
    // Chartboost
    maven {
           url "https://cboost.jfrog.io/artifactory/chartboost-ads/"
    }
    
    // AppNext
    maven {
           url "https://dl.appnext.com/"
    }
    
  5. Configure a permissão para usar o ID de anúncio (para aplicativos que executam versões do SDK abaixo de 4.5.0).

    Como configurar a permissão para usar o ID do anúncio

    O ID do anúncio é um identificador único fornecido pelos serviços do Google Play para exibir anúncios a usuários que optam por anúncios personalizados. Os usuários podem desativar a personalização de anúncios ou redefinir o ID nas configurações. Nesse caso, as redes de publicidade não poderão usar o ID para selecionar anúncios relevantes para o usuário.

    Se o seu aplicativo utilizar uma versão do Yandex Mobile Ads SDK abaixo da 4.5, adicione com.google.android.gms.permission.AD_ID ao arquivo AndroidManifest.xml:

    <manifest>
        <application>
        <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
        </application>
    </manifest>
    

    A partir da versão 4.5.0, o Yandex Mobile Ads SDK adiciona com.google.android.gms.permission.AD_ID por padrão. Dessa forma, você não precisa especificá-lo no manifesto principal do aplicativo. Com essa permissão, você pode usar um ID de anúncio para selecionar anúncios mais relevantes das redes de publicidade.

    Você pode excluir a permissão, se necessário. Por exemplo, se uma política não permitir o uso de um ID para seleção de anúncios, como a Política para famílias.

    Para evitar que a permissão seja adicionada ao manifesto principal do aplicativo, adicione o seguinte código ao AndroidManifest.xml:

    <manifest>
        <application>
            <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
        </application>
    </manifest>
    

    Importante

    A falta dessa permissão e de acesso ao ID pode reduzir a relevância dos anúncios e, consequentemente, sua receita.

  6. Adicione os adaptadores aplicáveis um por um usando os pacotes apropriados.

Anterior