من خلال واجهات برمجة التطبيقات لعرض الإعلانات في طريقة عرض الويب، تصبح إشارات التطبيقات متاحة للعلامات في
WebView، ما يساعد في تحسين تحقيق الربح للناشرين الذين قدّموا المحتوى، وحماية المعلنين من المحتوى غير المرغوب فيه.
تساعد إشارات التطبيقات هذه، مثل رقم تعريف التطبيق وإصداره، في تفعيل حالات استخدام إعداد التقارير
والاستهداف في مستودع المتصفّح داخل التطبيق
التي لا تتوفّر عادةً إلا على زيارات التطبيقات.
آلية العمل
لا يتم التواصل مع GMA Next-Gen SDK إلا استجابةً لأحداث الإعلانات التي يتم تشغيلها من خلال أي مما يلي:
تضيف حزمة SDK معالِجات الرسائل إلى WebView المسجَّلة للاستماع إلى أحداث الإعلانات هذه. لفهم طريقة عمل هذه الميزة بشكل أفضل، يمكنك الاطّلاع على
رمز المصدر لـ
صفحة الاختبار.
المتطلبات الأساسية
- GMA Next-Gen SDK الإصدار 0.6.0-alpha01 أو الإصدارات الأحدث.
تمرير رقم تعريف التطبيق إلى حزمة SDK
إذا كان لديك رقم تعريف تطبيق في "مدير الإعلانات"، عليك تهيئة GMA Next-Gen SDK باستخدام رقم تعريف التطبيق الحالي.
إذا لم يكن لديك رقم تعريف تطبيق في "مدير الإعلانات"، عليك تمرير
InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID كرقم تعريف التطبيق
عند تهيئة GMA Next-Gen SDK.
Kotlin
MobileAds.initialize(
this@MainActivity,
// Use this application ID to initialize the GMA Next-Gen SDK if
// you don't have an Ad Manager application ID.
InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
.build(),
) {
// Adapter initialization complete.
}
جافا
MobileAds.initialize(
this,
// Use this application ID to initialize the GMA Next-Gen SDK if
// you don't have an Ad Manager application ID.
new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
.build(),
initializationStatus -> {
// Adapter initialization is complete.
});
تسجيل طريقة عرض الويب
عليك استدعاء
registerWebView()
على سلسلة التعليمات الرئيسية لإنشاء اتصال بمعالِجات JavaScript في
رمز AdSense أو علامة Google للنشر ضمن كل مثيل من WebView. يجب إجراء ذلك في أقرب وقت ممكن، مثلاً في طريقة onCreate() في MainActivity.
Kotlin
import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.MobileAds
class MainActivity : AppCompatActivity() {
lateinit var webView: WebView
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
webView = findViewById(R.id.webview)
// Let the web view accept third-party cookies.
CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
// Let the web view use JavaScript.
webView.settings.javaScriptEnabled = true
// Let the web view access local storage.
webView.settings.domStorageEnabled = true
// Let HTML videos play automatically.
webView.settings.mediaPlaybackRequiresUserGesture = false
// Register the web view.
MobileAds.registerWebView(webView)
}
}
جافا
import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;
public class MainActivity extends AppCompatActivity {
private WebView webView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
webView = findViewById(R.id.webview);
// Let the web view accept third-party cookies.
CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);
// Let the web view use JavaScript.
webView.getSettings().setJavaScriptEnabled(true);
// Let the web view access local storage.
webView.getSettings().setDomStorageEnabled(true);
// Let HTML videos play automatically.
webView.getSettings().setMediaPlaybackRequiresUserGesture(false);
// Register the web view.
MobileAds.registerWebView(webView);
}
}
اختبار عملية التكامل
ننصحك بتحميل عنوان URL التالي لاختبار عملية التكامل قبل استخدام عنوان URL الخاص بك:
https://google.github.io/webview-ads/test/#api-for-ads-tests
يعرض عنوان URL للاختبار أشرطة حالة خضراء لعملية تكامل ناجحة إذا استوفيت الشروط التالية:
- تم ربط
WebViewبـ GMA Next-Gen SDK
الخطوات التالية
- جمع الموافقة في
WebViewلا تنقل واجهات برمجة التطبيقات لعرض الإعلانات في طريقة عرض الويب الموافقة التي تم جمعها في سياق تطبيق الأجهزة الجوّالة باستخدام الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB أو أُطر الامتثال لقانون خصوصية المستهلك في كاليفورنيا (CCPA) الصادرة عن مكتب IAB إلى العلامات في طرق عرض الويب. إذا كنت مهتمًا بتنفيذ مسار موافقة واحد بصفتك مالكًا لكل منWebViewومحتوى الويب المقابل الذي يتم تحقيق الربح منه، عليك العمل مع منصّة إدارة الموافقة لجمع الموافقة في سياقWebView.