מדריך התחלה מהירה זה מיועד לבעלי אתרים ומפתחים שרוצים להשתמש ב-AdMob כדי לייצר רווחים מאפליקציה שנבנתה עם Firebase. אם אינך מתכוון לכלול את Firebase באפליקציה שלך, בקר במקום זאת במדריך העצמאי של AdMob .
אם עדיין לא עשית זאת, למד על כל היתרונות של השימוש ב-AdMob, Firebase ו-Google Analytics ביחד.
אם זו הפעם הראשונה שאתה עובר על המדריך הזה, אנו ממליצים להוריד ולעקוב באמצעות אפליקציית הבדיקה של Google Mobile Ads C++ SDK .
לפני שאתה מתחיל
אם עדיין אין לך פרויקט Firebase ואפליקציית Firebase, עקוב אחר המדריך לתחילת העבודה של Firebase: הוסף את Firebase לפרויקט C++ שלך .
ודא ש-Google Analytics מופעל בפרויקט Firebase שלך:
אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך תהליך העבודה של יצירת הפרויקט.
אם יש לך פרויקט Firebase קיים שבו Google Analytics לא מופעל, תוכל להפעיל את Google Analytics מהכרטיסייה אינטגרציות של
שלב 1: הגדר את האפליקציה בחשבון AdMob שלך
רשום כל גרסת פלטפורמה של האפליקציה שלך כאפליקציה של AdMob. רשום כל גרסת פלטפורמה של האפליקציה שלך ב-AdMob . שלב זה יוצר אפליקציית AdMob עם מזהה אפליקציית AdMob ייחודי שתזדקק לו בהמשך המדריך הזה.
תתבקש להוסיף את ה-SDK של מודעות לנייד לאפליקציה שלך. מצא הוראות מפורטות למשימה זו בהמשך מדריך זה. קשר את כל אחת מאפליקציות AdMob שלך לאפליקציית Firebase המתאימה. שלב זה הוא אופציונלי אך מומלץ בחום. למידע נוסף על היתרונות של הפעלת מדדי משתמשים וקישור אפליקציות AdMob שלך ל-Firebase. עבור כל גרסה של פלטפורמה, השלם את שני השלבים הבאים במרכז השליטה של Apps של חשבון AdMob שלך: הפעל את מדדי המשתמש כדי לאפשר ל-AdMob לעבד ולהציג נתוני ניתוח שנאספו בחשבון AdMob שלך. זוהי גם הגדרה נדרשת עבורך לקשר את אפליקציית AdMob שלך ל-Firebase. קשר את אפליקציית AdMob לפרויקט Firebase הקיים שלך ולאפליקציית Firebase המתאימה. ודא שאתה מזין את אותו שם חבילה (Android) או מזהה חבילה (iOS) כפי שהזנת עבור אפליקציית Firebase שלך. מצא את שם החבילה או מזהה החבילה של אפליקציית Firebase שלך בכרטיס האפליקציות שלך הגדרות פרויקט . >
שלב 2: הוסף את מזהה האפליקציה שלך ב-AdMob לאפליקציה שלך
דְמוּי אָדָם
AndroidManifest.xml
של האפליקציה שלך על ידי הוספת תג <meta-data>
כפי שמוצג למטה.
<manifest> <application> <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ADMOB_APP_ID"/> </application> </manifest>
iOS
Info.plist
של האפליקציה שלך, הוסף מפתח GADApplicationIdentifier
עם ערך מחרוזת של מזהה האפליקציה שלך ב-AdMob .
<!-- Sample AdMob App ID: ca-app-pub-3940256099942544~1458002511 --> <key>GADApplicationIdentifier</key> <string>ADMOB_APP_ID</string>
שלב 3: הוסף את Google Mobile Ads SDK
firebase::gma
, הורד את Firebase C++ SDK ולאחר מכן פתח אותו לספרייה לבחירתך.
דְמוּי אָדָם
בקובץ gradle.properties
של הפרויקט שלך, ציין את המיקום של ה-SDK שנפרם:systemProp.firebase_cpp_sdk.dir=FULL/PATH/TO/SDK לקובץ settings.gradle
של הפרויקט שלך, הוסף את התוכן הבא:def firebase_cpp_sdk_dir = System.getProperty('firebase_cpp_sdk.dir') gradle.ext.firebase_cpp_sdk_dir = "$firebase_cpp_sdk_dir" includeBuild "$firebase_cpp_sdk_dir" לקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle
), הוסף את התוכן הבא, הכולל את התלות בספרייה עבור Google Mobile Ads C++ SDK.android.defaultConfig.externalNativeBuild.cmake { arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir" } # Add the dependency for the Google Mobile Ads C++ SDK apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle" firebaseCpp.dependencies { gma } לקובץ CMakeLists.txt
של הפרויקט שלך, הוסף את התוכן הבא.# Add Firebase libraries to the target using the function from the SDK. add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL) # Add the Google Mobile Ads C++ SDK. # The Firebase C++ library `firebase_app` is required, # and it must always be listed last. set(firebase_libs firebase_gma firebase_app ) target_link_libraries(${target_name} "${firebase_libs}") סנכרן את האפליקציה שלך כדי להבטיח שלכל התלות יש את הגרסאות הדרושות.
iOS
קבל את CocoaPods גרסה 1 ואילך על ידי הפעלת: sudo gem install cocoapods --pre
הוסף פוד של מודעות Google לנייד מה-SDK הפתוח. צור Podfile אם עדיין אין לך אחד: cd YOUR_APP_DIRECTORY
pod init
ל-Podfile שלך, הוסף את הפוד עבור Google Mobile Ads C++ SDK: pod 'Google-Mobile-Ads-SDK'
התקן את הפוד ולאחר מכן פתח את קובץ .xcworkspace
ב-Xcode.pod install
open YOUR_APP.xcworkspace
הוסף את המסגרות הבאות מה-SDK של Firebase C++ לפרויקט: xcframeworks/firebase.xcframework
xcframeworks/firebase_gma.xcframework
שלב 4: אתחול ה-SDK של Google Mobile Ads
firebase::gma::Initialize()
.
firebase::Future
שמסתיים לאחר סיום האתחול (או לאחר פסק זמן של 30 שניות). התקשר לשיטה זו רק פעם אחת וכמה שיותר מוקדם, באופן אידיאלי בעת השקת האפליקציה.
Initialize()
:
דְמוּי אָדָם
// Initialize the Google Mobile Ads library firebase::InitResult result; Future<AdapterInitializationStatus> future = firebase::gma::Initialize(jni_env, j_activity, &result); if (result != kInitResultSuccess) { // Initialization immediately failed, most likely due to a missing dependency. // Check the device logs for more information. return; } // Monitor the status of the future. // See "Use a Future to monitor the completion status of a method call" below. if (future.status() == firebase::kFutureStatusComplete && future.error() == firebase::gma::kAdErrorCodeNone) { // Initialization completed. } else { // Initialization on-going, or an error has occurred. }
iOS
// Initialize the Google Mobile Ads library. firebase::InitResult result; Future<AdapterInitializationStatus> future = firebase::gma::Initialize(&result); if (result != kInitResultSuccess) { // Initialization immediately failed, most likely due to a missing dependency. // Check the device logs for more information. return; } // Monitor the status of the future. // See "Use a Future to monitor the completion status of a method call" below. if (future.status() == firebase::kFutureStatusComplete && future.error() == firebase::gma::kAdErrorCodeNone) { // Initialization completed. } else { // Initialization on-going, or an error has occurred. }
השתמש Future
כדי לעקוב אחר מצב ההשלמה של קריאת שיטה
Future
כדי לעקוב אחר מצב ההשלמה של קריאת שיטהFuture
מספק לך דרך לקבוע את מצב ההשלמה של קריאות השיטה הא-סינכרונית שלך.
firebase::gma::Initialize()
, firebase::Future
חדש נוצר ומוחזר. לאחר מכן, האפליקציה שלך יכולה לסקור את status()
של Future
כדי לקבוע מתי האתחול הושלם. לאחר השלמתו, האפליקציה שלך יכולה להפעיל result()
כדי להשיג את AdapterInitializationStatus
שנוצר.
Future
יש שיטת "תוצאה אחרונה" מתאימה שבה אפליקציות יכולות להשתמש כדי לאחזר את Future
האחרון עבור פעולה נתונה. לדוגמה, firebase::gma::Initialize()
יש שיטה מתאימה בשם firebase::gma::InitializeLastResult()
, אשר מחזירה Future
שהאפליקציה שלך יכולה להשתמש בו כדי לבדוק את מצב הקריאה האחרונה ל- firebase::gma::Initialize()
.
Future
הושלם וקוד השגיאה שלו הוא firebase::gma::kAdErrorCodeNone
, אז הפעולה הושלמה בהצלחה.
Future
יושלם. במקרים מסוימים, ההתקשרות חזרה תפעל בשרשור אחר, אז ודא שהקוד שלך בטוח לשרשור. קטע קוד זה משתמש במצביע פונקציה להתקשרות חזרה:
// Registers the OnCompletion callback. user_data is a pointer that is passed verbatim // to the callback as a void*. This allows you to pass any custom data to the callback // handler. In this case, the app has no data, so you must pass nullptr. firebase::gma::InitializeLastResult().OnCompletion(OnCompletionCallback, /*user_data=*/nullptr); // The OnCompletion callback function. static void OnCompletionCallback( const firebase::Future<AdapterInitializationStatus>& future, void* user_data) { // Called when the Future is completed for the last call to firebase::gma::Initialize(). // If the error code is firebase::gma::kAdErrorCodeNone, // then the SDK has been successfully initialized. if (future.error() == firebase::gma::kAdErrorCodeNone) { // success! } else { // failure. } }
שלב 5: בחר פורמט מודעה ליישום באפליקציה שלך
דֶגֶל
מודעת ביניים
מודעות במסך מלא המכסות את הממשק של אפליקציה עד לסגירה על ידי המשתמש
מומלץ להשתמש במודעות ביניים בהפסקות טבעיות בזרימת ההפעלה של אפליקציה, כמו בין רמות של משחק או מיד לאחר השלמת משימה.
הטמעת מודעות בינייםמתוגמל
מודעות שמתגמלות משתמשים על צפייה בסרטונים קצרים ואינטראקציה עם מודעות וסקרים שניתנים להפעלה
מודעות מתגמלות (או "מבוססות תגמול") יכולות לעזור לייצר רווחים ממשתמשים בחינם להפעלה.
נושאים אחרים מעניינים
הצג מדדי משתמשים ונתוני ניתוח
לאחר ה��תחול שלו, ה-SDK של מודעות לנייד מתחיל אוטומטית לרשום אירועי ניתוח ומאפייני משתמש מהאפליקציה שלך. אתה יכול להציג נתונים אלה מבלי להוסיף קוד נוסף לאפליקציה שלך או ליישם מודעות כלשהן. כאן תוכל לראות את נתוני הניתוח:
בכרטיס מדדי המשתמש של חשבון AdMob שלך (מרכז השליטה של דף הבית או האפליקציות ), תוכל להציג מדדי משתמשים שנאספו מהנתונים האנליטיים שנאספו, כמו משך ביקור ממוצע, ARPU ושימור.
במרכז השליטה של Analytics של מסוף Firebase, תוכל להציג נתונים סטטיסטיים מצטברים וסיכומים של מדדי מפתח . אם תוסיף את Firebase SDK עבור Google Analytics , תוכל גם לסמן המ��ות ע��ור מס��ות ��רסום ��לבנות קהלים מותאמים אישית במסוף Firebase.
שים לב שכדי לייצג טוב יותר את מדדי ARPU ו- ARPPU , ייתכן שתרצה לכלול נתונים מאירוע ניתוח מותאם אישית בשם ecommerce_purchase
בחישוב ההכנסה עבור מדדים אלה ( למד כיצד ).
(אופציונלי) השתמש בתכונות נוספות של Google Analytics ו-Firebase
נצל עוד הזדמנויות ותכונות כדי לשפר את המונטיזציה של האפליקציה ומעורבות המשתמשים:
הוסף והשתמש ב-Firebase SDK עבור Google Analytics
הטמע רישום אירועים מותאם אישית באפליקציה שלך.
סמן המרות עבור מסעות פרסום מותאמים אישית .
כלול נתוני אירועי
ecommerce_purchase
בחישוב ההכנסה עבור מדדי ARPU ו- ARPPU .
למידע נוסף, בקר במדריך לשימוש ב-Google Analytics ו-Firebase עם אפליקציות AdMob .
השתמש במוצרים אחרים של Firebase באפליקציה שלך
לאחר הוספת Firebase SDK עבור Google Analytics, השתמש במוצרים אחרים של Firebase כדי לבצע אופטימיזציה של מודעות באפליקציה שלך.
Config מרחוק מאפשר לך לשנות את ההתנהגות והמראה של האפליקציה שלך מבלי לפרסם עדכון אפליקציה, ללא עלות, למשתמשים פעילים יומיים ללא הגבלה.
בדיקת A/B נותנת לך את הכוח לבדוק שינויים בממשק המשתמש, בתכונות או בקמפיינים של מעורבות של האפליקציה שלך כדי לדעת אם הם משפיעים על מדדי המפתח שלך (כמו הכנסה ושימור) לפני פרסום השינויים באופן נרחב.