Integração Yandex Mediation

Importante

Certifique-se de atualizar para as versões mais recentes do adaptador (Mediation 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 Mediation é uma plataforma que seleciona automaticamente anúncios de várias redes de publicidade usando algoritmos de aprendizado de máquina, o que ajuda você 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ê tem usado o Yandex Mobile Ads SDK com uma única rede Yandex, a migração para a Yandex Mediation não requer alterações no código. Você só precisa predefinir as seções das interfaces da Web das redes de publicidade de terceiros.

Pré-requisitos

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

Requisitos do aplicativo

  • Use Android Studio 2021 ou superior.
  • Use o Plugin Android Gradle versão 8.7.0 ou superior.
  • O arquivo de build do seu aplicativo deve usar os seguintes valores:
    • minSdkVersion 21 ou superior.
    • compileSdkVersion 35 ou superior.
  • Para carregar qualquer tipo de anúncio, é necessário ter o Android versão 4.1 ou superior.
  • Anúncios em vídeo são veiculados apenas em dispositivos com Android 5 ou superior.
  • Caso use o SDK AppMetrica no seu app, certifique-se de possuir a versão 8.6.0 ou superior (dentro da versão principal 7) instalada.

Configure o aplicativo na sua conta da Yandex Advertising Network

Registre seu aplicativo como app Yandex Advertising Network seguindo estes passos:

  1. Faça login na sua conta ou cadastre-se para Yandex Advertising Network.
  2. Registre seu aplicativo na Yandex Advertising Network.

Integração

Para conectar adaptadores individuais, habilite o Yandex Ads SDK e siga as instruções específicas para cada adaptador:

  1. Configure a mediação na interface da 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' // adicionar versão suportada

    // Adicionar dependências nos adaptadores do Yandex Mediation.

}

  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/"
}

// BidMachine
maven {
       url 'https://artifactory.bidmachine.io/bidmachine'
}

// 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

    IDs de anúncio são IDs únicos fornecidas pelos serviços Google Play. Elas são usadas para veicular anúncios a usuários que consentem em receber anúncios personalizados. Os usuários podem optar por não receber anúncios personalizados ou redefinir a ID nas configurações. Nesse caso, as redesde anúncios não podem usá-la para exibir anúncios relevantes.

    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. Isso significa que você não precisa especificá-la no manifesto principal do seu aplicativo. Com essa permissão, você pode usar a ID de anúncio para exibir anúncios mais relevantes das redes de anúncios.

    Você pode excluir a permissão, se necessário. Por exemplo, pode ser necessário fazer isso caso uma política, como a Política de Famílias, não permita o uso da ID para veicular anúncios.

    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 ausência de permissão e de acesso à ID pode afetar sua receita, pois seu app pode acabar veiculando anúncios menos relevantes.

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

Anterior
GDPR