Configuração da Easy Monetization em aplicativos Unity

A ativação da Easy Monetization para um aplicativo inclui integrar bibliotecas de monetização e configurar sistemas de publicidade.

Para isso, você precisa fazer o seguinte:

  1. Integrar as bibliotecas necessárias.
  2. Integrar as bibliotecas das redes de publicidade.
  3. Fazer alterações no manifesto do aplicativo.
  4. Fazer alterações no arquivo Info.plist.
  5. Implementar operações com anúncios (carregamento e exibição de anúncios) no aplicativo.
  6. Obter o consentimento do usuário para usar seus dados pessoais (para países onde a lei GDPR/LGPD está em vigor).
  7. Fornecer acesso ao Firebase.
  8. Publicar o arquivo app-ads.txt no seu site.

1. Integre a biblioteca Yandex Mobile Ads SDK

Siga estas instruções para integrar a biblioteca.

2. Integre as bibliotecas das redes de publicidade

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.

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

3. Faça alterações no manifesto do aplicativo (Android)

No manifesto do aplicativo, insira as seguintes linhas no objeto application:


<manifest>
    <application>
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="Google_Application_ID"/>
    </application>
</manifest>

Atenção

Substitua Google_Application_ID pelo valor do arquivo “IDs for setup”.

4. Faça alterações no arquivo Info.plist (iOS)

Adicione estas linhas ao arquivo Info.plist do aplicativo:


<key>GADApplicationIdentifier</key>
<string>Google_Application_ID</string>

<key>SKAdNetworkItems</key>
<array>
        <!-- Yandex Ads -->
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>zq492l623r.skadnetwork</string>
    </dict>
    <dict>
        <!-- Google (ex. AdMob) -->
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
        <!-- VK Ads (ex. myTarget) -->
        <key>SKAdNetworkIdentifier</key>
        <string>n9x2a789qt.skadnetwork</string>
    </dict>
    <dict>
        <!-- VK Ads (ex. myTarget) -->
        <key>SKAdNetworkIdentifier</key>
        <string>r26jy69rpl.skadnetwork</string>
    </dict>
    <dict>
        <!-- Start.io -->
        <key>SKAdNetworkIdentifier</key>
        <string>5l3tpt7t6e.skadnetwork</string>
    </dict>
    <dict>
        <!-- UnityAds -->
        <key>SKAdNetworkIdentifier</key>
        <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
        <!-- IronSource -->
        <key>SKAdNetworkIdentifier</key>
        <string>su67r6k2v3.skadnetwork</string>
    </dict>
    <dict>
        <!-- Applovin -->
        <key>SKAdNetworkIdentifier</key>
        <string>ludvb6z3bs.skadnetwork</string>
    </dict>
    <dict>
        <!-- Mintegral -->
        <key>SKAdNetworkIdentifier</key>
        <string>kbd757ywx3.skadnetwork</string>
    </dict>
</array>

Atenção

Substitua os valores de Google_Application_ID pelos valores do arquivo “IDs for setup”.

5. Implemente a lógica das operações de anúncios

Implemente o carregamento e a exibição de anúncios com base na seguinte documentação:

Ao implementar a lógica, use os valores adUnitId do arquivo "IDs for setup":

  • Interstitial_ad_unit para anúncios intersticiais.
  • Rewarded_ad_unit para anúncios Rewarded.
  • Banner_ad_unit para anúncios em banner.

6. Implemente a obtenção do consentimento do usuário para coletar seus dados pessoais

Para usuários de países do EEE onde a lei GDPR/LGPD está em vigor, uma caixa de diálogo deve ser exibida solicitando o consentimento para usar os dados pessoais. Após o usuário dar o consentimento, notifique o SDK de anúncios sobre o fato.

Veja as instruções.

7. Configure o Firebase

Para aumentar sua receita com o Google Admob, integre o Firebase Analytics seguindo as seguintes instruções.

Após a ativação, forneça acesso com permissões de firebase.admin para e-mails de int-ad@yandex-team.com para vincular aplicativos do Firebase à conta do Google AdMob (ex. AdMob).

Siga as instruções para dar acesso ao Google Analytics com função de Editor.

Após a configuração ser concluída, você poderá revogar a função concedida.

8. Publique o arquivo app-ads.txt

O arquivo app-ads.txt (Vendedores Autorizados para Apps) é desenvolvido pela iAB para proteger aplicativos contra fraudes em anúncios. Embora esse arquivo seja opcional, usá-lo amplia o conjunto de anunciantes cujos anúncios podem ser exibidos em seu aplicativo, aumentando sua receita proveniente de anúncios.

Carregue o arquivo app-ads.txt na raiz do site especificado na página do desenvolvedor no Google Play ou na App Store.

Você deve carregar o mesmo arquivo app-ads.txt cujo link é fornecido na linha App_ads_txt do arquivo "IDs for setup".

Para mais informações sobre o arquivo app-ads.txt, confira Monetização.

9. Ativar ILRD (opcional)

Se necessário, você pode receber dados detalhados de receita. Para saber como fazer isso, veja Como ativar dados de receita por nível de impressão (ILRD).

Entre em contato com o suporte