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

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

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

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

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

ה-method‏ 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.

חשיפות של הקלטות

כדי לתעד חשיפה של מודעה מותאמת אישית, צריך להפעיל את ה-method‏ RecordImpression() ב-CustomNativeAd המתאים:

customNativeAd.RecordImpression();

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

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

customNativeAd.PerformClick("MainImage");

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

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

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

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

אם אתם רוצים לטפל בעצמכם בפעולת הקליק על פורמטים מותאמים אישית של מודעות מותאמות, במקום להעביר את המשתמש לקישור עומק או לדפדפן אינטרנט, אתם יכולים לספק Action<CustomNativeAd, string> אופציונלי ב-method‏ 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.");
}