adcolony.*

类型 库
修订版本 版本 2024.3703
关键词 广告, advertising, AdColony
平台 Android, iOS

概述

AdColony 插件允许开发者通过 AdColony 视频插播广告和激励视频广告来实现用户盈利。

AdColony 插件仅适用于已购买 Corona 专业套装 或 AdColony 插件的用户。此插件可让您保留 100% 的广告收入，并允许您直接通过 AdColony 管理您的帐户/设置。

重要

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

注册

在使用此插件之前，您必须先在 AdColony 注册。

语法

local adcolony = require( "plugin.adcolony" )

函数

adcolony.init()

adcolony.load()

adcolony.isLoaded()

adcolony.show()

adcolony.getInfoForZone()

事件

adsRequest

项目设置

要使用此插件，请在 `build.settings` 的 `plugins` 表中添加一个条目。添加后，构建服务器将在构建阶段集成该插件。

settings =
{
    plugins =
    {
        ["plugin.adcolony"] =
        {
            publisherId = "com.coronalabs"
        },
    },
}

iOS

如果您的应用程序适用于 iOS，则还必须在 `build.settings` 中包含以下代码，以确保 AdColony 正常运行

settings = {
 
    iphone =
    {
        plist =
        {
            LSApplicationQueriesSchemes =
            {
                "fb",
                "instagram",
                "tumblr",
                "twitter"
            },
            NSCalendarsUsageDescription = "This app would like to add events to the calendar.",
            NSPhotoLibraryUsageDescription = "This app would like to access the photo library.",
            NSCameraUsageDescription = "This app would like to access the camera.",
            NSMotionUsageDescription = "This app would like to use interactive ad controls.",
            NSUserTrackingUsageDescription = "To serve more releavant ads",
            SKAdNetworkItems = {
                { SKAdNetworkIdentifier = "4PFYVQ9L8R.skadnetwork" },
                { SKAdNetworkIdentifier = "YCLNXRL5PM.skadnetwork" },
                { SKAdNetworkIdentifier = "V72QYCH5UU.skadnetwork" },
                { SKAdNetworkIdentifier = "TL55SBB4FM.skadnetwork" },
                { SKAdNetworkIdentifier = "T38B2KH725.skadnetwork" },
                { SKAdNetworkIdentifier = "PRCB7NJMU6.skadnetwork" },
                { SKAdNetworkIdentifier = "PPXM28T8AP.skadnetwork" },
                { SKAdNetworkIdentifier = "MLMMFZH3R3.skadnetwork" },
                { SKAdNetworkIdentifier = "KLF5C3L5U5.skadnetwork" },
                { SKAdNetworkIdentifier = "HS6BDUKANM.skadnetwork" },
                { SKAdNetworkIdentifier = "C6K4G5QG8M.skadnetwork" },
                { SKAdNetworkIdentifier = "9T245VHMPL.skadnetwork" },
                { SKAdNetworkIdentifier = "9RD848Q2BZ.skadnetwork" },
                { SKAdNetworkIdentifier = "8S468MFL3Y.skadnetwork" },
                { SKAdNetworkIdentifier = "7UG5ZH24HU.skadnetwork" },
                { SKAdNetworkIdentifier = "4FZDC2EVR5.skadnetwork" },
                { SKAdNetworkIdentifier = "4468KM3ULZ.skadnetwork" },
                { SKAdNetworkIdentifier = "3RD42EKR43.skadnetwork" },
                { SKAdNetworkIdentifier = "2U9PT9HC89.skadnetwork" },
                { SKAdNetworkIdentifier = "M8DBW4SV7C.skadnetwork" },
                { SKAdNetworkIdentifier = "7RZ58N8NTL.skadnetwork" },
                { SKAdNetworkIdentifier = "EJVT5QM6AK.skadnetwork" },
                { SKAdNetworkIdentifier = "5LM9LJ6JB7.skadnetwork" },
                { SKAdNetworkIdentifier = "44JX6755AQ.skadnetwork" },
                { SKAdNetworkIdentifier = "MTKV5XTK9E.skadnetwork" },
            }
        }
    }
}

重要

如果为 iOS 构建，则必须通过将以下内容添加到 `build.settings` 的 `plist` 表中来绕过应用程序传输安全 (ATS)。虽然我们不盲目地鼓励所有开发者和项目都采用这种方法，但在某些情况下需要绕过 ATS。有关 ATS 的更多信息，请参阅 管理应用程序传输安全 指南。

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

Android

重要

对于 Android，您应该从 `build.settings` 中**移除**任何遗留的 `["plugin.google.play.services"]` 插件。

注意

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

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

此外，您可以添加以下可选权限

  • "android.permission.VIBRATE"

支持