appodeal.*

类型库

修订版 版本 2024.3703

关键字 广告、广告宣传、Appodeal

平台 Android、iOS

概述

Appodeal 插件允许开发者使用 Appodeal 横幅广告、静态插页广告、视频插页广告以及奖励式视频广告使自己的移动应用盈利。

重要

请注意，目前在 Amazon 商店中构建插件受到限制。我们正在致力于合适的 SDK/插件更新，以便将包含 Appodeal 模块化插件的应用发布到 Amazon 商店，发布功能应尽快提供。

重要

Appodeal 包含各种 SDK，用于其进行调解的广告提供者。这意味着你无法将 Appodeal 与 AdColony、AppLovin、AdMob、Chartboost、Facebook 受众网络、Flurry Analytics、InMobi、Unity Ads 或 Vungle 结合使用。

重要

Appodeal 插件的 Beta 版现已推出！查看“项目设置”部分中的最新说明，了解详情。

版本信息

当前插件版本为

稳定版插件对于 Android 和 iOS 而言均为 3.4.0。

重要

查看新的 hasUserConsent 初始化参数，以启用 GDPR 数据收集限制。

注册

在使用此插件之前，你必须在 Appodeal 进行注册。

语法

local appodeal = require( "plugin.appodeal" )

函数

appodeal.init()

appodeal.show()

appodeal.hide()

appodeal.load()

appodeal.isLoaded()

appodeal.setUserDetails()

appodeal.getRewardParameters()

appodeal.getVersion()

appodeal.setSegmentFilter()

appodeal.canShow()

appodeal.trackInAppPurchase()

appodeal.set728x90Banners()

事件

adsRequest

项目设置

要在模块化模式下使用此插件，build.settings 中的 plugins 表应如下所示

