Anúncios no app em Jogos Instantâneos

Você pode monetizar seu jogo exibindo anúncios aos jogadores. No momento, há dois formatos de anúncio do Audience Network integrados com os Jogos Instantâneos: os anúncios intersticiais e os vídeos com incentivo. Esta seção é um guia sobre o processo de integração da monetização de anúncios com seu jogo instantâneo.

Disponibilidade de formatos

Pré-requisitos

• Você criou pelo menos um posicionamento de anúncio na propriedade associada ao jogo no Gerenciador de Monetização.
• É possível testar suas criações em um dispositivo móvel ou em Facebook.com.

Observação: no momento, o Audience Network é limitado em algumas regiões. Verifique sua qualificação no fluxo de integração do Audience Network.

Consulte o guia Cinco etapas para começar a monetizar Jogos Instantâneos do Audience Network para saber mais.

Baixar exemplo

Se você já configurou seu app com o Gerenciador de Monetização e criou seus posicionamentos de anúncios, poderá ver o exemplo de código abaixo em ação ao baixar nossa demonstração:

Como exibir um anúncio intersticial

O trecho de código abaixo mostra um exemplo de como exibir um anúncio intersticial.

Para que o código funcione, você precisa criar um posicionamento de anúncio com o formato de exibição definido como Intersticial. Use posicionamentos diferentes para cada unidade de anúncio no seu app.

Pré-carregar o anúncio

var preloadedInterstitial = null;

FBInstant.getInterstitialAdAsync(
  '123123123123_123123123123' // Your Ad Placement Id
).then(function(interstitial) {
  // Load the Ad asynchronously
  preloadedInterstitial = interstitial;
  return preloadedInterstitial.loadAsync();
}).then(function() {
  console.log('Interstitial preloaded');
}).catch(function(err){
  console.error('Interstitial failed to preload: ' + err.message);
});

Exibir o anúncio

preloadedInterstitial.showAsync()
.then(function() {
  // Perform post-ad success operation
  console.log('Interstitial ad finished successfully');        
})
.catch(function(e) {
  console.error(e.message);
});

Como exibir um anúncio intersticial com incentivo

O trecho de código abaixo mostra um exemplo de como exibir um anúncio intersticial com incentivo.

Para que o código funcione, você precisa criar um posicionamento de anúncio com o formato de exibição definido como Intersticial com incentivo. Os anúncios intersticiais com incentivo estão disponíveis para apps da web do celular, da web para desktop e do Facebook Gaming. Use posicionamentos diferentes para cada unidade de anúncio no seu app.

Pré-carregar o anúncio

var preloadedRewardedInterstitial = null;

FBInstant.getRewardedInterstitialAsync(
  '123123123123_123123123123' // Your Ad Placement Id
).then(function(rewarded) {
  // Load the Ad asynchronously
  preloadedRewardedInterstitial = rewarded;
  return preloadedRewardedInterstitial.loadAsync();
}).then(function() {
  console.log('Rewarded interstitial preloaded');
}).catch(function(err){
  console.error('Rewarded interstitial failed to preload: ' + err.message);
});

Exibir o anúncio

preloadedRewardedInterstitial.showAsync()
.then(function() {
  // Perform post-ad success operation
  console.log('Rewarded interstitial watched successfully');        
})
.catch(function(e) {
  console.error(e.message);
});

Como exibir um anúncio de vídeo com incentivo

O trecho de código abaixo mostra um exemplo de como exibir um anúncio de vídeo com incentivo.

Para que o código funcione, você precisa criar um posicionamento de anúncio com o formato de exibição definido como Vídeo com incentivo. Use posicionamentos diferentes para cada unidade de anúncio no seu app.

Pré-carregar o anúncio

var preloadedRewardedVideo = null;

FBInstant.getRewardedVideoAsync(
  '456456456456_456456456456' // Your Ad Placement Id
).then(function(rewarded) {
  // Load the Ad asynchronously
  preloadedRewardedVideo = rewarded;
  return preloadedRewardedVideo.loadAsync();
}).then(function() {
  console.log('Rewarded video preloaded');
}).catch(function(err){
  console.error('Rewarded video failed to preload: ' + err.message);
});

Exibir o anúncio

preloadedRewardedVideo.showAsync()
.then(function() {
  // Perform post-ad success operation
  console.log('Rewarded video watched successfully');        
})
.catch(function(e) {
  console.error(e.message);
});

O ciclo de vida das instâncias de anúncio

Pré-carregar três instâncias de anúncio do mesmo tipo sem exibi-las causará uma falha quando você tentar criar um novo anúncio. Após a conclusão do carregamento, o anúncio ficará válido por 60 minutos.

