Facebook聚合指南 - uc-union/union-ads-sdk-demo GitHub Wiki

介绍

详见Facebook官网

接入指南

Android Studio / Gradle (强烈推荐)

build.gradle中的project配置中加入repositories信息,可以参考 build.gradle

repositories {
    mavenCentral()
}

注意:对于中国境内的开发者,如果连接官方maven的速度较慢,可以考虑使用国内的镜像资源,如 开源中国Maven库

添加dependencies依赖(通常是在app/build.gradle中定义),可以参考 app/build.gradle

dependencies {
    'com.facebook.android:audience-network-sdk:4.+'
}

还需要在AndroidManifest.xml中添加下述内容,可以参考 AndroidManifest.xml

<application android:label="@string/app_name">
    ...
    <activity android:name="com.facebook.ads.InterstitialAdActivity"
        android:configChanges="keyboardHidden|orientation|screenSize" />
</application>

Eclipse

注意: 如果开发者是使用Android Studio,可以跳过本节

下载Facebook Audience Network SDK

NOTE: Facebook Audience Network SDK均采用aar格式

Facebook官网的下载页面下载对应的SDK

百度云盘分流: 点击下载

植入SDK到eclipse工程

AudienceNetwork.aar在本地解压,得到如下目录结构

AudienceNetwork.aar
    |--(目录)
    |--AndroidManifest.xml
    |--proguard.txt
    |--classes.jar

并按照下述步骤操作:

  1. classes.jar改名成facebookads.jar并放到libs目录中

  2. proguard.txt的内容合并到应用开发者自己工程的proguard.pro

  3. AndroidManifest.xml中添加下述内容

    <!-- Include required permissions -->
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    
    <application android:label="@string/app_name">
        ...
        <activity android:name="com.facebook.ads.InterstitialAdActivity"
            android:configChanges="keyboardHidden|orientation|screenSize" />
    </application>

测试

展示广告

Facebook广告展示是有前提要求的,请务必确保设备满足下述要求:

  1. 设备中安装了Facebook客户端

  2. 在Facebook客户端中登录了一个Facebook帐号

展示测试广告

Facebook有提供测试用的广告,当在模拟器上运行时,将默认展示测试广告;要在设备上启动测试广告,只需在广告请求加上HASH_ID,代码如下:

AdRequest request =
    AdRequest.newBuilder().testDeviceId("YOUR_HASH_ID").put("YOUR_PUB").build();

其中YOUR_HASH_ID可以用测试设备运行目标应用,在每次加载Facebook广告时,会在日志(logcat)打印出来,如下图红框部分:

facebook-test-device-id

测试广告截图

如果一切顺利,测试广告会如下面截图所示:

  • 横幅广告

    facebook-test-banner-example

  • 插屏广告

    facebook-test-interstitial-example

后续步骤

⚠️ **GitHub.com Fallback** ⚠️