Nhà xuất bản Google Ad Manager có thể tạo các định dạng quảng cáo gốc riêng bằng cách xác định danh sách tuỳ chỉnh về các thành phần. Bạn có thể sử dụng
các định dạng quảng cáo gốc tuỳ chỉnh
này cùng với quảng cáo đặt trước. Định dạng quảng cáo gốc tuỳ chỉnh cho phép nhà xuất bản chuyển dữ liệu chuỗi và hình ảnh tuỳ ý đến ứng dụng của họ. Dữ liệu này do một đối tượng CustomNativeTemplateAd biểu thị.
Tải các định dạng quảng cáo gốc tuỳ chỉnh
Bạn có thể tải các định dạng quảng cáo gốc tuỳ chỉnh bằng cách sử dụng đối tượng AdLoader.
Phương thức forCustomTemplateAd() định cấu hình AdLoader để xử lý các định dạng quảng cáo gốc tuỳ chỉnh. Mỗi định dạng quảng cáo gốc tuỳ chỉnh đều được liên kết với một giá trị mã nhận dạng mẫu. Bạn phải chỉ định mã nhận dạng mẫu của định dạng quảng cáo gốc tuỳ chỉnh mà ứng dụng của bạn muốn AdLoader yêu cầu.
Hãy tìm mã nhận dạng mẫu trong giao diện người dùng Ad Manager để biết mã nhận dạng mẫu của định dạng quảng cáo gốc mà bạn muốn yêu cầu.
void LoadCustomNativeTemplateAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.forCustomNativeAd("10063170")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
Bởi vì một đơn vị quảng cáo có thể được thiết lập để phân phát nhiều mẫu quảng cáo,
nên forCustomTemplateAd() có thể được gọi nhiều lần bằng các mã nhận dạng mẫu khác nhau
để chuẩn bị Adloader cho nhiều định dạng quảng cáo gốc tuỳ chỉnh.
Đoạn mã bên dưới minh hoạ cách chuẩn bị AdLoader cho nhiều mẫu định dạng quảng cáo gốc tuỳ chỉnh.
void LoadCustomNativeTemplateAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.forCustomNativeAd("10063170")
.forCustomNativeAd("10063171")
.forCustomNativeAd("10063172")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
Sự kiện quảng cáo có định dạng quảng cáo gốc tuỳ chỉnh
Lớp AdLoader cung cấp các sự kiện quảng cáo thuộc loại EventHandler để thông báo cho bạn về vòng đời của một định dạng quảng cáo gốc tuỳ chỉnh.
Ví dụ bên dưới minh hoạ cách đăng ký các sự kiện quảng cáo có định dạng quảng cáo gốc tuỳ chỉnh:
adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
Phương thức HandleCustomNativeAdLoaded() chứa tham số CustomNativeEventArgs.
Bạn có thể truy cập định dạng quảng cáo gốc tuỳ chỉnh đã tải thông qua thông số sự kiện này, như minh hoạ dưới đây:
private boolean adLoaded;
private CustomNativeTemplateAd customNativeTemplateAd;
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
customNativeTemplateAd = args.nativeAd;
adLoaded = true;
}
Hiển thị định dạng quảng cáo gốc tuỳ chỉnh
Các định dạng quảng cáo gốc tuỳ chỉnh hỗ trợ tài sản văn bản và hình ảnh do người dùng xác định với số lượng bất kỳ. Các thành phần này có thể truy cập được thông qua lớp CustomNativeTemplateAd, trong đó cung cấp các phương thức GetTexture2D() và GetText() để lấy mã nhận dạng biến của trường mẫu làm thông số.
Quy trình triển khai mẫu sau trích xuất tài sản từ 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;
...
}
Xử lý các lượt nhấp và lượt hiển thị của định dạng quảng cáo gốc tuỳ chỉnh
Với định dạng quảng cáo gốc tuỳ chỉnh, ứng dụng của bạn chịu trách nhiệm ghi lại các lượt hiển thị và báo cáo các sự kiện nhấp chuột cho SDK.
Ghi lại số lượt hiển thị
Để ghi lại một lượt hiển thị cho một định dạng quảng cáo gốc tuỳ chỉnh, hãy gọi phương thức RecordImpression() trên CustomNativeTemplateAd tương ứng:
customNativeTemplateAd.RecordImpression();
Báo cáo lượt nhấp
Để báo cáo cho SDK biết rằng một lượt nhấp đã xảy ra trên một thành phần, hãy gọi phương thức PerformClick() trên CustomNativeTemplateAd tương ứng và truyền tên của thành phần được nhấp vào. Ví dụ: nếu bạn có một thành phần trong định dạng quảng cáo gốc tuỳ chỉnh có tên là "MainImage" và muốn báo cáo một lượt nhấp vào cấu trúc tương ứng với thành phần đó, thì mã của bạn sẽ trông giống như sau:
customNativeTemplateAd.PerformClick("MainImage");
Khi một lượt nhấp được báo cáo trên một quảng cáo mẫu tuỳ chỉnh, SDK có thể có 2 phản hồi theo thứ tự sau:
- Tìm trình phân giải nội dung cho URL liên kết sâu của quảng cáo và bắt đầu phân giải nội dung đầu tiên.
- Mở một trình duyệt rồi chuyển đến URL đích thường dùng của quảng cáo đó.
Hành động nhấp tuỳ chỉnh
Bạn có thể quyết định rằng bạn muốn tự xử lý hành động nhấp cho các định dạng quảng cáo gốc tuỳ chỉnh
thay vì đưa người dùng đến một đường liên kết sâu hoặc trình duyệt web. Bạn có thể thực hiện việc này bằng cách cung cấp một Action<CustomNativeTemplateAd, string> (không bắt buộc) trong phương thức AdLoader.Builder.forCustomTemplateAd(). Khi
đặt hành động nhấp tuỳ chỉnh này, bạn sẽ ghi đè hành vi nhấp của SDK được mô tả ở trên.
Dưới đây là ví dụ về cách sử dụng hành động nhấp tuỳ chỉnh để ghi lại một lượt nhấp cho một thành phần cụ thể:
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.");
}