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

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

תצוגה מקדימה בתוך האפליקציה מאפשרת לכם לראות את הקריאייטיבים שלכם כשהם מוצגים באפליקציה לנייד. התצוגה המקדימה הזו שימושית במיוחד לבעלי אפליקציות שיש להם קריאייטיבים שמבצעים אינטראקציה עם האפליקציה, מתנהגים בצורה ייחודית או מסתמכים על האפליקציה לצורך הצגה (כולל קריאייטיבים מובנים ו-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.");
}

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

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

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

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

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

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

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

מפקח הצגת המודעות

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