תצוגה מקדימה של קריאייטיב & מפקח הצגת מודעות

במדריך הזה מוסבר איך לנפות באגים בהצגת מודעות באמצעות תצוגה מקדימה בתוך האפליקציה והכלי לבדיקת הצגת המודעות.

תצוגה מקדימה בתוך האפליקציה מאפשרת לכם לראות את הקריאייטיבים שלכם כשהם מוצגים באפליקציה לנייד. התצוגה המקדימה הזו שימושית במיוחד לבעלי אפליקציות שיש להם קריאייטיבים שמבצעים אינטראקציה עם האפליקציה, מתנהגים בצורה ייחודית או מסתמכים על האפליקציה לצורך הצגה (כולל קריאייטיבים מובנים ו-MRAID).

כלי הבדיקה של הצגת המודעות מספק מידע על המודעות שהוצגו. אם מודעות לא צפויות מוצגות, אפשר להשתמש בכלי לבדיקת הצגת מודעות כדי לגלות למה.

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

  • גרסה 7.13.1 ואילך של Google Mobile Ads SDK
  • גישה לחשבון Google Ad Manager
  • משלימים את השלב תחילת העבודה.

הכנת האפליקציה

כדי לנפות באגים, צריך לבצע אינטראקציה עם תפריט אפשרויות הניפוי באגים של ה-SDK. הדרך המומלצת לפתוח את התפריט היא לכלול את הפונקציה שבהמשך באפליקציה ולהפעיל אותה על סמך פעולת משתמש:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = DebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

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

קבלת התראה כשתפריט הניפוי באגים נסגר

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

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

מגדירים את בעל/ת הגישה ב-GADDebugOptionsViewController:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

לבסוף, מטמיעים את הפונקציה הנציגה:

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C 

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

אחרי שמוסיפים את היכולת לפתוח את תפריט אפשרויות ניפוי הבאגים, מריצים את האפליקציה ומפעילים את הפונקציה שלמעלה. ייפתח התפריט הבא:

לוחצים על תצוגה מקדימה של קריאייטיב כדי לקשר את המכשיר. הדפדפן ייפתח ותועברו אוטומטית לדפדפן כדי להיכנס ל-Ad Manager. אחרי הכניסה לחשבון, נותנים שם למכשיר כדי לרשום אותו בחשבון Ad Manager ולוחצים על אימות.

Safari

המכשיר שלך קושר בהצלחה! בשלב הזה, אפשר לראות את המכשיר המקושר בממשק הקצה של Ad Manager. אתם יכולים גם לאפשר לאחרים לגשת למכשירים שלכם.

תצוגה מקדימה באפליקציה

פועלים לפי השלבים כדי לדחוף קריאייטיב למכשיר המקושר. מוודאים שהקריאייטיב שהועבר הוא חלק מפריט פעיל לדיווח שמוגדר לטירגוט למיקום המודעה שבו רוצים לראות את הקריאייטיב.

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

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

כלי לבדיקת הצגת מודעות

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