פורמטים מותאמים אישית של מודעות מותאמות

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

טעינה של מודעה מותאמת אישית

מודעות מותאמות בהתאמה אישית נטענות באמצעות אובייקטים מסוג AdLoader. השיטה ForCustomNativeAd() מגדירה את AdLoader לטיפול במודעות מותאמות אישית. יש שני פרמטרים לשיטה הזו:

  • הformatId של המודעה המותאמת אישית שAdLoader צריך לשלוח בקשה להצגתה. לכל פורמט מותאם אישית של מודעה מותאמת יש ערך של מזהה פורמט שמשויך אליו. הפרמטר הזה מציין את הפורמט שהאפליקציה רוצה לבקש מ-AdLoader.
  • ‫Action<CustomNativeAd, string> אופציונלי שמופעל כשמשתמש לוחץ על המודעה.

מודעות מותאמות אישית שמוצגות באופן טבעי נטענות דרך המחלקה AdLoader, שיש לה מחלקה משלה AdLoader.Builder להתאמה אישית במהלך היצירה. השיטה ForCustomNativeAd() מגדירה את AdLoader לטיפול במודעות מותאמות.

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170")
            .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

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

אירועים מותאמים אישית של מודעות מותאמות

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

private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

השיטה HandleCustomNativeAdLoaded() מכילה פרמטר CustomNativeAdEventArgs. אפשר לגשת למודעה המותאמת שהוטענה דרך פרמטר האירוע הזה, כמו שמוצג בהמשך:

void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    this.customNativeAd = args.nativeAd;
}

השיטה HandleCustomNativeAdFailedToLoad() מכילה את הפרמטר AdFailedToLoadEventArgs. אפשר לגשת להודעת השגיאה על ידי קריאה למתודה GetMessage בשדה LoadAdError, כמו שמוצג בהמשך:

void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    string message = args.LoadAdError.GetMessage();
    Debug.Log("Ad Loader fail event received with message: " + message);
}

הצגת פורמטים מותאמים אישית של מודעות מותאמות

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

הנה דוגמה להטמעה שבה מתבצעת גישה לנכסים ממודעה מותאמת אישית:

private bool adLoaded;
private Texture2D mainImageTexture;
private string headline;
private CustomNativeAd customNativeAd;
...

void Update()
{
    if(adLoaded)
    {
        mainImageTexture = customNativeAd.GetTexture2D("MainImage");
        headline = customNativeAd.GetText("Headline");
        adLoaded = false;
    }
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    customNativeAd = args.nativeAd;
    adLoaded = true;
    ...
}

טיפול בחשיפות ובקליקים של מודעות מותאמות מותאמות

כשמשתמשים במודעה מותאמת מותאמת, האפליקציה אחראית לתיעוד החשיפות ולדיווח על אירועי קליקים ל-SDK.

תיעוד חשיפות

כדי לתעד חשיפה של מודעה בהתאמה אישית, מפעילים את השיטה RecordImpression() באובייקט CustomNativeAd המתאים:

customNativeAd.RecordImpression();

קליקים על דוחות

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

customNativeAd.PerformClick("MainImage");

תגובה לפעולות מותאמות אישית של קליקים

כשמדווח על קליק במודעה בהתאמה אישית, התגובות האפשריות מ-SDK הן בסדר הזה:

  1. מאתרים את רכיב התוכן לפתרון בעיות של כתובת ה-URL של קישור העומק של המודעה ומתחילים את הראשון שפותר את הבעיה.

  2. פותחים דפדפן ועוברים לכתובת היעד הרגילה של המודעה.

אם אתם רוצים לטפל בעצמכם בפעולת הקליק בפורמטים של מודעות מותאמות אישית במקום להעביר את המשתמש לקישור עומק או לדפדפן אינטרנט, אתם יכולים לספק Action<CustomNativeAd, string> אופציונלי בשיטה AdLoader.Builder.ForCustomNativeAd(). הגדרתם פעולת לחיצה מותאמת אישית, ולכן אתם מבטלים את התנהגות הלחיצה של ה-SDK. הנה דוגמה לשימוש בפעולת לחיצה בהתאמה אישית כדי לתעד לחיצה על נכס נתון:

private void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170", HandleCustomNativeAdClicked)
            .Build();
    adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
    adLoader.LoadAd(createAdRequest());
}

private void HandleCustomNativeAdClicked(CustomNativeAd customNativeAd, string assetName)
{
    Debug.Log("Custom Native ad asset with name " + assetName + " was clicked.");
}