فرمت‌های تبلیغاتی بومی سفارشی

ناشران Google Ad Manager می توانند با تعریف لیست های سفارشی دارایی ها، قالب های تبلیغاتی بومی خود را ایجاد کنند. این قالب های تبلیغاتی بومی سفارشی را می توان با تبلیغات رزرو شده استفاده کرد. قالب‌های تبلیغات بومی سفارشی ناشران را قادر می‌سازد تا داده‌های رشته‌ای و تصویر دلخواه را به برنامه‌های خود ارسال کنند. این داده توسط یک شی CustomNativeTemplateAd نمایش داده می شود.

قالب‌های تبلیغاتی بومی سفارشی را بارگیری کنید

قالب‌های تبلیغات بومی سفارشی با استفاده از اشیاء AdLoader بارگیری می‌شوند. متد forCustomTemplateAd() AdLoader را پیکربندی می‌کند تا قالب‌های تبلیغات بومی سفارشی را مدیریت کند. هر قالب تبلیغات بومی سفارشی دارای یک مقدار شناسه الگوی مرتبط با آن است. باید شناسه الگوی قالب تبلیغات بومی سفارشی را که برنامه شما می‌خواهد AdLoader درخواست کند، مشخص کنید. شناسه‌های الگو را در رابط کاربری Ad Manager برای شناسه الگوی قالب تبلیغاتی بومی که می‌خواهید درخواست کنید، جستجو کنید.

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

از آنجایی که یک واحد تبلیغاتی را می توان برای ارائه بیش از یک الگوی خلاق تنظیم کرد، forCustomTemplateAd() می توان چندین بار با شناسه های الگوی مختلف فراخوانی کرد تا Adloader برای بیش از یک قالب تبلیغاتی سفارشی سفارشی ممکن آماده شود. قطعه کد زیر نحوه آماده سازی یک AdLoader برای چندین قالب تبلیغات بومی سفارشی نشان می دهد.

void LoadCustomNativeTemplateAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
        .forCustomNativeAd("10063170")
        .forCustomNativeAd("10063171")
        .forCustomNativeAd("10063172")
        .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

رویدادهای تبلیغاتی با قالب تبلیغات بومی سفارشی

کلاس AdLoader رویدادهای تبلیغاتی از نوع EventHandler را ارائه می دهد تا شما را در مورد چرخه عمر قالب تبلیغات بومی سفارشی مطلع کند. مثال زیر نحوه ثبت نام برای رویدادهای تبلیغاتی با قالب تبلیغات بومی سفارشی را نشان می دهد:

adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

متد HandleCustomNativeAdLoaded() حاوی یک پارامتر CustomNativeEventArgs است. قالب تبلیغات بومی سفارشی که بارگیری شده است، از طریق این پارامتر رویداد قابل دسترسی است، همانطور که در زیر نشان داده شده است:

private boolean adLoaded;
private CustomNativeTemplateAd customNativeTemplateAd;
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
    customNativeTemplateAd = args.nativeAd;
    adLoaded = true;
}

نمایش فرمت های تبلیغاتی بومی سفارشی

قالب‌های تبلیغات بومی سفارشی، از هر تعداد دارایی تصویر و متن تعریف شده توسط کاربر پشتیبانی می‌کنند. این دارایی ها از طریق کلاس CustomNativeTemplateAd قابل دسترسی هستند، که متدهای GetTexture2D() و GetText() را ارائه می کند که شناسه متغیر یک فیلد الگو را به عنوان پارامتر در نظر می گیرد.

اجرای مثال زیر دارایی ها را از یک CustomNativeTemplateAd استخراج می کند:

public const int NATIVE_AD_TEMPLATE_1 = 10063170;
public const int NATIVE_AD_TEMPLATE_2 = 10063171;

private boolean adLoaded;
private Texture2d mainImageTexture;
private string headline;
private CustomNativeTemplateAd customNativeTemplateAd;
...

void Update()
{
    if(adLoaded)
    {
        mainImageTexture = customNativeTemplateAd.GetTexture2D("MainImage");
        headline = customNativeTemplateAd.GetText("Headline");

        string templateId = customNativeTemplateAd.GetCustomTemplateId();
        if (templateId == NATIVE_AD_TEMPLATE_1)
        {
            ...
        }
        else if (templateId == NATIVE_AD_TEMPLATE_2)
        {
            ...
        }
        ...
        adLoaded = false;
    }
}
...

void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
    customNativeTemplateAd = args.nativeAd;
    adLoaded = true;
    ...
}

با کلیک‌ها و نمایش‌های قالب آگهی بومی سفارشی مدیریت کنید

با فرمت‌های تبلیغات بومی سفارشی، برنامه شما مسئول ثبت نمایش‌ها و گزارش رویدادهای کلیک به SDK است.

برداشت ها را ثبت کنید

برای ثبت یک نمایش برای یک قالب تبلیغات بومی سفارشی، روش RecordImpression() را در CustomNativeTemplateAd مربوطه فراخوانی کنید:

customNativeTemplateAd.RecordImpression();

گزارش کلیک ها

برای گزارش به SDK مبنی بر اینکه کلیک روی یک دارایی رخ داده است، متد PerformClick() را در CustomNativeTemplateAd مربوطه فراخوانی کنید و نام دارایی روی آن کلیک کنید. به عنوان مثال، اگر دارایی در قالب تبلیغات بومی سفارشی خود به نام «تصویر اصلی» داشته باشید و بخواهید کلیک روی بافتی که با آن دارایی مطابقت دارد گزارش دهید، کد شما به این شکل خواهد بود:

customNativeTemplateAd.PerformClick("MainImage");

هنگامی که کلیکی بر روی یک تبلیغ الگوی سفارشی گزارش می‌شود، دو پاسخ احتمالی از SDK وجود دارد که به ترتیب سعی شده است:

  1. یک حل‌کننده محتوا برای URL پیوند عمیق آگهی پیدا کنید و اولین موردی را که حل می‌شود شروع کنید.
  2. یک مرورگر باز کنید و به آدرس اینترنتی مقصد سنتی تبلیغ بروید.

اعمال کلیک سفارشی

ممکن است تصمیم بگیرید که به جای اینکه کاربر را به یک پیوند عمیق یا مرورگر وب ببرید، خودتان برای قالب‌های تبلیغات بومی سفارشی خود، اقدام به کلیک را انجام دهید. می توانید این کار را با ارائه یک Action<CustomNativeTemplateAd, string> در متد AdLoader.Builder.forCustomTemplateAd() انجام دهید. با تنظیم این عمل کلیک سفارشی، رفتار کلیک SDK که در بالا توضیح داده شد را لغو می کنید. در اینجا یک مثال است که از یک اقدام کلیک سفارشی برای ثبت کلیک برای یک دارایی مشخص استفاده می کند:

private void LoadCustomNativeTemplateAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
        .forCustomNativeAd("10063170", HandleCustomNativeAdClicked)
        .Build();
    adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
    adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
    adLoader.LoadAd(createAdRequest());
}

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