--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/android/quick-start-mm.md - https://ads.yandex.com/helpcenter/pt/dev/android/quick-start-mm.md - https://ads.yandex.com/helpcenter/ru/dev/android/quick-start-mm.md - https://ads.yandex.com/helpcenter/zh/dev/android/quick-start-mm.md - href: pt/dev/android/quick-start-mm.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/pt/llms.txt # Integração da mediação do Yandex {% note warning %} Atualize seus adaptadores de [mediação do Yandex](../../../en/dev/android/list-network.md) e [adaptadores de redes de mediação de terceiros](../../../en/dev/android/third-party-mediation.md) 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. {% endnote %} [O Yandex Mediation](../../../en/monetization/yandex-mediation/index.md) é 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 {#prolog} Para preparar seu aplicativo, siga os passos nas próximas seções. ### Requisitos do aplicativo {#requirements} - 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 35 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](https://appmetrica.yandex.com) em seu aplicativo, certifique-se de ter instalado a versão 8.3.0 e superior (dentro da versão principal). ### Configure o aplicativo na sua conta da Yandex Advertising Network {#yan} Veja como registrar seu aplicativo na Yandex Advertising Network: 1. [Faça login](https://partner.yandex.com/) ou [registre](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27) sua conta na Yandex Advertising Network. 2. [Registre](https://passport.yandex.com/auth/list?origin=rsy_ligth_out&retpath=https%3A%2F%2Fpartner.yandex.com%2Fform%2F?roles%5B%5D=27) 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. {% list tabs %} - Build unificado Você pode ativar automaticamente todos os adaptadores disponíveis usando o pacote de mediação geral `yandex-mobileads-mediation`. 1. [Configure a mediação](../../../en/monetization/yandex-mediation/setup.md) na interface do Yandex Advertising Network. 2. Adicione a dependência YandexMobileAdsMediation ao arquivo build.gradle no módulo do seu aplicativo: ```groovy dependencies { ... implementation 'com.yandex.android:mobileads-mediation:8.3.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: ```groovy 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: ```groovy // 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). {% cut "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: ```xml ``` 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: ```xml ``` {% endcut %} {% note warning %} A falta dessa permissão e de acesso ao ID pode reduzir a relevância dos anúncios e, consequentemente, sua receita. {% endnote %} 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 `` chamada `com.google.android.gms.ads.APPLICATION_ID` (veja aqui como encontrar seu [ID do AdMob](https://support.google.com/admob/answer/7356431)). ```html ``` - Adição de adaptadores individuais Para adicionar adaptadores individuais, ative o Yandex Ads SDK e os adaptadores relevantes seguindo as seguintes instruções: 1. [Configure a mediação](../../../en/monetization/yandex-mediation/setup.md) na interface do Yandex Advertising Network. 2. Adicione a dependência YandexMobileAds ao arquivo build.gradle no módulo do seu aplicativo: ```groovy 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: ```groovy 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: ```groovy // 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). {% cut "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: ```xml ``` 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: ```xml ``` {% endcut %} {% note warning %} A falta dessa permissão e de acesso ao ID pode reduzir a relevância dos anúncios e, consequentemente, sua receita. {% endnote %} 6. Adicione os [adaptadores](../../../en/dev/android/list-network.md) aplicáveis um por um usando os pacotes apropriados. {% endlist %}