本指南將說明如何使用原生廣告外掛程式,在 Unity 應用程式中導入 AdMob 原生廣告,以及過程中需要考量的重要事項。
原生廣告的格式及功能可融入使用者當下的瀏覽體驗。外觀也更貼近所在應用程式的視覺設計。AdMob 的原生廣告格式可讓發布商顯示與內容密切相關的廣告。您可以使用這項技術實作高度自訂的轉譯內容,充分利用 Unity 應用程式中的原生程式碼。
顯示原生廣告時,會使用您已建構應用程式的相同 GameObjects
類型,而且可以根據廣告所在環境的視覺設計調整格式。載入原生廣告時,應用程式會收到內含其素材資源的原生物件,且 Unity 應用程式 (而非 SDK) 會顯示這些物件。
先備知識
載入原生廣告格式
原生廣告會透過 AdLoader
類別載入,該類別具備專屬的 AdLoader.Builder
類別,可在建立期間自訂。ForNativeAd()
方法會設定 AdLoader 來處理原生廣告。
private void RequestNativeAd() {
AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
.ForNativeAd()
.Build();
}
註冊 AdLoader 廣告事件
如要在原生廣告成功載入或無法載入時收到通知,請在 AdLoader
類別中新增下列事件的委派項目。
OnNativeAdLoaded
在成功載入原生廣告時叫用。此事件必須具備此事件的委派,才能存取載入的廣告。
OnAdFailedToLoad
在原生廣告無法載入時叫用。
載入廣告
建立 AdLoader
後,請呼叫其 LoadAd()
方法以請求廣告:
adLoader.LoadAd(new AdRequest.Builder().Build());
將廣告請求放在一起
下列程式碼片段示範如何建構 AdLoader
,以要求原生廣告、設定委派代表成功和失敗的廣告載入,以及發出廣告請求。
private void RequestNativeAd() {
AdLoader adLoader = new AdLoader.Builder(INSERT_AD_UNIT_HERE)
.ForNativeAd()
.Build();
adLoader.OnNativeAdLoaded += this.HandleNativeAdLoaded;
adLoader.OnAdFailedToLoad += this.HandleAdFailedToLoad;
adLoader.LoadAd(new AdRequest.Builder().Build());
}
處理失敗的廣告載入
OnAdFailedToLoad
事件的類型為 EventHandle<AdFailedToLoadEventArgs>
。下方顯示剖析這個事件中廣告載入失敗的原因。
private void RequestNativeAd() {
...
adLoader.OnAdFailedToLoad += this.HandleNativeAdFailedToLoad;
}
private void HandleNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) {
Debug.Log("Native ad failed to load: " + args.Message);
}
顯示原生廣告
載入原生廣告時,系統會叫用對應廣告格式的廣告事件。 這樣一來,您的應用程式就會負責顯示廣告,但不一定要立即執行。
處理廣告載入量
OnNativeAdLoaded
事件的類型為 EventHandler<NativeAdEventArgs>
。封裝在 NativeAd
物件中的廣告可從 NativeAdEventArgs
擷取,如下所示:
private NativeAd nativeAd;
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
}
擷取原生廣告素材資源
廣告載入完畢後,您可以按照下列步驟存取其素材資源。圖形資產會傳回 Texture2D
物件,文字資產會傳回 string
物件。
private bool nativeAdLoaded;
private NativeAd nativeAd;
void Update() {
...
if (this.nativeAdLoaded) {
this.nativeAdLoaded = false;
// Get Texture2D for the icon asset of native ad.
Texture2D iconTexture = this.nativeAd.GetIconTexture();
// Get string for headline asset of native ad.
string headline = this.nativeAd.GetHeadlineText();
}
}
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
this.nativeAdLoaded = true;
}
請注意,廣告素材資源只能在主執行緒上存取,例如透過 Unity 指令碼的 Update()
方法存取。此外也請注意,我們不保證一定會顯示下列素材資源,在顯示前應先進行檢查:
GetStarRating()
GetStore()
GetPrice()
GetAdvertiser()
GetIconTexture()
AdChoices 素材資源
這是在原生廣告中顯示 AdChoices 廣告素材資源的規定。 此外,AdChoices 廣告素材資源必須清晰易讀,因此請務必選擇適當的背景顏色和圖片。
註冊 GameObjects 以提供廣告素材資源
您必須註冊 GameObject
,廣告素材資源才能在 Unity 應用程式中顯示。如果註冊成功,註冊 GameObject
的方法就會傳回 bool
。如果是 List<GameObject>
,這個方法會傳回 int
,指出已成功註冊的 GameObject
計數。
如果廣告素材資源註冊失敗,系統將無法辨識對應原生廣告的曝光和點擊次數。
if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
// Handle failure to register the icon ad asset.
}
註冊廣告素材資源的 GameObject
必須包含可代表 GameObject
大小和形狀的凸合器元件。如果註冊廣告素材資源的 GameObject
物件缺少 Collider
元件或設定錯誤,原生廣告將無法正常運作。
在下方的程式碼片段中,BoxCollider
會加入 GameObject
,並使用 TextMesh
顯示原生廣告的廣告標題廣告素材資源。將 BoxCollider
附加至 GameObject
後,系統會自動縮放,以符合 TextMesh
元件的文字。
// Create GameObject that will display the headline ad asset.
GameObject headline = new GameObject();
headline.AddComponent<TextMesh>();
headline.GetComponent<TextMesh>().characterSize = 0.5 f;
headline.GetComponent<TextMesh>().anchor = TextAnchor.MiddleCenter;
headline.GetComponent<TextMesh>().color = Color.black;
// Get string of the headline asset.
string headlineText = this.nativeAd.GetHeadlineText();
headline.GetComponent<TextMesh>().text = headlineText;
// Add box collider to the GameObject which will automatically scale.
headline.AddComponent<BoxCollider>();
操作示範
以下程式碼示範如何擷取成功載入的原生廣告圖示素材資源、設定 Quad
的紋理以顯示圖示廣告素材資源,並註冊 GameObject
以顯示素材資源。針對應用程式顯示的每項素材資源,擷取廣告素材資源並註冊至原生廣告類別的程序應重複。
private GameObject icon;
private bool nativeAdLoaded;
private NativeAd nativeAd;
...
void Update() {
...
if (this.nativeAdLoaded) {
this.nativeAdLoaded = false;
// Get Texture2D for icon asset of native ad.
Texture2D iconTexture = this.nativeAd.GetIconTexture();
icon = GameObject.CreatePrimitive(PrimitiveType.Quad);
icon.transform.position = new Vector3(1, 1, 1);
icon.transform.localScale = new Vector3(1, 1, 1);
icon.GetComponent<Renderer>().material.mainTexture = iconTexture;
// Register GameObject that will display icon asset of native ad.
if (!this.nativeAd.RegisterIconImageGameObject(icon))
{
// Handle failure to register ad asset.
}
}
}
...
private void HandleNativeAdLoaded(object sender, NativeAdEventArgs args) {
Debug.Log("Native ad loaded.");
this.nativeAd = args.nativeAd;
this.nativeAdLoaded = true;
}