Информация о партнерах по совместному использованию инвентаря в файлах ads.txt и app-ads.txt

Поле Inventorypartnerdomain (IPD) было добавлено организацией IAB сравнительно недавно. Поэтому некоторые платформы покупателей ещё не начали использовать его для проверки статусов, даже если Менеджер рекламы отправляет подходящее значение в запросе ставки. Если вы добавили поле IPD, в ближайшее время вам лучше пользоваться декларациями DIRECT и RESELLER для реселлеров в файлах ads.txt и app-ads.txt, как и прежде.

В марте 2021 г. Бюро интерактивной рекламы (IAB) обновило спецификацию файлов ads.txt и app-ads.txt. Теперь в них можно использовать новую директиву inventorypartnerdomain, которая указывает на взаимоотношения между партнерами, использующими совместное использование инвентаря, характерные при продаже OTT-инвентаря и инвентаря на подключенных телевизорах

Спецификация inventorypartnerdomain не является обязательной, но с ее помощью издателям будет проще управлять файлами app-ads.txt и ads.txt. Ранее при совместном использовании инвентаря издатель должен был перечислять все домены, с которыми работает использующий эту функцию партнер и относящиеся к нему реселлеры этого партнера, имеющие разрешение на продажу его контента. Если нужно внести изменения, которые относятся к большому количеству взаимосвязей при совместном использовании и/или если партнер вовлечен в сложные взаимоотношения с реселлерами, то управлять файлами app-ads.txt и ads.txt становится непросто.

Используя спецификацию inventorypartnerdomain в файлах app-ads.txt и ads.txt, издатели смогут указывать домен своего партнера по совместному использованию инвентаря. Покупатели тоже получат возможность (помимо обычного просмотра используемых издателем файлов ads.txt и app-ads.txt) ознакомиться с директивой inventorypartnerdomain в файле ads.txt, чтобы проверить авторизованных реселлеров.

Внимание! Декларация inventorypartnerdomain подразумевает, что издатель рассматривает всех партнеров, указанных в партнерских файлах ads.txt и app-ads.txt, как авторизованных для продажи своего инвентаря. Издатель должен осознавать, какие риски влечет за собой изменение этих файлов без уведомления партнеров.

Как начать работу с директивой inventorypartnerdomain

1. В своих файлах ads.txt и app-ads.txt перечислите партнеров по совместному использованию инвентаря, добавив директиву inventorypartnerdomain.
   Пример

    

   Предположим, что программист A, который создает контент, и дистрибьютор B, который владеет приложением-агрегатором контента для подключенных телевизоров, сотрудничают в рамках совместного использования инвентаря. У программиста A есть права на продажу рекламы в своем контенте, который показывается в приложении дистрибьютора B.

    

   Дистрибьютор В указывает в файле app-ads.txt домен партнера, которым является программист A, используя следующий код:

    

   inventorypartnerdomain=ProgrammerA.com
2. Добавьте параметр &ipd в рекламный тег VAST. Чтобы выполнить валидацию при использовании директивы inventorypartnerdomain, необходимо указать параметр ipd в запросе объявления и сопоставить домен партнера по работе с инвентарем, указанного в файлах app-ads.txt и ads.txt. Если параметр ipd не указан в запросе объявления, то валидация при использовании директивы inventorypartnerdomain не будет выполнена.
   Пример

    

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

    

   Чтобы указать отношения совместного использования инвентаря, в запросе объявления формата VAST, исходящем из приложения дистрибьютора B, необходимо задать параметр &ipd. Это делается следующим образом:

    

   &ipd=ProgrammerA.com

3. Свяжитесь с вашим партнером по совместному использованию инвентаря и убедитесь в том, что файл ads.txt правильно добавлен в домене, который вы указали.

Отношения совместного использования инвентаря могут быть нескольких типов. Например, в некоторых случаях приведенная выше схема работает обратным образом (программист A указывает дистрибьютора B как партнера с помощью inventorypartnerdomain). Чтобы ознакомиться с другими примерами, обратитесь к Руководству IAB по совместному использованию инвентаря.

Устранение неполадок с внедрением директивы inventorypartnerdomain

1. Убедитесь, что директива inventorypartnerdomain в файлах ads.txt и app-ads.txt и запросах объявлений VAST указана верно.
   1. Домены партнеров должны быть указаны как корневые, например ProgrammerA.com, а не ProgrammerA.com/watch.
   2. Декларация inventorypartnerdomain должна быть прописана одной строкой без пробелов.
   3. Проверьте, правильно ли настроен указатель для домена партнера по совместному использованию инвентаря (где партнер размещает файл ads.txt для соответствующей среды, из которой вы отправляете запрос). Например, программист A может использовать домен ProgrammerA.com для инвентаря на подключенных телевизорах Google и домен ProgrammerA2.com для инвентаря на подключенных телевизорах Apple.
   4. В одной строке файлов ads.txt и app-ads.txt может быть прописана только одна директива inventorypartnerdomain. Если у вас несколько директив IPD, то каждая должна быть прописана отдельной строкой.
   5. Для параметра &ipd в теге объявлений VAST может быть только одна декларация домена.
2. Свяжитесь с вашим партнером, чтобы проверить, правильно ли настроен файл ads.txt в коде издателя и доступен ли этот файл для сканирования.
   1. Декларации inventorypartnerdomain в файлах издателя ads.txt и app-ads.txt могут указывать только на файл ads.txt партнера по совместному использованию инвентаря и не могут указывать на файл app-ads.txt.

Часто задаваемые вопросы

Нужно ли обновлять файлы ads.txt и app-ads.txt для каждого магазина приложений или домена?

В каждый ваш домен должен быть загружен отдельный файл ads.txt. Для каждого приложения в магазине приложений также должен быть отдельный файл app-ads.txt.

Если вы хотите использовать директиву inventorypartnerdomain, вам необходимо только обновить соответствующие запросы объявлений и файлы ads.txt/app-ads.txt для магазинов приложений и доменов, при работе с которыми планируется совместное использование инвентаря.

Если у вас есть партнеры по продаже инвентаря в разных средах, то для них понадобятся разные файлы ads.txt и app-ads.txt.

Поддерживают ли файлы ads.txt и app-ads.txt как декларацию inventorypartnerdomain, так и декларацию реселлера для совместного использования инвентаря?

Да. Декларация IPD не является обязательной, и при подтверждении покупателем файлов ads.txt и app-ads.txt будут учитываться все идентификаторы продавца или реселлера, перечисленные в файлах ads.txt и app-ads.txt.