App Native Carousel

App Native Carousel 是一种多幻灯片广告格式。此格式是原生格式，因此您可以自定义轮播导航元素（例如箭头和开关），以契合应用的设计。

幻灯片是不同广告系列中的横幅。您可以采用特殊方式设置这些横幅，以将其上传到轮播广告。

要显示轮播广告，请在同一版位创建并添加以下内容：

  • 具有 Carousel 配置文件 和轮播设计设置的主要广告系列。
  • 具有 Direct sale 配置文件 和特定横幅模板的附加广告系列。

根据您在具有 Carousel 配置文件的广告系列中指定的横幅设计设置，直销广告系列的幻灯片横幅会显示在一个轮播广告中。

要了解如何为您的网站设置轮播格式，请参阅 Adfox 帮助。

格式细节

  • 在轮播广告中，您可以选择 2 到 10 张幻灯片。

  • 轮播广告中的单个位置是某个广告系列中的单个幻灯片。

  • 您可以设置每张幻灯片以定位特定受众细分。

  • 幻灯片位置由其广告系列层级和优先级确定。
    如果 Adfox 无法针对某个位置选择幻灯片（例如，如果广告系列已结束或没有展示中的横幅），则会在此位置显示优先级较低的幻灯片。

  • 整个轮播广告及其幻灯片均提供统计信息。

以下是填充针对莫斯科用户展示的三张幻灯片轮播的示例：

将横幅添加到 Adfox

步骤 1. 创建轮播广告的主滑块

  1. 在 Yandex Advertising Network 界面中，创建 Native design 格式的广告单元并将其绑定至 Adfox。之后，Adfox 界面中将显示一个带有链接广告单元的版位。
  2. 使用 Carousel 广告系列配置文件 创建 Guarantee 广告系列。要详细了解配置文件，请参阅广告系列配置文件。
  3. 在广告系列设置中，前往 Banners 并点击 Add。
  4. 选择 Mobile Advertising App 横幅格式、App Mobile Native 横幅类型和 App Native Carousel 模板。
  5. 将幻灯片数量设置为 2 到 10 张。
  6. 在 Placement 下，选择横幅的版位。

步骤 2. 设置轮播内容

  1. 使用 Direct sale 广告系列配置文件 创建 Guarantee 广告系列。在 Placement 下，选择为轮播广告设置的版位。

    重要

    确保将幻灯片展示在与轮播广告主滑块相同的版位。

  2. 前往添加横幅的表单。选择 Mobile Advertising App 格式、App Mobile Native 横幅类型和 Media Native Slide 模板。

  3. 设置横幅参数并点击 Save。

步骤 3. 加载滑块

要加载原生广告滑块，请创建一个 SliderAdLoader 对象。

广告请求参数通过 NativeAdRequestConfiguration.Builder 类对象进行配置。在请求参数中，可以传递广告单元编号、图片加载方式、年龄、性别属性，以及其他可以使展示的广告更具相关性的数据。

对于 Adfox 中显示的广告，可将广告版位的 Parameters 值添加到 nativeAdRequestConfiguration 对象中。

要接收广告加载结果通知，请创建 SliderAdLoadListener 实例。设置此实例可监测广告滑块加载程序的事件。

要加载广告，请调用 loadAd() 方法。

以下示例展示了如何从活动加载原生广告：

class AdfoxSliderActivity : AppCompatActivity(R.layout.activity_adfox_slider) {

    private var sliderAdLoader: SliderAdLoader? = null

    private lateinit var binding: ActivityAdfoxSliderBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityAdfoxSliderBinding.inflate(layoutInflater)
        setContentView(binding.root)

        sliderAdLoader = createSliderAdLoader()
        sliderAdLoader?.loadSlider(
            //在此处，您可以使用 NativeAdRequestConfiguration.Builder 类的方法来设置特定参数。
            NativeAdRequestConfiguration
            .Builder("your-ad-unit-id")
            .setParameters(mapOf("adf_ownerid" to "xxxx", "adf_p1" to "xxxx")
            .build()
        ))
    }

    private fun createSliderAdLoader(): SliderAdLoader {
        return sliderAdLoader ?: SliderAdLoader(this).apply {
            setSliderAdLoadListener(object : SliderAdLoadListener {
                override fun onSliderAdLoaded(p0: SliderAd) {
                    // 滑块广告加载成功。现在您可以显示已加载的广告。
                }

                override fun onSliderAdFailedToLoad(p0: AdRequestError) {
                    // 广告加载失败，出现 AdRequestError。
                    // 强烈建议不要尝试通过 onAdFailedToLoad() 方法加载新广告。
                }
            })
        }
    }
}

class AdfoxSliderActivity extends AppCompatActivity {

    @Nullable
    private SliderAdLoader mSliderAdLoader = null;

