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

בעלי אתרים ב-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. מאתרים את רכיב ה-Content Resolver של כתובת ה-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.");
}