Audience Network Unity SDK操作指南

前提條件

要求使用Unity 5.0或以上版本。

確保已安裝最新的工具：

Unity

Xcode

Android Studio

在Unity應(yīng)用中添加Audience Network廣告

第1步：下載Audience Network Unity SDK

第2步：創(chuàng)建和設(shè)置Audience Network Unity示例項(xiàng)目

第3步：通過Unity項(xiàng)目構(gòu)建iOS應(yīng)用

第4步：通過Unity項(xiàng)目構(gòu)建Android應(yīng)用

第1步：下載Audience Network SDK

Audience Network Unity SDK是Unity版Facebook SDK的一部分。若要開始，請(qǐng)下載和解壓縮Unity版Facebook SDK。

第2步：創(chuàng)建和設(shè)置Audience Network Unity示例項(xiàng)目

安裝Unity及下載最新的Audience Network Unity SDK后，可打開Unity應(yīng)用創(chuàng)建示例項(xiàng)目。

打開Unity應(yīng)用，將項(xiàng)目命名為AudienceNetworkUnityTutorial，然后設(shè)置項(xiàng)目存儲(chǔ)位置。

在Unity編輯器中，從菜單中依次選擇Assets（素材）、Import Package（導(dǎo)入包）和Custom Package…（自定義包...），然后從AudienceNetworkSDK文件夾選擇audience-network-unity-sdk.unitypackagee，將插件導(dǎo)入項(xiàng)目中。

導(dǎo)入Audience Network SDK后，可通過Project（項(xiàng)目）面板瀏覽SDK內(nèi)容，如下所示：

在Unity編輯器項(xiàng)目面板中，應(yīng)看到在Assets文件夾下創(chuàng)建的AudienceNetwork文件夾。打開Samples（示例）文件夾，您會(huì)看到Unity場(chǎng)景文件AdViewScene、InterstitialAdScene、RewardedVideolAdScene和NativeAdScene。AdViewTest.cs、InterstitialAdTest.cs、RewardedVideoAdTest.cs和NativeAdTest.cs是cs文件，用于調(diào)用Audience Network API來請(qǐng)求和加載廣告內(nèi)容。

雙擊打開AdViewTest.cs并搜索YOUR_PLACEMENT_ID。您會(huì)看到以下調(diào)用。

AdView adView=new AdView("YOUR_PLACEMENT_ID",AdSize.BANNER_HEIGHT_50);</code>將YOUR_PLACEMENT_ID替換為您自己的版位編號(hào)字符串。如果沒有版位編號(hào)或不知道如何獲取，請(qǐng)參閱入門指南。針對(duì)InterstitialAdTest.cs、RewardedVideoAdTest.cs和NativeAdTest.cs重復(fù)此步驟。

雙擊NativeAdScene，然后點(diǎn)擊頂部面板的Play（播放）按鈕，默認(rèn)情況下，可看到Audience Network測(cè)試廣告，如下所示：

第3步：通過Unity項(xiàng)目構(gòu)建iOS應(yīng)用

創(chuàng)建與Audience Network Unity SDK集成的Unity示例項(xiàng)目后，請(qǐng)繼續(xù)學(xué)習(xí)如何創(chuàng)建可顯示Facebook Audience Network廣告的iOS應(yīng)用。

請(qǐng)參閱常見問題，了解Audience Network SDK支持的最低操作系統(tǒng)版本。

在Samples文件夾中雙擊AdViewScene，然后選擇File（文件）->Build Settings（構(gòu)建設(shè)置）。在Scenes In Build（待構(gòu)建場(chǎng)景）窗口中點(diǎn)擊Add Open Scenes（添加開放場(chǎng)景）按鈕，然后選擇AudienceNetwork/Samples/AdViewScene。對(duì)InterstitialAdScene、RewardedVideoAdScene和NativeAdScene重復(fù)此步驟，如下所示：

選擇iOS平臺(tái)，然后點(diǎn)擊Build And Run（構(gòu)建并運(yùn)行）。創(chuàng)建iOS示例項(xiàng)目需要幾秒鐘。

