Configurações avançadas

Comece seguindo as instruções no artigo de integração de plug-in básico e, em seguida, as instruções para qualquer um dos formatos de anúncio que você deseja integrar (anúncios intersticiais ou premiados, banner ou anúncios MREC). Este artigo contém informações complementares e pressupõe que você tenha concluído a integração básica.

Funcionalidade OnPause e OnResume

Adicione código para as funcionalidades onPause e onResume que ativam um anúncio pausado quando um aplicativo vai para segundo plano para voltar a ser reproduzido.

void OnApplicationPause(bool pauseStatus) {
    if (pauseStatus) {
        Vungle.onPause();
    }
    else {
        Vungle.onResume();
    }
}

Implementação da CCPA

A partir de 1º de julho de 2020, a Lei de Privacidade do Consumidor da Califórnia (CCPA) será aplicada e os distribuidores devem atualizar para o Plug-in Unity 6.7.0.0 para cumprir com a CCPA.

Use updateCCPAStatus para definir o status de consentimento do usuário a fim de especificar que o usuário optou por não aderir, inserindo Consent.DENIED. E use getCCPAStatus para obter o status da CCPA atual para o usuário específico.

public static void updateCCPAStatus(Consent consent)
public static Consent getConsentStatus()

Código de exemplo

Vungle.updateCCPAStatus(Vungle.Consent.Denied);
Vungle.Consent CurrentCCPAStatus = Vungle.getCCPAStatus();

Opções de configuração de anúncios

O método playAd também pode aceitar um dicionário de opções para personalizar a experiência de reprodução de anúncios.

public static void playAd(Dictionary<string,object> options, string placementID);

Observação: anúncios com recompensa são, às vezes, chamados de anúncios incentivados; ambos os termos sempre referem-se ao mesmo tipo de anúncio. No código do SDK e em nossa API de relatórios, usamos o termo "incentivado".

O dicionário de opções aceita as seguintes chaves:

Chave Descrição
orientation Define a orientação do anúncio
  • UseVungleAdOrientation enum para especificar a orientação desejada em Inteiro
    public enum VungleAdOrientation
    {
        Portrait = 1,
        LandscapeLeft = 2,
        LandscapeRight = 3,
        PortraitUpsideDown = 4,
        Landscape = 5,
        All = 6,
        AllButUpsideDown = 7
    }
    VungleAdOrientation Valor Orientação Plataforma suportada
    1 Retrato iOS, Android, Windows
    2 LandscapeLeft iOS
    3 LandscapeRight iOS
    4 PortraitUpsideDown iOS
    5 Paisagem iOS, Android, Windows
    6 Tudo iOS, Android, Windows
    7 AllButUpsideDown iOS
    8 MatchVideo Android
  • Para v6.7.2.1 e inferior, Android e Windows obtém true ou false para orientation, que ainda funciona a partir da v6.8.0.0, mas planejado para ser descontinuado no futuro.
userTag String da chave do usuário que é passada para identificar usuários na chamada S2S (se houver algum).
alertTitle String usada como título da caixa de diálogo de alerta, apresentada quando um usuário fecha prematuramente uma experiência de anúncio incentivado.
alertText String usada como texto de corpo da caixa de diálogo de alerta, apresentada quando um usuário fecha prematuramente uma experiência de anúncio incentivado.
closeText Título da string do texto do botão de fechamento da caixa de diálogo de alerta, apresentada quando um usuário fecha prematuramente uma experiência de anúncio incentivado.
continueText Título da string do texto do botão de fechamento da caixa de diálogo de alerta, apresentada quando um usuário fecha prematuramente uma experiência de anúncio incentivado.

 

Espaço mínimo em disco

A configuração mínima de espaço em disco foi introduzida na versão 6.4.0 para determinar os limites de espaço disponível no dispositivo de um usuário antes do Vungle SDK ser inicializado e buscar anúncios. O valor padrão de SetMinimumDiskSpaceForInitialization é 51 MB e de SetMinimumDiskSpaceForAd é 50 MB. O tamanho é inserido em bytes (não em MB).

Vungle.SetMinimumDiskSpaceForInitialization(minValue);
Vungle.SetMinimumDiskSpaceForAd(minValue);
Vungle.init(appID);

Desativar ID de hardware

No SDK versão 6.4.0 em diante, os distribuidores agora podem restringir a passagem do ID de hardware do dispositivo para o SDK.

//Set false to opt in for Hardware ID collection by SDK or true to opt out
Vungle.EnableHardwareIdPrivacy(m_disableHardwareID);

Instruções de implementação recomendada pelo RGPD

O Regulamento Geral sobre a Proteção de Dados (RGPD) entrou em vigor na União Europeia em 25 de maio de 2019. Para estar em conformidade com o RGPD, os desenvolvedores têm duas opções.

  • Opção 1 (recomendada): permitir que o Vungle lide com os requisitos. O Vungle exibirá uma caixa de diálogo de consentimento antes de reproduzir um anúncio para um usuário europeu e se lembrará do consentimento ou rejeição do usuário para os anúncios subsequentes.
  • Opção 2: o distribuidor controla o processo de consentimento do GDPR ao nível do usuário e, em seguida, comunica a escolha do usuário à Vungle. Para fazer isso, os desenvolvedores podem coletar o consentimento do usuário usando seu próprio mecanismo e, em seguida, usar as APIs Vungle para atualizar ou consultar o status de consentimento do usuário. Consulte o modelo de código abaixo para obter detalhes.

Para usar as APIs da Vungle para atualizar ou consultar o status de consentimento do usuário conforme recomendado na Opção 1, use o enumerador Vungle.Consent e defina o valor atual com as duas funções abaixo.

// The Consent enum is used to represent the user's current GDPR opt-in status
public enum Consent {
    Undefined = 0,
    Accepted = 1,
    Denied = 2
}

// Sets the user's consent status
void updateConsentStatus(Vungle.Consent consent);

// Sets the user's consent status and also sets a string to track GDPR version
void updateConsentStatus(Vungle.Consent consent, string consentMessageVersion);

// Gets the user's consent status
Vungle.Consent getConsentStatus();

Questions?

Need further assistance, feel free to reach out to us, we’re here to help!

Esse artigo foi útil?