fbAudienceNetwork.init()

类型 函数
返回值
修订 版本 2024.3703
关键词 广告, Facebook Audience Network, fbAudienceNetwork, 初始化
另请参阅 fbAudienceNetwork.load()
fbAudienceNetwork.show()
fbAudienceNetwork.*

概述

fbAudienceNetwork.init() 初始化 Facebook Audience Network。

初始化后,您可以使用 fbAudienceNetwork.load() 加载广告,然后通过 fbAudienceNetwork.show() 显示它。

重要

Facebook 的测试广告调用方法与其他 Corona 广告提供商不同。要在实现此插件期间测试广告,您必须遵循以下要求:

  • 每个测试设备都必须通过设备哈希 ID 在系统中进行初始化。要获取哈希 ID,您必须首先使用 Facebook Audience Network 插件的基本实现构建并将您的应用程序安装在设备上。接下来,调用 fbAudienceNetwork.load()。此时,在设备连接的情况下,应用程序将向设备控制台日志输出类似于以下内容的消息:

测试模式设备哈希:[HASHID]

此设备哈希可以用作下面列出的设备哈希 ID 之一。有关访问设备控制台日志的更多信息,请参阅《调试指南》中的**设备调试**部分。

  • 如果您从设备上卸载/删除您的应用程序,然后再次构建/安装它,Facebook 将生成一个**新的**设备哈希 ID,您必须在代码中更新它。

语法

fbAudienceNetwork.init( adListener [, params] )
adListener (必需)

监听器 将接收 广告请求 事件的监听器函数。

params (可选)

包含其他参数的表 — 有关详细信息,请参阅下一节。

参数参考

params 表包含以下附加参数:

testDevices (可选)

数组 除在设备上测试时外,为可选参数。设备哈希 ID 的数组,例如:{ "deviceID1", "deviceID2" }.

注意
  • 当您准备好分发应用程序或使用真实广告进行测试时,您**不应**将 testDevices 参数传递给此函数。

  • 使用真实广告进行测试是一个两步过程。第一步是在 Facebook 开发者门户 的应用设置中添加测试人员,以便他们在应用获得批准之前可以看到真实广告。第二步是让这些测试人员登录到安装了您的应用的同一设备上的 Facebook 应用。有关更多信息,请参阅此处

advertiserTrackingEnabled (可选)

布尔值 可选。如果设置,将使用该值调用 setAdvertiserTrackingEnabled

示例

local fbAudienceNetwork = require( "plugin.fbAudienceNetwork" )

local function adListener( event )

    if ( event.phase == "init" ) then  -- Successful initialization
        print( event.isError )
    end
end

-- Initialize the Facebook Audience Network
fbAudienceNetwork.init( adListener )