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.
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();
}
}
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
|
|||||||||||||||||||||||||||
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();