settings =
{
    iphone =
    {
        plist =
        {
            GADApplicationIdentifier = "[YOUR_ADMOB_APP_ID]", -- replace with your app id. See: https://googlemobileadssdk.page.link/admob-ios-update-plist
            NSAppTransportSecurity = { NSAllowsArbitraryLoads=true },
            MinimumOSVersion = "10.0", -- Needed to avoid build errors
            NSLocationWhenInUseUsageDescription = "The app needs your location for analytics and advertising purposes",
            NSCalendarsUsageDescription = "The app needs your calendar to provide personalised advertising experience tailored to you",
            NSUserTrackingUsageDescription = "This identifier will be used to deliver personalized ads to you.",
            SKAdNetworkItems = {
                     { SKAdNetworkIdentifier = "4pfyvq9l8r.skadnetwork" },
                     { SKAdNetworkIdentifier = "6g9af3uyq4.skadnetwork" },
                     { SKAdNetworkIdentifier = "4fzdc2evr5.skadnetwork" },
                     { SKAdNetworkIdentifier = "2fnua5tdw4.skadnetwork" },
                     { SKAdNetworkIdentifier = "ydx93a7ass.skadnetwork" },
                     { SKAdNetworkIdentifier = "cg4yq2srnc.skadnetwork" },
                     { SKAdNetworkIdentifier = "v72qych5uu.skadnetwork" },
                     { SKAdNetworkIdentifier = "mlmmfzh3r3.skadnetwork" },
                     { SKAdNetworkIdentifier = "pwdxu55a5a.skadnetwork" },
                     { SKAdNetworkIdentifier = "c6k4g5qg8m.skadnetwork" },
                     { SKAdNetworkIdentifier = "wg4vff78zm.skadnetwork" },
                     { SKAdNetworkIdentifier = "g28c52eehv.skadnetwork" },
                     { SKAdNetworkIdentifier = "523jb4fst2.skadnetwork" },
                     { SKAdNetworkIdentifier = "294l99pt4k.skadnetwork" },
                     { SKAdNetworkIdentifier = "hs6bdukanm.skadnetwork" },
                     { SKAdNetworkIdentifier = "prcb7njmu6.skadnetwork" },
                     { SKAdNetworkIdentifier = "m8dbw4sv7c.skadnetwork" },
                     { SKAdNetworkIdentifier = "9nlqeag3gk.skadnetwork" },
                     { SKAdNetworkIdentifier = "cj5566h2ga.skadnetwork" },
                     { SKAdNetworkIdentifier = "u679fj5vs4.skadnetwork" },
                     { SKAdNetworkIdentifier = "a7xqa6mtl2.skadnetwork" },
                     { SKAdNetworkIdentifier = "g2y4y55b64.skadnetwork" },
                     { SKAdNetworkIdentifier = "wzmmz9fp6w.skadnetwork" },
                     { SKAdNetworkIdentifier = "yclnxrl5pm.skadnetwork" },
                     { SKAdNetworkIdentifier = "4468km3ulz.skadnetwork" },
                     { SKAdNetworkIdentifier = "t38b2kh725.skadnetwork" },
                     { SKAdNetworkIdentifier = "7ug5zh24hu.skadnetwork" },
                     { SKAdNetworkIdentifier = "rx5hdcabgc.skadnetwork" },
                     { SKAdNetworkIdentifier = "5lm9lj6jb7.skadnetwork" },
                     { SKAdNetworkIdentifier = "9rd848q2bz.skadnetwork" },
                     { SKAdNetworkIdentifier = "n6fk4nfna4.skadnetwork" },
                     { SKAdNetworkIdentifier = "7rz58n8ntl.skadnetwork" },
                     { SKAdNetworkIdentifier = "ejvt5qm6ak.skadnetwork" },
                     { SKAdNetworkIdentifier = "275upjj5gd.skadnetwork" },
                     { SKAdNetworkIdentifier = "kbd757ywx3.skadnetwork" },
                     { SKAdNetworkIdentifier = "9t245vhmpl.skadnetwork" },
                     { SKAdNetworkIdentifier = "n9x2a789qt.skadnetwork" },
                     { SKAdNetworkIdentifier = "44jx6755aq.skadnetwork" },
                     { SKAdNetworkIdentifier = "tl55sbb4fm.skadnetwork" },
                     { SKAdNetworkIdentifier = "2u9pt9hc89.skadnetwork" },
                     { SKAdNetworkIdentifier = "8s468mfl3y.skadnetwork" },
                     { SKAdNetworkIdentifier = "klf5c3l5u5.skadnetwork" },
                     { SKAdNetworkIdentifier = "ppxm28t8ap.skadnetwork" },
                     { SKAdNetworkIdentifier = "74b6s63p6l.skadnetwork" },
                     { SKAdNetworkIdentifier = "kbmxgpxpgc.skadnetwork" },
                     { SKAdNetworkIdentifier = "44n7hlldy6.skadnetwork" },
                     { SKAdNetworkIdentifier = "5l3tpt7t6e.skadnetwork" },
                     { SKAdNetworkIdentifier = "uw77j35x4d.skadnetwork" },
                     { SKAdNetworkIdentifier = "6964rsfnh4.skadnetwork" },
                     { SKAdNetworkIdentifier = "84993kbrcf.skadnetwork" },
                     { SKAdNetworkIdentifier = "pwa73g5rt2.skadnetwork" },
                     { SKAdNetworkIdentifier = "mtkv5xtk9e.skadnetwork" },
                     { SKAdNetworkIdentifier = "e5fvkxwrpn.skadnetwork" },
                     { SKAdNetworkIdentifier = "gta9lk7p23.skadnetwork" },
                     { SKAdNetworkIdentifier = "r45fhb6rf7.skadnetwork" },
                     { SKAdNetworkIdentifier = "3rd42ekr43.skadnetwork" },
                     { SKAdNetworkIdentifier = "ludvb6z3bs.skadnetwork" },
                     { SKAdNetworkIdentifier = "737z793b9f.skadnetwork" },
                     { SKAdNetworkIdentifier = "mls7yz5dvl.skadnetwork" },
                     { SKAdNetworkIdentifier = "w9q455wk68.skadnetwork" },
                     { SKAdNetworkIdentifier = "p78axxw29g.skadnetwork" },
                     { SKAdNetworkIdentifier = "6xzpu9s2p8.skadnetwork" },
                     { SKAdNetworkIdentifier = "ggvn48r87g.skadnetwork" },
                     { SKAdNetworkIdentifier = "3sh42y64q3.skadnetwork" },
                     { SKAdNetworkIdentifier = "f38h382jlk.skadnetwork" },
                     { SKAdNetworkIdentifier = "24t9a8vw3c.skadnetwork" },
                     { SKAdNetworkIdentifier = "cstr6suwn9.skadnetwork" },
                     { SKAdNetworkIdentifier = "zmvfpc5aq8.skadnetwork" },
                     { SKAdNetworkIdentifier = "feyaarzu9v.skadnetwork" },
                     { SKAdNetworkIdentifier = "5a6flpkh64.skadnetwork" },
                     { SKAdNetworkIdentifier = "glqzh8vgby.skadnetwork" },
                     { SKAdNetworkIdentifier = "424m5254lk.skadnetwork" },
                     { SKAdNetworkIdentifier = "av6w8kgt66.skadnetwork" },
                     { SKAdNetworkIdentifier = "s39g8k73mm.skadnetwork" },
                     { SKAdNetworkIdentifier = "lr83yxwka7.skadnetwork" },
                     { SKAdNetworkIdentifier = "22mmun2rn5.skadnetwork" },
                     { SKAdNetworkIdentifier = "su67r6k2v3.skadnetwork" },
                     { SKAdNetworkIdentifier = "4w7y6s5ca2.skadnetwork" },
                     { SKAdNetworkIdentifier = "dzg6xy7pwj.skadnetwork" },
                     { SKAdNetworkIdentifier = "y45688jllp.skadnetwork" },
                     { SKAdNetworkIdentifier = "hdw39hrw9y.skadnetwork" },
                     { SKAdNetworkIdentifier = "4dzt52r2t5.skadnetwork" },
                     { SKAdNetworkIdentifier = "5tjdwbrq8w.skadnetwork" },
                     { SKAdNetworkIdentifier = "32z4fx6l9h.skadnetwork" },
                     { SKAdNetworkIdentifier = "xy9t38ct57.skadnetwork" },
                     { SKAdNetworkIdentifier = "54nzkqm89y.skadnetwork" },
                     { SKAdNetworkIdentifier = "9b89h5y424.skadnetwork" },
                     { SKAdNetworkIdentifier = "79pbpufp6p.skadnetwork" },
                     { SKAdNetworkIdentifier = "s69wq72ugq.skadnetwork" },
                     { SKAdNetworkIdentifier = "k674qkevps.skadnetwork" },
                     { SKAdNetworkIdentifier = "578prtvx9j.skadnetwork" },
                     { SKAdNetworkIdentifier = "f73kdq92p3.skadnetwork" },
                     { SKAdNetworkIdentifier = "x44k69ngh6.skadnetwork" },
                     { SKAdNetworkIdentifier = "mp6xlyr22a.skadnetwork" },
                     { SKAdNetworkIdentifier = "qqp299437r.skadnetwork" },
                     { SKAdNetworkIdentifier = "3qcr597p9d.skadnetwork" },
                     { SKAdNetworkIdentifier = "97r2b46745.skadnetwork" },
                     { SKAdNetworkIdentifier = "6p4ks3rnbw.skadnetwork" },
                     { SKAdNetworkIdentifier = "rvh3l7un93.skadnetwork" },
                     { SKAdNetworkIdentifier = "zq492l623r.skadnetwork" },
                     { SKAdNetworkIdentifier = "x8uqf25wch.skadnetwork" },
                     { SKAdNetworkIdentifier = "b9bk5wbcq9.skadnetwork" },
                     { SKAdNetworkIdentifier = "bxvub5ada5.skadnetwork" },
                     { SKAdNetworkIdentifier = "krvm3zuq6h.skadnetwork" },
                     { SKAdNetworkIdentifier = "c3frkrj4fj.skadnetwork" },
                     { SKAdNetworkIdentifier = "v9wttpbfk9.skadnetwork" },
                     { SKAdNetworkIdentifier = "n38lu8286q.skadnetwork" },
                     { SKAdNetworkIdentifier = "3qy4746246.skadnetwork" },
                     { SKAdNetworkIdentifier = "v4nxqhlyqp.skadnetwork" },
                     { SKAdNetworkIdentifier = "8c4e2ghe7u.skadnetwork" },
                     { SKAdNetworkIdentifier = "r26jy69rpl.skadnetwork" },
                     { SKAdNetworkIdentifier = "8m87ys6875.skadnetwork" },
                     { SKAdNetworkIdentifier = "488r3q3dtq.skadnetwork" },
                     { SKAdNetworkIdentifier = "52fl2v3hgk.skadnetwork" },
                     { SKAdNetworkIdentifier = "m5mvw97r93.skadnetwork" },
                     { SKAdNetworkIdentifier = "89z7zv988g.skadnetwork" },
                     { SKAdNetworkIdentifier = "hb56zgv37p.skadnetwork" },
                     { SKAdNetworkIdentifier = "6v7lgmsu45.skadnetwork" },
                     { SKAdNetworkIdentifier = "m297p6643m.skadnetwork" },
                     { SKAdNetworkIdentifier = "3l6bd9hu43.skadnetwork" },
                     { SKAdNetworkIdentifier = "vcra2ehyfk.skadnetwork" },
                     { SKAdNetworkIdentifier = "a2p9lx4jpn.skadnetwork" },
                     { SKAdNetworkIdentifier = "238da6jt44.skadnetwork" },
                     { SKAdNetworkIdentifier = "v79kvwwj4g.skadnetwork" },
                     { SKAdNetworkIdentifier = "f7s53z58qe.skadnetwork" },
                     { SKAdNetworkIdentifier = "gta8lk7p23.skadnetwork" },
             },
        },
    },
    android =
    {
        minSdkVersion = "16",
        applicationChildElements =
        {
            [[
                <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID"
                    android:value="[YOUR_ADMOB_APP_ID]"/>  -- replace with your app id. See: https://goo.gl/fQ2neu
            ]],
        },
    },
    plugins =
    {
        -- Base
        ['plugin.appodeal.base'] = { publisherId = 'com.coronalabs' },
        ['plugin.appodeal.Amazon'] = {publisherId = 'com.coronalabs'},
        ['plugin.appodeal.Bidmachine'] = { publisherId = 'com.coronalabs' }, -- Note you need all adatper for this adapter to build properly
        ['plugin.appodeal.GoogleAdMob'] = { publisherId = 'com.coronalabs' },
        ['plugin.appodeal.AppLovin'] = { publisherId = 'com.coronalabs' },
        ['plugin.appodeal.FacebookAudience'] = { publisherId = 'com.coronalabs' },
        ['plugin.appodeal.MyTarget'] = { publisherId = 'com.coronalabs' },
        ["plugin.appodeal.Pangle"] = {publisherId = 'com.coronalabs'},
        ['plugin.appodeal.Unity'] = { publisherId = 'com.coronalabs' },
        ['plugin.appodeal.Vungle'] = { publisherId = 'com.coronalabs' },
        ['plugin.appodeal.Yandex'] = { publisherId = 'com.coronalabs' },
        ["plugin.appodeal.InMobi"] = {publisherId = 'com.coronalabs'},
    },
}

