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

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

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

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

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

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

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

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

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

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

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. פותחים דפדפן ועוברים לכתובת ה-URL של יעד המודעה מסורתית.

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

private void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/6499/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.");
}