    private ActivityAdfoxSliderBinding mBinding;

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mBinding = ActivityAdfoxSliderBinding.inflate(getLayoutInflater());
        setContentView(mBinding.getRoot());

        mSliderAdLoader = createSliderAdLoader();
        if (mSliderAdLoader != null) {
            //在此处，您可以使用 NativeAdRequestConfiguration.Builder 类的方法来设置特定参数。
            mSliderAdLoader.loadSlider(
                    new NativeAdRequestConfiguration
                        .Builder("your-ad-unit-id")
                        .setParameters(new java.util.HashMap<String, String>() {{
                            put("adf_ownerid", "xxxx");
                            put("adf_p1", "xxxx");
                        }})
                        .build()
            );
        }
    }

    private SliderAdLoader createSliderAdLoader() {
        if (mSliderAdLoader != null) {
            return mSliderAdLoader;
        }

        final SliderAdLoader newSliderAdLoader = new SliderAdLoader(this);

        newSliderAdLoader.setSliderAdLoadListener(new SliderAdLoadListener() {
            @Override
            public void onSliderAdLoaded(@NonNull SliderAd sliderAd) {
                // 滑块广告加载成功。现在您可以显示已加载的广告。
            }

            @Override
            public void onSliderAdFailedToLoad(@NonNull final AdRequestError error) {
                // 广告加载失败，出现 AdRequestError。
                // 强烈建议不要尝试通过 onAdFailedToLoad() 方法加载新广告。
            }
        });
        return mSliderAdLoader;
    }
}

  1. 创建 NativeAdLoader 类的实例以接收滑块中的广告。

  2. 使用 NativeAdRequestConfiguration 类为 nativeAdRequestConfiguration 请求创建配置。在请求参数中，可以传递广告单元编号、图片加载方式、年龄、性别属性，以及其他可以使展示的广告更具相关性的数据。

    对于在 Adfox 中显示，可将广告平台 Parameters 值添加到 nativeAdRequestConfiguration 请求中。

  3. 设置用于接收实施 NativeAdLoaderDelegate 协议的广告的委托。

  4. 要追踪广告加载过程，请实施 NativeAdLoaderDelegate 协议的下列方法：-nativeAdLoader:didFailLoadingWithError:、-nativeAdLoader:didLoadAd:。

  5. 向加载程序发送 loadAdWithRequestConfiguration: 消息以加载广告。

  6. 如果广告已加载，则会调用以下方法：

    func nativeAdLoader(_ loader: NativeAdLoader, didLoad ad: NativeAd)

  7. 如果广告未加载，则会调用以下方法：

    func nativeAdLoader(_ loader: NativeAdLoader, didFailLoadingWithError error: Error)
示例通用广告请求
// 正在创建加载器
adLoader = NativeAdLoader()
adLoader.delegate = self

// 正在创建 Adfox 请求参数
var parameters = [String: String]()
parameters["adf_ownerid"] = "xxxxxx"
parameters["adf_p1"] = "xxxx"

// 正在创建请求配置
let requestConfiguration = MutableNativeAdRequestConfiguration(adUnitID: "<AdUnitID>")
requestConfiguration.parameters = parameters

// 正在将请求配置传递给加载程序
adLoader.loadAd(with: requestConfiguration)

- 正在实施委托的方法
// ...

func nativeAdLoader(_ loader: NativeAdLoader, didLoad ad: NativeAd) {
    // 在此处展示广告
}

步骤 4. 设置滑块显示

要了解如何显示滑块，请参阅显示原生广告滑块：

广告标签

您可以将不同广告主的广告展示在同一个轮播体验中，并根据与最终广告主签订的独立合同将这些广告提交给州注册机构（ERIR，在线广告统一注册机构）。每个位置都是其自有广告系列中的唯一横幅。

在轮播广告中，只能标记幻灯片横幅。无法使用 Carousel 配置文件在主滑块中启用标记功能。

统计信息

横幅统计信息在多个层级收集：

前往具有 Carousel 配置文件的广告系列层级。打开 Reports 选项卡并选择 By campaigns in Carousel 或 By Carousel positions 报告。

前往带有幻灯片的广告系列层级。打开 Reports 选项卡并选择 By banners slides in Carousel 报告。

没有幻灯片横幅的广告系列无法提供报告。

前往幻灯片层级，打开 Reports 选项卡，然后选择 By positions in Carousel 报告。

您不能为预设报告选择分组。

要在自定义报告中分析按事件分组的指标，请在创建报告时添加 Bulk formats → Position 分组。

备注

添加 Splits by banners 分组后，如果横幅在两个或多个位置展示，则会计算该横幅在特定位置的展示指标。

联系支持部门

上一篇
App Native Slider
下一篇
Video Native