شارك بتعليقاتك، وساعد في تشكيل خارطة طريق SDK لإعلانات Google على الجوال. عليك المشاركة في الاستطلاع السنوي لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لعام 2023 قبل إغلاقه في 5 أيار (مايو) 2023.

إعلان بيني بمكافأة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الإعلانات البينية بمكافأة هي نوع من أشكال الإعلانات المحفَّزة التي تتيح لك تقديم مكافآت للإعلانات التي تظهر تلقائيًا أثناء عمليات نقل التطبيقات العادية. على عكس الإعلانات بمكافأة، لا يُطلب من المستخدمين الموافقة على مشاهدة الإعلان البيني.

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

  • SDK لإعلانات Google على الأجهزة الجوّالة 7.60.0 أو إصدار أحدث.
  • أكمِل دليل البدء.

التنفيذ

في ما يلي الخطوات الأساسية لدمج الإعلانات البينية بمكافأة:

  • تحميل إعلان
  • [اختياري] التحقّق من استدعاءات SSV
  • التسجيل من أجل معاودة الاتصال
  • عرض الإعلان والتعامل مع حدث المكافأة

تحميل إعلان

يتم تحميل الإعلان باستخدام طريقة loadWithAdUnitID:request:completionHandler: الثابتة في الصف GADRewardedInterstitialAd. تتطلب طريقة التحميل رقم تعريف الوحدة الإعلانية، والكائن GADRequest، ومعالج الاكتمال الذي يتم استدعاؤه عند نجاح أو عدم تحميل الإعلان. يتم توفير العنصر GADRewardedInterstitialAd الذي تم تحميله كمعلّمة في معالج الإكمال. يوضّح المثال التالي كيفية تحميل GADRewardedInterstitialAd في الصف ViewController.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var rewardedInterstitialAd: GADRewardedInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()

    GADRewardedInterstitialAd.load(withAdUnitID:"ca-app-pub-3940256099942544/6978759866",
    request: GADRequest()) { ad, error in
      if let error = error {
        return print("Failed to load rewarded interstitial ad with error: \(error.localizedDescription)")
      }

      self.rewardedInterstitialAd = ad
    }
  }
}

Objective-C

#import "ViewController.h"

@interface ViewController ()
@property(nonatomic, strong) GADRewardedInterstitialAd* rewardedInterstitialAd;
@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  [GADRewardedInterstitialAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/6978759866"
                request:[GADRequest request]
      completionHandler:^(
          GADRewardedInterstitialAd* _Nullable rewardedInterstitialAd,
          NSError* _Nullable error) {
        if (!error) {
          self.rewardedInterstitialAd = rewardedInterstitialAd;
        }
      }
  ];
}

[اختياري] التحقّق من استدعاءات التحقق من جهة الخادم (SSV)

يجب أن تستخدم التطبيقات التي تتطلب بيانات إضافية في عمليات استدعاء التحقّق من جهة الخادم ميزة البيانات المخصّصة للإعلانات بمكافأة. يتم تمرير أي قيمة سلسلة يتم ضبطها على كائن إعلان بمكافأة إلى معلَمة طلب البحث custom_data لاستدعاء SSV. وفي حال عدم ضبط قيمة مخصّصة للبيانات، لن تكون قيمة معلّمة طلب البحث custom_data متوفّرة في معاودة الاتصال بميزة SSV.

يوضح نموذج الرمز التالي كيفية إعداد بيانات مخصّصة على عنصر إعلان بيني بمكافأة قبل طلب إعلان.

Swift

GADRewardedInterstitialAd.load(withAdUnitID:"ca-app-pub-3940256099942544/6978759866",
                       request: request,
                       completionHandler: { [self] ad, error in
      if let error != error {
      rewardedInterstitialAd = ad
      let options = GADServerSideVerificationOptions()
      options.customRewardString = "SAMPLE_CUSTOM_DATA_STRING"
      rewardedInterstitialAd.serverSideVerificationOptions = options
    }

Objective-C

GADRequest *request = [GADRequest request];
[GADRewardedInterstitialAd
     loadWithAdUnitID:@"ca-app-pub-3940256099942544/6978759866"
              request:request
    completionHandler:^(GADRewardedInterstitialAd *ad, NSError *error) {
      if (error) {
        // Handle Error
        return;
      }
      self.rewardedInterstitialAd = ad;
      GADServerSideVerificationOptions *options =
          [[GADServerSideVerificationOptions alloc] init];
      options.customRewardString = @"SAMPLE_CUSTOM_DATA_STRING";
      ad.serverSideVerificationOptions = options;
    }];