במדריך הזה מוסבר איך לשלב פורמטים מותאמים אישית של מודעות מותאמות עם מדידה פתוחה.
דרישות מוקדמות
- Google Mobile Ads SDK מגרסה 18.1.1 ואילך.
- למידע נוסף, ניתן לקרוא את המאמר Open Measurement with Mobile Ads SDK.
- משלבים פורמטים מותאמים אישית של מודעות מותאמות.
- מגדירים ספק של ניראות ומקצים אותו לפריט.
- מזינים את שם השותף כשיוצרים פורמט בהתאמה אישית בממשק המשתמש של Ad Manager.
שילוב
אם אתם מתכוונים להשתמש במדידה פתוחה בפורמטים מותאמים אישית של מודעות מותאמות שלא מכילים נכס וידאו, באחריותכם לקרוא לממשקי ה-API של המדידה בכל אפליקציה בעצמכם. מדידה פתוחה של פורמטים מותאמים אישית של מודעות מותאמות לרשת המדיה נתמכת רק ב-Mobile Ads SDK בגרסה 18.1.1 ואילך.
אם אתם משתמשים בפורמטים מותאמים אישית של מודעות מותאמות עם נכס וידאו, אין צורך לפעול לפי המדריך הזה, כי ה-SDK של מודעות לנייד עוקב בשמכם אחר מידת החשיפה של נכס הווידאו.
עכשיו נראה איך להשתמש במדידה של מודעות פתוחות באמצעות NativeCustomTemplateAd
. באופן כללי, אם רוצים להתחיל למדוד את הניראות ולרשום צפייה במודעה בהתאמה אישית, צריך לשלוח התראה ל-Mobile Ads SDK.
טעינת מודעה
בין אם משתמשים במדידה של מודעות פתוחות או לא, טעינת המודעה זהה. לפניכם שיטה שמדגימה איך לבקש NativeCustomTemplateAd
:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
צריך לרשום את התצוגה ולהתחיל למדוד
כדי להפעיל מדידה פתוחה ב-NativeCustomTemplateAd
, צריך לרשום את תצוגת המודעה המותאמת אישית עם האובייקט DisplayOpenMeasurement
המשויך ל-NativeCustomTemplateAd
. האובייקט DisplayOpenMeasurement
מספק את השיטה setView()
לרישום תצוגת הקונטיינר כמדידה פתוחה.
בנוסף, צריך להורות ל-SDK באופן מפורש להתחיל למדוד את המודעה. כדי לעשות את זה, קוראים ל-method start()
באובייקט DisplayOpenMeasurement
של השדה NativeCustomTemplateAd
. צריך לקרוא ל-method start()
מה-thread הראשי, ולקריאות הבאות אין השפעה.
היא נראית כך:
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();
}
שים לב שעליך להציג את המודעה לפני רישום התצוגה. הצגת המודעה נכללת בפורמטים מותאמים אישית של מודעות מותאמות.
הפריסה customTemplateAdFrame
היא מאגר המודעות של NativeCustomTemplateAd
, והיא חייבת להכיל את כל הנכסים שבתיבה התוחמת של התצוגה.
אישור תאימות ל-IAB
לאחר השקת האפליקציה תתחילו לקבל נתוני מדידה. עם זאת, הנתונים לא יאושרו עד שתשלימו את תהליך האישור של IAB.