通過Unity構(gòu)建Xcode項(xiàng)目后，打開該項(xiàng)目。點(diǎn)擊項(xiàng)目文件，從Targets（目標(biāo)）菜單選擇構(gòu)建目標(biāo)。檢查是否擁有有效捆綁標(biāo)識(shí)符，如下所示：

[C#]純文本查看復(fù)制代碼

Note that XCode will create a bundle identifier for your project.In this example,the bundle identifier is com.yourcompany.AudienceNetworkTutorial.You will use this bundle identifier later when you submit your app for approval as explained in Submit For Review.

Unity原生插件不提供用于添加要關(guān)聯(lián)到iOS項(xiàng)目的依賴庫的API。您會(huì)看到以下構(gòu)建錯(cuò)誤：

[C#]純文本查看復(fù)制代碼

Undefined symbols for architecture arm64:

"_xmlXPathFreeObject",referenced from:lxml::xpath::object::object(_xmlXPathObject*)in FBAudienceNetwork(FNFMediaPresentationDescription.o)

若要修復(fù)上述構(gòu)建錯(cuò)誤，您需要在項(xiàng)目的Build Settings（構(gòu)建設(shè)置）頁面中將“-lxml2”添加到“Other Linker Flags”（其他關(guān)聯(lián)工具標(biāo)記），如下所示：

將StoreKit.framework添加到Linked Frameworks and Libraries（關(guān)聯(lián)的框架和庫），如下所示：

選擇設(shè)備作為構(gòu)建目標(biāo)，構(gòu)建并運(yùn)行項(xiàng)目。您可以看到通過Unity構(gòu)建的應(yīng)用顯示Audience Network廣告，如下所示：

第4步：通過Unity項(xiàng)目構(gòu)建Android應(yīng)用

Audience Network SDK支持的最低Android操作系統(tǒng)版本是Android SDK的API版本11。

在Samples文件夾中雙擊AdViewScene，然后選擇File（文件）->Build Settings（構(gòu)建設(shè)置）。在Scenes In Build（待構(gòu)建場(chǎng)景）窗口中點(diǎn)擊Add Open Scenes（添加開放場(chǎng)景）按鈕，然后選擇AudienceNetwork/Samples/AdViewScene。對(duì)InterstitialAdScene、RewardedVideoAdScene和NativeAdScene重復(fù)此步驟，如下所示：

選擇Android平臺(tái)，然后選擇Google Android Project（Google Android項(xiàng)目）和Development Build（開發(fā)構(gòu)建）選項(xiàng)。

點(diǎn)擊Player Settings（播放器設(shè)置）。在Other Settings（其他設(shè)置）->Identification（標(biāo)識(shí)）->Version（版本）中，選擇“Android 4.1'Jelly Bean'(API level 11)”（Android 4.1“Jelly Bean”[API級(jí)別11]）。

選擇Gradle(New)（Gradle[新版]），用于構(gòu)建系統(tǒng)。點(diǎn)擊Build and Run（構(gòu)建并運(yùn)行）。創(chuàng)建Android示例項(xiàng)目需要幾秒鐘。

不再支持內(nèi)部Unity版本。應(yīng)使用Gradle完成構(gòu)建版本。（在Build Settings[構(gòu)建設(shè)置]中，選擇Build System[構(gòu)建系統(tǒng)]）

打開Android Studio，選擇Import project（導(dǎo)入項(xiàng)目）。

找到Unity構(gòu)建的Android項(xiàng)目，構(gòu)建Gradle項(xiàng)目。

使用Android Studio創(chuàng)建gradle項(xiàng)目后，打開AndroidManifest.xml并添加下列元素（如缺失）：

<activity android:name="com.facebook.ads.AudienceNetworkActivity"android:configChanges="keyboardHidden|orientation|screenSize"/>

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

選擇Android設(shè)備作為Deployment Target（部署目標(biāo)）。您可以看到通過Unity構(gòu)建的應(yīng)用顯示Audience Network廣告，如下所示：

后續(xù)步驟

提交應(yīng)用供審核。

我們收到您的應(yīng)用或網(wǎng)站對(duì)某條廣告的請(qǐng)求時(shí)，將對(duì)廣告進(jìn)行審核，確保其符合Audience Network政策和Facebook社區(qū)守則。詳細(xì)了解Facebook的審核流程。