תבניות של מודעות מותאמות

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

הורדת תבניות מקוריות

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

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

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

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

גודלי תבניות

יש שני גדלים של תבניות: קטן ובינוני. כל תבנית מיוצגת על ידי מחלקה. הכיתות הן GADTSmallTemplateView ו-GADTMediumTemplateView. שתי המחלקות מרחיבות את GADTTemplateView. לשני התבניות יש יחס גובה-רוחב קבוע, והן יותאמו כדי למלא את הרוחב של תצוגות האב שלהן רק אם תפעילו את הפונקציה addHorizontalConstraintsToSuperviewWidth. אם לא קוראים ל-addHorizontalConstraintsToSuperviewWidth, כל תבנית תעבד את גודל ברירת המחדל שלה.

GADTSmallTemplateView

התבנית הקטנה מתאימה לתאים בגודל UICollectionView או UITableView. לדוגמה, אפשר להשתמש בו למודעות בגוף הפיד או בכל מקום שבו צריך תצוגה של מודעה מלבנית דקה. גודל ברירת המחדל של התבנית הזו הוא 91 נקודות גובה ו-355 נקודות רוחב.

GADTMediumTemplateView

תבנית המודעה בגודל בינוני מיועדת להצגה ב-1/2 עד 3/4 מהדף. האפשרות הזו מתאימה לדפי נחיתה או לדפי פתיחה, אבל אפשר לכלול אותה גם ב-UITableViews. גודל ברירת המחדל של התבנית הזו הוא 370 נקודות גובה ו-355 נקודות רוחב.

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

התקנת תבניות של מודעות מותאמות

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

שימוש בתבניות של מודעות מותאמות

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

Objective-C

/// Step 1: Import the templates that you need.
#import "NativeTemplates/GADTSmallTemplateView.h"
#import "NativeTemplates/GADTTemplateView.h"
...

// STEP 2: Initialize your template view object.
GADTSmallTemplateView *templateView =
    [[NSBundle mainBundle] loadNibNamed:@"GADTSmallTemplateView" owner:nil options:nil]
      .firstObject;

// STEP 3: Template views are just GADNativeAdViews.
_nativeAdView = templateView;
nativeAd.delegate = self;

// STEP 4: Add your template as a subview of whichever view you'd like.
// This must be done before calling addHorizontalConstraintsToSuperviewWidth.
// Please note: Our template objects are subclasses of GADNativeAdView so
// you can insert them into whatever type of view youd like, and dont need to
// create your own.
[self.view addSubview:templateView];

// STEP 5 (Optional): Create your styles dictionary. Set your styles dictionary
// on the template property. A default dictionary is created for you if you do
// not set this. Note - templates do not currently respect style changes in the
// xib.

NSString *myBlueColor = @"#5C84F0";
NSDictionary *styles = @{
    GADTNativeTemplateStyleKeyCallToActionFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyCallToActionFontColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyCallToActionBackgroundColor :
        [GADTTemplateView colorFromHexString:myBlueColor],
    GADTNativeTemplateStyleKeySecondaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeySecondaryFontColor : UIColor.grayColor,
    GADTNativeTemplateStyleKeySecondaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyPrimaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyPrimaryFontColor : UIColor.blackColor,
    GADTNativeTemplateStyleKeyPrimaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyTertiaryFont : [UIFont systemFontOfSize:15.0],
    GADTNativeTemplateStyleKeyTertiaryFontColor : UIColor.grayColor,
    GADTNativeTemplateStyleKeyTertiaryBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyMainBackgroundColor : UIColor.whiteColor,
    GADTNativeTemplateStyleKeyCornerRadius : [NSNumber numberWithFloat:7.0],
};

templateView.styles = styles;

// STEP 6: Set the ad for your template to render.
templateView.nativeAd = nativeAd;

// STEP 7 (Optional): If you'd like your template view to span the width of your
// superview call this method.
[templateView addHorizontalConstraintsToSuperviewWidth];
[templateView addVerticalCenterConstraintToSuperview];

מפתחות של מילון סגנונות

הדרך הכי מהירה להתאים אישית את התבניות היא ליצור מילון עם המפתחות הבאים:

Objective-C

/// Call to action font. Expects a UIFont.
GADTNativeTemplateStyleKeyCallToActionFont

/// Call to action font color. Expects a UIColor.
GADTNativeTemplateStyleKeyCallToActionFontColor;

/// Call to action background color. Expects a UIColor.
GADTNativeTemplateStyleKeyCallToActionBackgroundColor;

/// The font, font color and background color for the first row of text in the
/// template.

/// All templates have a primary text area which is populated by the native ad's
/// headline.

/// Primary text font. Expects a UIFont.
GADTNativeTemplateStyleKeyPrimaryFont;

/// Primary text font color. Expects a UIFont.
GADTNativeTemplateStyleKeyPrimaryFontColor;

/// Primary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeyPrimaryBackgroundColor;

/// The font, font color and background color for the second row of text in the
/// template.

/// All templates have a secondary text area which is populated either by the
/// body of the ad, or by the rating of the app.

/// Secondary text font. Expects a UIFont.
GADTNativeTemplateStyleKeySecondaryFont;

/// Secondary text font color. Expects a UIColor.
GADTNativeTemplateStyleKeySecondaryFontColor;

/// Secondary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeySecondaryBackgroundColor;

/// The font, font color and background color for the third row of text in the
/// template. The third row is used to display store name or the default
/// tertiary text.

/// Tertiary text font. Expects a UIFont.
GADTNativeTemplateStyleKeyTertiaryFont;

/// Tertiary text font color. Expects a UIColor.
GADTNativeTemplateStyleKeyTertiaryFontColor;

/// Tertiary text background color. Expects a UIColor.
GADTNativeTemplateStyleKeyTertiaryBackgroundColor;

/// The background color for the bulk of the ad. Expects a UIColor.
GADTNativeTemplateStyleKeyMainBackgroundColor;

/// The corner rounding radius for the icon view and call to action. Expects an
/// NSNumber.
GADTNativeTemplateStyleKeyCornerRadius;

שאלות נפוצות

למה מופיעה חריגה כשמנסים ליצור מופע של אובייקט התבנית?
זה יכול לקרות אם שיניתם את גודל התצוגה בקובץ ה-xib אבל לא שיניתם את גודל המסגרת שנוצרה בשיטת ההגדרה של מחלקת המשנה.
איך אפשר להתאים אישית את התבניות האלה?
התבניות האלה הן רק קובצי xib עם אובייקטים משויכים של תצוגה, כמו כל קובץ xib ומחלקת תצוגה מותאמת אחרים שאולי אתם מכירים מפיתוח ל-iOS. אם אתם מעדיפים ליצור מודעות מותאמות מאפס, תוכלו לעיין במדריך שלנו בנושא מודעות מותאמות מסוג Advanced.
למה הסגנונות שלי לא מתעדכנים כשאני מגדיר אותם ב-xib?
כרגע אנחנו מבטלים את כל סגנונות ה-xib באמצעות מילון סגנונות ברירת המחדל ב- GADTTemplateView.m.

הוספת תוכן

יצרנו תבניות מותאמות כדי לעזור לכם לפתח מודעות מותאמות במהירות. נשמח אם תשתתפו בפרויקט שלנו ב-GitHub ותוסיפו תבניות או תכונות חדשות. אפשר לשלוח לנו pull request ואנחנו נבדוק אותו.