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

בחירת פלטפורמה: Android iOS

‫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/.

לדוגמה, כדי לטעון מודעת באנר על ידי הצבת התג AdManagerAdView בפריסה של Activity באופן הבא:

# main_activity.xml
...
  <com.google.android.gms.ads.admanager.AdManagerAdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adManagerAdView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-mb-app-pub-5629679302779023/">
  </com.google.android.gms.ads.admanager.AdManagerAdView>

אפשר גם ליצור היררכיית תצוגות באופן פרוגרמטי:

Java 

AdManagerAdView adView = new AdManagerAdView(this);

adView.setAdSizes(AdSize.BANNER);
adView.setAdUnitId("ca-mb-app-pub-5629679302779023/");

// TODO: Add adView to your view hierarchy.

Kotlin 

val adView = AdManagerAdView(this)

adView.adSizes = AdSize.BANNER
adView.adUnitId = "ca-mb-app-pub-5629679302779023/"

// TODO: Add adView to your view hierarchy.

אחרי שמטמיעים את AdManagerAdView, אפשר להפעיל את השיטה loadAd()במחלקת AdManagerAdView ולהתאים אישית את התנהגות המודעה באמצעות ad events.

שימו לב: אם לא מוסיפים קו נטוי בסוף קוד הנכס של 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$.

Java

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

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();

Kotlin

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

val request = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class::java, extras)
    .build();