البدء

هذا الدليل مصمم للناشرين الذين يريدون تحقيق دخل من Flutter

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

إنّ حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في Flutter تتيح حاليًا إمكانية التحميل والعرض إعلانات البانر، والإعلانات البينية (ملء الشاشة)، والإعلانات المدمجة مع المحتوى، والإعلانات التي تضم مكافأة.

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

  • Flutter 1.22.0 أو إصدار أحدث
  • جهاز Android
    • الإصدار 3.2 من "استوديو Android" أو إصدار أحدث
    • استهداف المستوى 20 أو أعلى لواجهة برمجة تطبيقات Android
    • اضبط السمة compileSdkVersion على 28 أو أعلى.
  • iOS

استيراد حزمة SDK لإعلانات الأجهزة الجوّالة

الإعداد الخاص بالنظام الأساسي

Android

تحديث ملف AndroidManifest.xml

يجب تضمين رقم تعريف تطبيق "مدير الإعلانات" في AndroidManifest.xml. ويؤدي عدم الالتزام بذلك إلى حدوث عطل عند تشغيل التطبيق.

إضافة رقم تعريف تطبيق "مدير إعلانات Google" (الذي يتم تحديده في الإعلان واجهة مستخدم المدير) إلى ملف android/app/src/main/AndroidManifest.xml للتطبيق من خلال إضافة علامة <meta-data> بالاسم com.google.android.gms.ads.APPLICATION_ID يمكنك العثور على تطبيقك رقم التعريف في واجهة مستخدم "مدير الإعلانات". بالنسبة إلى android:value، أدخل إعلانك الخاص رقم تعريف تطبيق المدير بين علامتَي اقتباس كما هو موضّح:

<manifest>
    <application>
        <!-- Sample app ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <application>
<manifest>

استخدام value نفسها عند إعداد المكوّن الإضافي في Dart الرمز.

يمكنك الاطّلاع على نظام التشغيل Android لمزيد من المعلومات حول ضبط AndroidManifest.xml وإعداد رقم تعريف التطبيق.

iOS

تعديل Info.plist

في ملف ios/Runner/Info.plist لتطبيقك، أضِف مفتاح GADApplicationIdentifier مع قيمة سلسلة خاصة بحسابك في "مدير إعلانات Google" رقم تعريف التطبيق (يتم تحديده في واجهة مستخدم "مدير الإعلانات"):

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-################~##########</string>

يجب عليك تمرير القيمة نفسها عند تهيئة المكون الإضافي في Dart الرمز.

يمكنك الاطّلاع على دليل iOS. للمزيد من المعلومات عن ضبط "Info.plist" وإعداده معرّف تطبيقك.

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة

قبل تحميل الإعلانات، يجب أن يُعِدّ تطبيقك حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال الاتصال MobileAds.instance.initialize()، الذي يُعِدّ حزمة تطوير البرامج (SDK) ويعرض Future التي تنتهي عند اكتمال عملية الإعداد (أو بعد 30 ثانية) المهلة). يجب إجراء ذلك مرة واحدة فقط، ومن الأفضل أن يتم ذلك قبل تشغيل التطبيق مباشرةً.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:flutter/material.dart';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  MobileAds.instance.initialize();

  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  MyAppState createState() => MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Load ads.
  }
}

اختيار شكل الإعلان

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

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

تنفيذ إعلان بانر

إعلان بيني

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

تنفيذ إعلان بيني

مدمجة مع المحتوى

إعلانات قابلة للتخصيص تتطابق مع شكل تطبيقك ومضمونه. أنت من تقرر كيف حيث يتم وضعها، بحيث يكون التخطيط أكثر تناسقًا مع تصميم التطبيق.

تنفيذ إعلان مدمج مع المحتوى

تم منح المكافأة

إعلانات تمنح المستخدمين مكافآت مقابل مشاهدة فيديوهات قصيرة والتفاعل مع محتوى قابل للتشغيل الإعلانات والاستطلاعات وهذه الإعلانات مناسبة لتحقيق الربح من مستخدمي الألعاب المجانية.

تنفيذ إعلان يضم مكافأة