ironSource Playable Ad (MRAID)

PlayCanvas поддерживает формат и требования ironSource MRAID Playable Ad через официальный внешний инструмент на GitHub.

Рекламные объявления ironSource используют стандарт MRAID 2.0 API и требуют, чтобы ассеты для объявления были внешними относительно index.html, а не встроенными.

Внешние ассеты необходимо будет загрузить на свой сервер или CDN, чтобы ironSource мог разместить объявление в своей сети.

Существуют некоторые ограничения, о которых следует знать при использовании инструмента, их можно найти в документации на GitHub.

Пример проекта

Проект Cube Jump готов к экспорту в формат ironSource MRAID Playable Ad, и ожидаемый HTML-вывод можно найти здесь.

Советы по размеру файла

Поскольку есть ограничение в 5 МБ (несжатых), вам придется планировать и бюджетировать использование ассетов для объявления.

Минифицированный код движка PlayCanvas имеет размер ~1,2 МБ в несжатом виде, и из-за необходимости кодировать файлы ассетов в строках Base64, это добавляет ~30% к размеру каждого файла ассетов.

Это означает, что у вас будет около ~3 МБ для ассетов перед кодированием Base64.

Старайтесь сохранять изображения как можно меньше по размерам и используйте такие инструменты, как TinyPNG, чтобы еще больше уменьшить размер файла.

Чек-лист для рекламных объявлений:

Вы добавили вызов функции mraid.open (для URL-адресов, не относящихся к магазину) или mraid.openStoreUrl (для приложений магазина) в качестве части вашего обратного вызова для действия?

Как экспортировать

Следуйте шагам настройки из файла readme в репозитории GitHub.

Тестирование с помощью инструмента ironSource Playable Test Tool

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

Убедитесь, что на странице включены режим тестирования и MRAID.

Установите следующие параметры в config.json, как показано ниже. Это создаст ZIP-файл с данными ассетов и кодом движка PlayCanvas, отдельными от файла index.html.

    "one_page": {
        "patch_xhr_out": false,
        "inline_game_scripts": false,
        "extern_files": {
            "enabled": true,
            "folder_name": "assets",
            "external_url_prefix": ""
        },
        "mraid_support": true
    }

И выполните команду:

npm run one-page

Полные сведения об опциях и командах можно найти в разделе readme для "Преобразование проекта в один HTML-файл".

Нам нужно будет разместить файлы на конечной точке HTTPS для тестирования с помощью инструмента тестирования ironSource.

Мы рекомендуем разместить локально и использовать ngrok для создания https-туннеля к вашему компьютеру, к которому может получить доступ приложение.

Это даст уникальный URL для конечной точки, который нам нужно добавить в index.html, где он ссылается на внешние файлы.

Измените конец index.html с:

</style>

    <title>Cube Jump MRAID</title>
    <script src="mraid.js"></script>
    <script src="assets/playcanvas-stable.min.js"></script>
    <script src="assets/one-page-mraid-resize-canvas.js"></script>
    <script src="assets/__settings__.js"></script>
</head>
<body>
    <script src="assets/__start__.js"></script>
</body>
</html>

Для (где XXXXXXX - уникальный субдомен от ngrok):

</style>

    <title>Cube Jump MRAID</title>
    <script src="mraid.js"></script>
    <script src="https://XXXXXXX.ngrok.io/assets/playcanvas-stable.min.js"></script>
    <script src="https://XXXXXXX.ngrok.io/assets/one-page-mraid-resize-canvas.js"></script>
    <script src="https://XXXXXXX.ngrok.io/assets/__settings__.js"></script>
</head>
<body>
    <script src="https://XXXXXXX.ngrok.io/assets/__start__.js"></script>
</body>
</html>

Тестируйте локально на своем ПК, дважды щелкнув по index.html, чтобы убедиться, что он корректно воспроизводится.

Если он корректно воспроизводится на вашем ПК, мы можем протестировать его с помощью инструмента тестирования ironSource, скопировав содержимое index.html и вставив его в область MRAID-тега инструмента.

Нажмите на 'Test Ad' и после отображения, воспроизведите рекламу, чтобы дойти до кнопки CTA. После нажатия на кнопку CTA инструмент должен показать, что все тесты пройдены, и предложить вам возможность сгенерировать код.

Это используется для тестирования на устройстве с помощью их приложения, доступного как на Android, так и на iOS.

Финальный экспорт для ironSource

Когда реклама готова к отправке в ironSource, загрузите внешние ресурсы на свой сервер или CDN и добавьте URL-адрес в параметры config.json через свойство external_url_prefix:

    "one_page": {
        "patch_xhr_out": false,
        "inline_game_scripts": false,
        "extern_files": {
            "enabled": true,
            "folder_name": "assets",
            "external_url_prefix": "https://some-cdn.com/unique-id"
        },
        "mraid_support": true
    }

Следуйте процессу отправки играбельного объявления из документации ironSource.