API торговой площадки

Обзор

API торговой площадки авторизованных покупателей — это набор ресурсов, которые покупатели могут использовать для программного управления следующим:

  • Переговоры с издателями
  • Аукционные пакеты
  • Клиентский доступ к пользовательскому интерфейсу торговой площадки авторизованных покупателей

В этом руководстве представлен API Marketplace и объясняется, как ресурсы API Marketplace сопоставляются с функциями Marketplace в пользовательском интерфейсе Авторизованных покупателей .

Участники торгов и покупатели

API Marketplace соответствует структуре API назначения ставок в реальном времени . Оба API используют bidders и buyers в качестве ресурсов корневого уровня для операций участников торгов и покупателей. Вы можете использовать одни и те же имена участников торгов и покупателей в путях к ресурсам для API ставок в реальном времени и торговой площадки.

Клиенты и пользователи клиентов

Вы можете использовать API Marketplace для создания клиентов и пользователей клиентов и управления ими, а также для программного предоставления агентствам или рекламодателям доступа к вкладке Marketplace в пользовательском интерфейсе Авторизованных покупателей.

Client представляет собой клиента, агентство или рекламодателя, связанного с вашей учетной записью Авторизованных покупателей.

ClientUser представляет конкретного человека, который имеет доступ к пользовательскому интерфейсу под Client . Пользователи клиента не могут получить доступ к API Marketplace. Пользователи клиента имеют ограниченный доступ к вкладке « Торговая площадка » вашей учетной записи. Разрешения пользователей клиента определяются role , указанной в их родительском Client .

Другие ресурсы в Marketplace API ссылаются на клиентов по имени, указанному в ресурсе Clients .

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

Медиапланировщики

Медиапланировщик — это агентство или другая организация, которая самостоятельно ведет переговоры по сделкам с издателями и позволяет одному или нескольким участникам торгов размещать ставки от имени своих завершенных сделок. Эти сделки представляют собой либо частные аукционы, либо приоритетные сделки, и вы не сможете просматривать их или взаимодействовать с ними до тех пор, пока они не будут завершены, после чего они появятся в ответе bidders.finalizedDeals.list .

Чтобы определить, была ли данная завершенная сделка согласована медиапланировщиком, вы можете проверить, заполнено ли поле mediaPlanner сделки. Специалисты по медиапланированию устанавливают список идентификаторов мест для конкретных DSP, которые имеют право совершать транзакции по сделке, и его можно просмотреть с помощью поля eligibleSeatIds . В запросах ставок для ставок в реальном времени эти идентификаторы мест могут появляться в списках разрешенных или блокированных списках, установленных издателем, что определяет, будут ли ставки фильтроваться на аукционе. Они могут отображаться в следующих полях BidRequest :

  • протокол OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Протокол Google RTB
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Аукционные пакеты

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

AuctionPackage аналогичен пакету таргетинга для инвентаря Marketplace. Например, аукционный пакет может быть нацелен на набор URL-адресов и идентификаторов мобильных приложений, которые соответствуют бизнес-интересам покупателя.

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

Вы можете делиться аукционными пакетами с другими покупателями и клиентами, а также предоставлять вам доступ к аукционным пакетам, созданным Google или другими покупателями.

Дополнительную информацию см. в разделе Аукционные пакеты .

Профили издателей

Вы можете использовать API Marketplace для просмотра профилей издателей, с которыми вы можете вести переговоры.

PublisherProfile представляет издателя в API Marketplace. Другие ресурсы в Marketplace API относятся к издателям, имя которых указано в их PublisherProfile .

Профили издателей содержат ту же информацию, что и издатели на вкладке «Обнаружение» пользовательского интерфейса торговой площадки авторизованных покупателей.

Дополнительную информацию см. в разделе «Как найти издателей» .

Предложения и сделки

Вы можете использовать API Marketplace для заключения сделок с издателями. Вот несколько способов использования Marketplace API для управления сделками:

Предложения представляют собой последний статус переговоров по одной или нескольким сделкам между покупателем или клиентом и издателем и аналогичны вкладке «Переговоры » пользовательского интерфейса торговой площадки авторизованных покупателей.

Сделки представляют собой последние условия сделки, обсуждаемой в рамках данного предложения, и сопоставимы со списком сделок в пользовательском интерфейсе Торговой площадки авторизованных покупателей с пометкой ТЕКУЩИЕ ПЕРЕГОВОРЫ для данного предложения.

Завершенные сделки представляют собой сделки, которые завершили этап переговоров и готовы к выполнению. Сюда входят сделки, которые уже выполняются. Завершенные сделки аналогичны вкладке «Сделки » в пользовательском интерфейсе торговой площадки авторизованных покупателей.

В зависимости от типа сделки, о которой вы ведете переговоры, поведение ресурсов API Marketplace может различаться. Например, покупатели не могут инициировать переговоры по всем типам сделок. Чтобы узнать больше о реализации API Marketplace для переговоров, посетите следующие ресурсы:

Дополнительную информацию о переговорах в пользовательском интерфейсе Торговой площадки авторизованных покупателей см. в следующих статьях: