Как вставить HTTP-API баннер addflow.ru в приложение ВК

Готовые уроки IFrame + ВКонтакте API
Ответить
AddFlow
Сообщения: 14
Зарегистрирован: 12 окт 2010, 23:05

Как вставить HTTP-API баннер addflow.ru в приложение ВК

Сообщение AddFlow »

Помимо возможности интегрировать готовую библиотеку Flash-API, владельцы приложений так же могут установить на свою рекламную площадку HTTP-API.
Плюсы и минусы обоих способов интеграции - оставим на обсуждение Вам.

Здесь будет приведено короткое руководство по интеграции HTTP-API, т.к. это самый сложный способ интеграции рекламной системы с приложением.

/url: Получить баннер:

Код: Выделить всё

 http://ll-url.addflow.ru/url.xml (ответ в XML)http://ll-url.addflow.ru/url.json (ответ в JSON)
Отдаёт две ссылки: ссылку на изображение (jpg, swf, gif, png...) баннера и ссылку, по которой нужно сделать переход при клике на баннер.
Изображения скачиваются клиентом отдельно.
Рекомендуется обновлять баннер раз в 30 секунд

IN:

Параметры GET-запроса:

Код: Выделить всё

 client_id: Уникальный идентификатор приложения в баннерной системе. Целое положительное число.format_id: Идентификатор формата баннера. Целое положительное число. Поддерживаются значения:1: Горизонтальный баннер 827 x 135 пикселей (BANNER_827_135).country_name: Страна. Строка 0..64 символов в нижнем регистре.city_name: Город. Строка 0..64 символов в нижнем регистре.age: Возраст. Целое положительное число.gender: Пол. Целое положительное число. Поддерживаются значения:1: Мужской (MALE).2: Женский (FEMALE).0: Неизвестен (UNKNOWN).
Значения параметров country_name, city_name, age и gender берутся из анкеты пользователя, которому показывается баннер.
Параметр age рассчитывается исходя из даты рождения пользователя и текущей даты на клиентской машине.

Пример:

Код: Выделить всё

http://ll-url.addflow.ru/url.xml  ?client_id=10  &format_id=1  &country_name=россия  &city_name=  &age=20  &gender=0
Для читаемости добавлены переводы строк.
Поля city_name и gender у пользователя заполнены не были.
Значения city_name и country_name необходимо экранировать.

ВНИМАНИЕ! Вписывайте уникальный client_id для вашего приложения, который был выдан при регистрации. Если его у вас нет, можно получить бесплатно у службы поддержки (support@addflow.ru)

OUT:

В XML или JSON в зависимости от URL запроса.

Параметры

Код: Выделить всё

image_url: URL изображения / флешки баннера. Строка.target_url: URL перехода баннера. Строка.
При клике на баннер необходимо совершить переход на target_url.

XML:

Код: Выделить всё

<banner image_url="URL" target_url="URL"/>
JSON:

Код: Выделить всё

 { "banner": { "image_url": "URL", "target_url": "URL" } }
Примеры:

Код: Выделить всё

<banner  image_url="http://example.com/path/img.jpg"  target_url="http://example.com/"  /> { "banner":  { "image_url": "http://example.com/path/img.jpg",    "target_url": "http://example.com/"  }}

Ошибки:

Формат ответа XML:

Код: Выделить всё

<error id="ERROR_ID">
Формат ответа JSON:

Код: Выделить всё

{ "error": { "id": "ERROR_ID" } }
Коды ошибок (ERROR_ID):

Код: Выделить всё

BAD_INPUT: неверный формат входных данныхUNKNOWN_CLIENT_ID: клиент не зарегистрирован

Спасибо за внимание!
Подробнее на сайте: http://addflow.ru
Аватара пользователя
112
Модератор
Модератор
Сообщения: 2215
Зарегистрирован: 02 фев 2010, 21:53

Re: Как вставить HTTP-API баннера в приложение ВК

Сообщение 112 »

Переместил в уроки!
AddFlow
Сообщения: 14
Зарегистрирован: 12 окт 2010, 23:05

Re: Как вставить HTTP-API баннера в приложение ВК

Сообщение AddFlow »

112, спасибо
Noise Gate
Сообщения: 691
Зарегистрирован: 28 апр 2010, 12:34

Re: Как вставить HTTP-API баннера в приложение ВК

Сообщение Noise Gate »

112
Добавь еще в название темы, что это об addflow.ru, а то как-то непонятно получается.
Аватара пользователя
Volgar
Сообщения: 113
Зарегистрирован: 26 авг 2010, 18:56

Re: Как вставить HTTP-API баннер addflow.ru в приложение ВК

Сообщение Volgar »

Это надо постараться чтобы так непонятно описывать простые вещи. Урок нужный, но из автора однозначно учитель плохой.
Аватара пользователя
Влад
Модератор
Модератор
Сообщения: 654
Зарегистрирован: 29 апр 2010, 22:24

Re: Как вставить HTTP-API баннер addflow.ru в приложение ВК

Сообщение Влад »

Я что-то не понял как это всё интегрировать... :o
Ответить