O código de amostra abaixo ajuda a entender como isso funciona, considerando que todas as configurações estejam corretas (por exemplo, identificação válida do posicionamento do anúncio) e que não haja nenhum problema de rede:

var preloadedInterstitial1 = null;
var preloadedInterstitial2 = null;
var preloadedInterstitial3 = null;
var preloadedRewardedVideo = null;

// PRELOAD PHASE
FBInstant.getInterstitialAdAsync(
  '123123123123_123123123123'
).then(function(interstitial) {
  // This should get called, meaning you now have 1 ad instance.
  preloadedInterstitial1 = interstitial;
  return preloadedInterstitial1.loadAsync();
}).then(function() {
  // This should get called unless we do not have ads to serve.
  console.log('Interstitial 1 preloaded')
}).catch(function(err){
  // This would be called only if we do not have ads to serve.
  // The error would then be ADS_NO_FILL.
  // You can try to reload the ad after some time (ideally over 30 seconds).
  // If you get ADS_NO_FILL 3 times in a row, the instance will be disabled.
  console.error('Interstitial 1 failed to preload: ' + err.message);
  // You can try to reload after 30 seconds (2nd attempt)
  setTimeout(function () { handleAdsNoFill(preloadedInterstitial1, 2); }, 30 * 1000);
});

// Here is how the function to handle ADS_NO_FILL would look like
function handleAdsNoFill (adInstance, attemptNumber) {
  if (attemptNumber > 3) {
    // You can assume we will not have to serve in the current session, no need to try
    // to load another ad.
    return;
  } else {
    adInstance.loadAsync().then(function() {
      // This should get called if we finally have ads to serve.
      console.log('Interstitial preloaded')
    }).catch(function(err){
      console.error('Interstitial failed to preload: ' + err.message);
      // You can try to reload after 30 seconds
      setTimeout(function () {
        handleAdsNoFill(adInstance, attemptNumber+1);
      }, 30 * 1000);
    });
  }
}

// As we covered ADS_NO_FILL, from now on let's assume we have ads to serve.
FBInstant.getInterstitialAdAsync(
  // You can re-use the same Ad Placement Id as long as it is of the valid type:
  // interstitial or rewarded video (here, it has to be interstitial)
  '123123123123_123123123123'
).then(function(interstitial) {
  // This should get called, meaning you now have 2 ad instances.
  preloadedInterstitial2 = interstitial;
  return preloadedInterstitial2.loadAsync();
}).then(function() {
  console.log('Interstitial 2 preloaded')
});

FBInstant.getRewardedVideoAsync(
  '456456456456_456456456456'
).then(function(rewarded) {
  // This should get called, meaning you now have 3 ad instances.
  preloadedRewardedVideo = rewarded;
  return preloadedRewardedVideo.loadAsync();
}).then(function() {
  console.log('Rewarded video preloaded')
});

FBInstant.getInterstitialAdAsync(
  '123123123123_123123123123'
).catch(function(err){
  // This should be called now because you already have 3 ad instances.
  // The error would then be ADS_TOO_MANY_INSTANCES.
  console.error('Interstitial 3 failed to preload: ' + err.message);
});

// SHOWING ADS (at a timing that makes sense in the workflow of your game)
preloadedInterstitial1.showAsync()
.then(function() {
  // This should get called, meaning you now have 2 ad instances.
  console.log('Interstitial ad 1 finished successfully');        
});

// A bit later, assuming you did not preload a new instance yet.
preloadedInterstitial2.showAsync()
.then(function() {
  // This should get called, meaning you now have 1 ad instance.
  console.log('Interstitial ad finished successfully');        
});

// A bit later, assuming you did not preload a new instance yet.
preloadedRewardedVideo.showAsync()
.then(function() {
  // This should get called, meaning you now have no ad instance.
  console.log('Rewarded video watched successfully');        
});

Boas práticas e solução de problemas

As informações abaixo são específicas para Jogos Instantâneos. Consulte também os insights do Audience Network.

Mais informações

• Introdução ao Audience Network
• Como atualizar para o Gerenciador de Monetização
• Sobre os Espaços do Anúncio
• Como criar Espaços e posicionamentos do anúncio
• Como adicionar aplicativos e propriedades ao Gerenciador de Monetização
• Cinco dicas essenciais para um anúncio de qualidade no jogo
• Aprimorar a implementação do posicionamento intersticial
• Melhore a implementação do seu anúncio de vídeo com incentivo
• Melhores práticas para posicionamento de anúncio de vídeo com incentivo
• Melhores práticas para implementar seis integrações comuns de vídeo com incentivo