ibiza
Начать

Строки app-ads.txt и sellers.json для паблишеров Ibiza Exchange

≈ 3 мин чтения · обновлено

Чтобы покупатели доверяли показам вашего приложения через Ibiza Exchange, добавьте в файл app-ads.txt на сайте разработчика строку exchange.ooti.digital, <ваш seller_id>, DIRECT. Она подтверждает, что биржа продает ваш инвентарь с вашего разрешения, а seller_id связывает строку с записью о вас в sellers.json биржи. Для сайтов та же строка кладется в ads.txt.

Строка для app-ads.txt

exchange.ooti.digital, <seller_id>, DIRECT
Поле Значение Что означает
1. Домен рекламной системы exchange.ooti.digital Домен Ibiza Exchange — тот же, где лежит sellers.json и который биржа пишет в цепочку поставки schain
2. Идентификатор продавца ваш seller_id Ваш аккаунт продавца на бирже; одна площадка — один seller_id
3. Тип отношений DIRECT Вы владелец инвентаря и продаете его через биржу напрямую

Четвертого поля (идентификатора TAG) у биржи нет — строка из трех полей допустима по спецификации IAB. Формат строки и разница между DIRECT и RESELLER подробно разобраны в статье ads.txt и app-ads.txt.

Если трафик идет через SSP-посредника

Если ваше приложение подключено не к бирже напрямую, а к SSP, которая перепродает трафик Ibiza Exchange, строка другая: exchange.ooti.digital, src-<номер>, RESELLER. Ее передает вам эта SSP — seller_id в ней принадлежит посреднику, а не вам. Как SSP подключается к бирже, описано в статье «Подключение инвентаря (SSP) к бирже».

Куда положить файл

  1. Откройте карточку приложения в магазине (RuStore, Google Play) и найдите сайт разработчика.
  2. Положите app-ads.txt в корень этого сайта: https://<сайт разработчика>/app-ads.txt. Если файл уже есть — добавьте строку отдельной строкой в конец, остальные не трогайте.
  3. Файл должен открываться по HTTPS без авторизации, как обычный текст.

Для сайтов строка кладется в https://<ваш домен>/ads.txt.

Где взять seller_id

Готовая строка с вашим seller_id есть в кабинете: Площадки → раскройте строку площадки → блок «Строка для app-ads.txt» (для сайтов — ads.txt) с кнопкой «Копировать». Там же для приложения можно указать сайт разработчика из карточки в сторе — на его корне и должен лежать app-ads.txt. Если площадка еще не подключена, оставьте заявку на подключение инвентаря.

Проверить свой seller_id можно в sellers.json биржи — https://exchange.ooti.digital/sellers.json. В нем у каждой площадки, подключенной напрямую, есть запись:

{
  "seller_id": "<seller_id>",
  "is_confidential": 0,
  "seller_type": "PUBLISHER",
  "name": "<название продавца>",
  "comment": "app: <bundle приложения>"
}

Поле comment показывает, к какой площадке относится запись: app: <bundle> для приложения, web: <домен> для сайта. Посредники записаны с типом INTERMEDIARY и seller_id вида src-<номер>.

Как покупатель это проверяет

DSP, получив запрос от Ibiza Exchange, видит в цепочке schain узел биржи с asi: exchange.ooti.digital и sid — вашим seller_id. Дальше она сверяет три вещи: есть ли в app-ads.txt вашего приложения строка с этим доменом и seller_id, есть ли запись с таким seller_id в sellers.json биржи и совпадает ли тип отношений. Если строки нет, многие покупатели такие запросы не покупают или ставят ниже. Как устроена цепочка, рассказано в статье про schain.

Контакт по вопросам sellers.json

Контакт, опубликованный в sellers.json биржи (contact_email): ads@ooti.digital. По подключению и seller_id удобнее написать через форму заявки.

Частые вопросы

Какую строку добавить в app-ads.txt?

Строку вида exchange.ooti.digital, <ваш seller_id>, DIRECT — если вы продаете свой инвентарь напрямую через Ibiza Exchange. Если ваш трафик приходит к нам через SSP-посредника, строку с RESELLER и seller_id этого посредника дает он.

Где взять seller_id?

В кабинете: Площадки → откройте строку площадки → блок «Строка для app-ads.txt» (для сайтов — ads.txt), там готовая строка с вашим seller_id и кнопка «Копировать». Тот же seller_id опубликован в sellers.json биржи: запись типа PUBLISHER, в поле comment — bundle или домен площадки.

Куда положить app-ads.txt?

В корень сайта разработчика, который указан в карточке приложения в магазине: https://<сайт разработчика>/app-ads.txt. Для сайтов — ads.txt в корне домена.