Configurações avançadas

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

Especifique as configurações

Crie um objeto VungleSDKConfig e adicione-o como um parâmetro na inicialização do SDK para especificar as configurações opcionais.

VungleSDKConfig sdkConfig = new VungleSDKConfig();
sdkInstance = AdFactory.GetInstance(appID, sdkConfig);

O VungleSDKConfig contém parâmetros que permitem limitar o rastreamento ASHWID do Windows e definir o espaço mínimo em disco necessário para inicializar ou carregar anúncios.

sdkConfig.DisableAshwidTracking = true;
sdkConfig.MinimumDiskSpaceForAd = 50 * 1024 * 1024;
sdkConfig.MinimumDiskSpaceForInit = 50 * 1024 * 1024;

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

Estas são as propriedades disponíveis na instância do objeto AdConfig.

Opções

Valor padrão/
tipo

Descrição

Orientation

Autorrotação

DisplayOrientations

Orientation.AutoRotate (padrão) faz o anúncio acompanhar a orientação do dispositivo.

Orientation.Portrait faz o anúncio ser reproduzido apenas na orientação retrato.

Orientation.Landscape faz o anúncio ser reproduzido apenas na orientação paisagem.

Nota: esta opção aplica-se apenas a aplicativos para dispositivos móveis.

SoundEnabled

true

bool

Define o estado inicial do som do anúncio.

Se definida como ‘true’ (padrão), o áudio terá o volume e as configurações de som do dispositivo.

Se definida como ‘false’, o vídeo começará mudo, mas o usuário poderá modificar essa opção.

BackButtonImmediatelyEnabled

false

bool

Se definida como ‘true’, permite que o usuário saia imediatamente do anúncio por meio do botão Voltar.

Se definida como ‘false’ (padrão), o usuário não poderá usar o botão Voltar para sair do anúncio até o botão Fechar ser exibido na tela.

Nota: esta opção aplica-se apenas a aplicativos para dispositivos móveis.

Volume

1.0

double

Esta configuração representa uma fração do volume do dispositivo e aceita valores entre 0,0 e 1,0.

Observação: essa configuração está disponível apenas para v6.3.0 e versões superiores.

Incentivized

-

OBSOLETO

É possível definir a configuração da recompensa no nível do posicionamento, a partir do painel. Consulte Configuração e relatório de posicionamentos.

As opções para SoundEnabled e diálogos com incentivo para anúncios de Modelo Dinâmico estão disponíveis no painel para configuração. A configuração programática só se aplica a anúncios legados.

Mostrar o botão Fechar

Para determinar se o usuário tem a opção de fechar um anúncio, utilize as opções de visualização forçada nas configurações avançadas do seu aplicativo no Painel de controle do Vungle.

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

Desde 25 de maio de 2019, o Regulamento Geral de Proteção de Dados (GDPR) é aplicado na União Europeia. Para cumprir o GDPR, 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.
// To set the user’s consent status as opted in to version 1.0 of your consent dialog:
sdkInstance.UpdateConsentStatus(VungleConsentStatus.VungleConsentAccepted,"1.0");

// To set the user’s consent status as opted out of version 2.0 of your consent dialog:
sdkInstance.UpdateConsentStatus(VungleConsentStatus.VungleConsentDenied,"2.0"); // To find out what the user’s current consent status is: // This will return null if the GDPR Consent status has not been set // Otherwise, it will return VungleConsentStatus.VungleConsentAccepted or // VungleConsentStatus.VungleConsentDenied UpdateConsentStatus? currentStatus = sdkInstance.GetCurrentConsentStatus();

// To find out which version of your consent dialog the user was last shown:
sdkInstance.GetConsentMessageVersion();

Se você estiver usando o Vungle SDK v6.2 ou versões inferiores, defina o status de consentimento da seguinte maneira:

// To set the user’s consent status on SDK versions 6.2 and below:
sdkInstance.UpdateConsentStatus(VungleConsentStatus.VungleConsentAccepted);

Questions?

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

Esse artigo foi útil?