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

בעלי תוכן דיגיטלי ב-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() כמה פעמים עם מזהי פורמט שונים כדי להכין את ה-loader של המודעות לכמה פורמטים אפשריים של מודעות רגילות בהתאמה אישית.

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

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

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.");
}