即時遊戲的應用程式內部廣告

您可以向玩家顯示廣告，讓遊戲成為獲利來源。目前有兩種格式的 Audience Network 廣告已經和即時遊戲整合：獎勵式影片和插頁廣告。本節的內容將會引導您進行整合廣告獲利方式與即時遊戲的流程。

格式適用情況

必要條件

• 您已在營利管理工具中與遊戲相關聯的屬性內，建立至少一個廣告版位。
• 您可以在行動裝置或 Facebook.com 上測試您建置的內容。

注意：Audience Network 目前在某些地區受到限制。請在 Audience Network 新手入門流程中，查看您的資格是否符合。

如需詳細資訊，請參閱 Audience Network 讓即時遊戲成為獲利來源的 5 個步驟。

下載範例

如果您已設定應用程式使用營利管理工具，並已建立廣告版位，可以下載我們的示範內容，查看下列的範例程式碼如何實際運作。

顯示插頁廣告

下列程式碼片段示範如何顯示插頁廣告。

您必須先建立廣告版位並使用插頁廣告顯示格式，這些程式碼才能發揮作用。您應針對應用程式的各個廣告單位使用不同的廣告版位。

預先載入廣告

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

顯示廣告

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

顯示獎勵插頁廣告

下列程式碼片段示範如何顯示獎勵插頁廣告。

您必須先建立廣告版位並使用獎勵插頁廣告顯示格式，這些程式碼才能發揮作用。獎勵插頁廣告適用於 Facebook Gaming、行動版網頁和桌面版網頁應用程式。您應針對應用程式的各個廣告單位使用不同的廣告版位。

預先載入廣告

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

顯示廣告

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

顯示獎勵式影片廣告

下列程式碼片段示範如何顯示獎勵式影片廣告。

您必須先建立廣告版位並使用獎勵式影片顯示格式，這些程式碼才能發揮作用。您應針對應用程式的各個廣告單位使用不同的廣告版位。

預先載入廣告

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

顯示廣告

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

廣告實例的生命週期

預先載入三個相同類型的廣告實例而不顯示這些廣告實例，將會造成嘗試建立新廣告的動作失敗。成功載入廣告後，廣告的有效期間為 60 分鐘。

下列程式碼可協助您瞭解其運作方式，假設所有內容皆已正確設定（有效的廣告版位編號等）且沒有網路問題：

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');        
});

最佳作法與疑難排解

下列說明即時遊戲的特定資訊。請同時參閱我們的 Audience Network 洞察報告。

更多資訊

• Audience Network 新手指南
• 升級至獲利管理工具
• 關於廣告空間
• 建立廣告空間和版位
• 將應用程式和屬性新增到獲利管理工具
• 5 大妙招維持遊戲內廣告優質體驗
• 改善插頁廣告版位實作方式
• 改善獎勵式影片實作方式
• 獎勵式影片廣告版位的最佳作法
• 實作 6 種常見獎勵式影片整合的最佳作法