الإعلانات داخل التطبيق للألعاب الفورية

يمكنك تحقيق الأرباح من لعبتك من خلال عرض الإعلانات على اللاعبين. يوجد حاليًا تنسيقان لإعلانات Audience Network المدمجة في الألعاب الفورية: مقاطع فيديو بمكافأة والإعلانات الخلالية. سيرشدك هذا القسم خلال عملية دمج تحقيق الأرباح من الإعلانات مع لعبتك الفورية.

إتاحة التنسيق

المتطلبات الأساسية

• لقد أنشأت موضع إعلان واحد على الأقل ضمن الأصل المرتبط بلعبتك في مدير الأرباح.
• يمكنك اختبار الإصدارات على جهاز محمول أو على Facebook.com.

ملاحظة: يتم حاليًا تقييد توفير Audience Network في مناطق معينة. تحقق من أهليتك لإجراء دفق إعداد Audience Network.

راجع الدليل 5 خطوات لتحقيق الأرباح من الألعاب الفورية في Audience Network لمزيد من المعلومات.

تنزيل النموذج

إذا قمت بالفعل بتكوين تطبيقك باستخدام مدير الأرباح وأنشأت مواضع الإعلانات الخاصة بك، يمكنك عرض نموذج الرمز البرمجي أدناه أثناء الإجراء من خلال تنزيل العرض التوضيحي المتوفر لدينا:

عرض إعلان خلالي

يعرض جزء الرمز البرمجي أدناه مثالاً حول كيفية عرض إعلان خلالي.

حتى يعمل هذا الرمز، يجب أولاً إنشاء موضع إعلان بتنسيق عرض الإعلان الخلالي. كما يجب استخدام موضع مختلف لكل وحدة إعلانية في تطبيقك.

التحميل المسبق للإعلان

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 عمليات دمج شائعة للفيديو بمكافأة