Компоненты нативной рекламы

Внимание.

Это архивная версия документации. Актуальная документация по всем платформам находится здесь.

Примечание.

Ознакомьтесь с требованиями к размещению рекламы и рекламных компонентов.

Список компонентов

В библиотеке есть обязательные и опциональные компоненты. Правила размещения рекламных объявлений определяют необходимость отображения только обязательных компонентов. На практике, макеты с полным набором компонентов более кликабельные. Поэтому рекомендуется использовать дизайн, который включает весь набор возможных компонентов.


Элемент в объявлении	Компонент	Тип	Обязательность
Заголовок	titleLabel	UILabel	Да
Домен	domainLabel	UILabel	Да
Предупреждение	warningLabel	UILabel	Да
Рекламная и возрастная метка	sponsoredLabel	UILabel	Да
Значок меню	feedbackButton	UIButton	Да
Кнопка действия	callToActionButton	UIButton	Да
Медиа	mediaView	YMANativeMediaView	Да
Иконка приложения	iconImageView	UIImageView	Да, для РМП
Цена	priceLabel	UILabel	Да, для РМП
Фавиконка	faviconImageView	UIImageView	Нет
Количество оценок	reviewCountLabel	UILabel	Нет
Рейтинг	ratingView	UIView<YMARating>	Нет
Текст	bodyLabel	UILabel	Нет


Элемент в объявлении	Компонент	Тип	Обязательность
Заголовок	titleLabel	UILabel	Да
Домен	domainLabel	UILabel	Да
Предупреждение	warningLabel	UILabel	Да
Рекламная и возрастная метка	sponsoredLabel	UILabel	Да
Значок меню	feedbackButton	UIButton	Да
Кнопка действия	callToActionButton	UIButton	Да
Медиа	mediaView	YMANativeMediaView	Да
Иконка приложения	iconImageView	UIImageView	Да, для РМП
Цена	priceLabel	UILabel	Да, для РМП
Фавиконка	faviconImageView	UIImageView	Нет
Количество оценок	reviewCountLabel	UILabel	Нет
Рейтинг	ratingView	UIView<YMARating>	Нет
Текст	bodyLabel	UILabel	Нет

Список обязательных компонентов описывает набор данных, для которых, в случае наличия этих компонентов, должна быть предоставлена View для отображения.

Совет.

Рекомендуется использовать макет, который сможет отобразить весь набор обязательных и опциональных компонентов рекламы.

Оформление компонентов

feedback

Значок меню. Обязательный компонент. С помощью значка меню пользователь может скрыть объявление или пожаловаться на него.

Значок меню добавляется в правый верхний угол объявления.

Примечание.

Разработчику заранее необходимо определить что делать с объявлением после выбора причины закрытия (например, скрыть объявление или показать какую-то надпись). Если дальнейшее действие не определено, SDK учтет причину закрытия, но объявление не будет скрыто.

Варианты оформления:

feedback_dark_dots_with_background

Белый значок меню, с темными точками и полупрозрачной подложкой. Значение по умолчанию.

feedback_light_dots

Значок меню без фона, со светлыми точками.

Пример кода:

YMANativeAdLoader *adLoader = [[YMANativeAdLoader alloc] init];
YMAMutableNativeAdRequestConfiguration *requestConfiguration =
            [[YMAMutableNativeAdRequestConfiguration alloc] initWithAdUnitID:@"demo-native-content-yandex"];
requestConfiguration.parameters = @{ @"feedback_image": "feedback_light_dots" };
[self.adLoader loadAdWithRequestConfiguration:requestConfiguration];

feedback_dark_dots

Значок меню без фона, с темными точками.

Пример кода:

YMANativeAdLoader *adLoader = [[YMANativeAdLoader alloc] init];
YMAMutableNativeAdRequestConfiguration *requestConfiguration =
            [[YMAMutableNativeAdRequestConfiguration alloc] initWithAdUnitID:@"demo-native-content-yandex"];
requestConfiguration.parameters = @{ @"feedback_image": "feedback_dark_dots" };
[self.adLoader loadAdWithRequestConfiguration:requestConfiguration];

media

Subview для медиаконтента (изображение или видео).

Логика показа медиаконтента в mediaView: если рекламный ответ содержит медиаконтент, mediaView отобразит его после буферизации.

Совет.

Проверить наличие медиаконтента можно через свойство media объекта YMANativeAdAssets. Если в рекламном ответе содержится медиаконтент, свойство вернет ненулевой объект YMANativeAdMedia.
Проверить наличие картинки можно через свойство image объекта YMANativeAdAssets. Если в рекламном ответе содержится картинка, свойство вернет ненулевой объект YMANativeAdImage.