הגדרת גישה ישירה ל-Ad Exchange

‫Google Mobile Ads SDK תומך במונטיזציה של האפליקציות באמצעות נכס Ad Exchange. במדריך הזה מוסבר איך להגדיר את האפליקציות לכל הפורמטים של המודעות שנתמכים ב-Ad Exchange.

דרישות מוקדמות

הגדרת האפליקציה לגישה ל-Ad Exchange

מוסיפים את מזהה האפליקציה ב-Ad Manager (שמופיע בממשק המשתמש של Ad Manager) לקובץ AndroidManifest.xml של האפליקציה באמצעות תג <meta-data> עם android:name="com.google.android.gms.ads.APPLICATION_ID". במקום android:value, מזינים את מזהה האפליקציה שלכם ב-Ad Manager, בתוך מרכאות.

<manifest>
    <application>
        <!-- Sample Ad Manager 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>

שימו לב גם שאם לא מוסיפים את התג <meta-data> כמו שמוצג למעלה, המערכת קורסת ומוצגת ההודעה:

Missing application ID.

לאחר מכן, אפשר להפעיל את Google Mobile Ads SDK ולבחור פורמט מודעה להצגה. בהמשך המדריך הזה נסביר איך לטעון מודעה מ-Ad Exchange באמצעות פורמט הבאנר. אותם השלבים חלים על כל פורמט מודעה שנתמך על ידי Google Mobile Ads SDK.

טעינת מודעה מ-Ad Exchange

אפשר להשתמש בקוד של נכס אינטרנט ב-Ad Exchange עם לוכסן בסוף, במקום מזהה של יחידת מודעות. לדוגמה, ca-mb-app-pub-5629679302779023/.

בדוגמה הבאה מוסיפים את קוד נכס האינטרנט של Ad Exchange לבקשה להצגת מודעת באנר:

Kotlin 

val adRequest = BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/", AdSize.BANNER).build()

BannerAd.load(
  adRequest,
  object : AdLoadCallback<BannerAd> {
    override fun onAdLoaded(ad: BannerAd) {
      bannerAd = ad
      activity?.runOnUiThread {
        binding.bannerViewContainer.addView(ad.getView(requireActivity()))
      }
    }
  }
)

Java 

BannerAdRequest adRequest = new BannerAdRequest.Builder("ca-mb-app-pub-5629679302779023/",
    AdSize.BANNER).build();

BannerAd.load(
    adRequest,
    new AdLoadCallback<BannerAd>() {
      @Override
      public void onAdLoaded(@NonNull BannerAd ad) {
        bannerAd = ad;
        runOnUiThread(
            () -> binding.bannerViewContainer.addView(ad.getView(MainActivity.this)));
      }
    });

שימו לב: אם לא מוסיפים קו נטוי בסוף קוד הנכס של Ad Exchange לאתר, מתקבלת שגיאה בבקשה להצגת מודעה עם ההודעה:

Invalid Request. Cannot determine request type. Is your ad unit id correct?

אפשר גם להמיר קוד של נכס אינטרנט ב-Ad Exchange ליחידת מודעות. לאחר מכן, משתמשים בממשק המשתמש של Ad Manager כדי ליצור תג Ad Exchange ומעתיקים אותו לאפליקציה. התג שנוצר צריך לכלול את קוד הנכס האינטרנטי של Ad Exchange, ואחריו את מזהי יחידות המודעות של צאצאים ללא לוכסן בסוף, לדוגמה: ca-mb-app-pub-5629679302779023/banner.

זהו! האפליקציה שלך מוכנה עכשיו לטעון ולהציג מודעות באנר מ-Ad Exchange.

בנוסף, אתם יכולים להשתמש בנכס אתר ב-Ad Exchange כדי לטעון ולהציג פורמטים אחרים של מודעות מ-Ad Exchange. לשם כך, אתם יכולים להיעזר במדריכים הבאים:

(רק בעלי תוכן דיגיטלי באירופה שאושרו) הוספת מחיר מינימום

אפשר לשלוח בקשה להפעלת התכונה 'מחירי מינימום'.

אחרי שהבקשה תאושר, תוכלו לכלול במודעה מחיר מינימום ציבורי או פרטי באמצעות הפרמטרים pubf ו-pvtf בהתאמה. בדוגמת הקוד הבאה, מחליפים את '123' במחירי המינימום במיקרו ובמטבע ברירת המחדל של הרשת. דוגמה לאופן השימוש במיקרו: אם מטבע ברירת המחדל הוא דולר ארה"ב, הזנת הערך 6000000 שווה ל-6.00$.

Kotlin

val extras = Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

val request = AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();

Java 

Bundle extras = new Bundle();
// Public floor parameter.
extras.putString("pubf", "123");
// Private floor parameter.
extras.putString("pvtf", "123");

AdRequest request = new AdRequest.Builder("ca-mb-app-pub-5629679302779023/")
    .setGoogleExtrasBundle(extras)
    .build();