确保包含 Base 块，以便插件正常运行。然后，可以只注释掉不必要的广告类型块，这样就可以不下载不必要的适配器，并且不会将这些适配器与你的项目关联。

重要

如果针对 iOS 进行构建，你必须通过将以下内容添加到 build.settings 的 plist 表中来绕过 App 传输安全 (ATS)。虽然我们并不盲目地鼓励所有开发者和项目采取此方法，但在某些情况下需要绕过 ATS。有关 ATS 的更多信息，请参阅管理 App 传输安全指南。

settings =
{
    iphone =
    {
        plist =
        {
            NSAppTransportSecurity = { NSAllowsArbitraryLoads=true },
        },
    },
}

注意

对于 Android，使用此插件时会自动添加以下权限/功能

"android.permission.INTERNET"
"android.permission.ACCESS_NETWORK_STATE"
"android.permission.WRITE_EXTERNAL_STORAGE"

此外，如果你希望在应用中收取定向广告并增加获得更高收益的机会，你可以包含以下权限中的任何一个或全部

"android.permission.GET_ACCOUNTS"
"android.permission.ACCESS_COARSE_LOCATION"
"android.permission.ACCESS_FINE_LOCATION"

示例项目

在 GitHub 上查看

类型	库
修订版	版本 2024.3703
关键字	广告、广告宣传、Appodeal
平台	Android、iOS