Биддинг "сервер-сервер"

В разделе о биддинге "сервер-сервер":

• Интеграция
• Настройка сервера аукциона
• Настройка клиента Android
• Настройка клиента iOS
• Тестирование
• Устранение неполадок

На этой странице:

Facebook Audience Network поддерживает биддинг в мобильных приложениях и на мобильных сайтах. Биддинг в мобильном приложении может интегрироваться с нашим сервером из мобильного клиента или с вашего сервера. В этом обзоре рассматриваются общие принципы биддинга в приложениях.

• Введение
• Архитектуры интеграции
• Запросы и ответы ORTB и поддерживаемые форматы рекламы
• Уведомления о выигрыше, проигрыше, счетах и тайм-аутах
• Выплаты, аукционы, видимость и задержка

Введение

Что такое биддинг в приложении?

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

Преимущества биддинга в приложении

• Аукцион в режиме реального времени дает возможность оптимизировать каждый запрос рекламы.
• Биддинг позволяет узнать реальную ценность ваших рекламных ресурсов.
• Биддинг легко проводить, и он позволяет сократить расход ресурсов на организацию показа рекламы.

Архитектуры интеграции

Биддинг в приложении проводится через конечную точку, в которой реализован протокол ORTB для подачи и приема ставок на отдельные показы. Для биддинга в приложении необходим SDK Audience Network, позволяющий выполнять следующие действия:

• получать buyeruid (в Audience Network SDK называется bidderToken ) — это обязательное поле в запросе ставки, уникальное для пользователя и приложения (для других пользователей и приложений этот маркер недействителен);
• загрузка ответа со ставкой и показ объявления в случае победы этого участника в аукционе;
• регистрация показов и кликов.

Основные этапы проведения биддинга

1. Получите маркер участника аукциона. Эта строка с непрозрачным содержимым необходима платформе Audience Network для ответа на запрос ставки.
2. Отправьте запрос ставки и получите ответ. Это основной этап взаимодействия с конечной точкой биддинга. На нем вы отправляете запрос ставки ORTB и получаете действительный ответ со ставкой или ошибку.
3. Проведите аукцион и выберите победителя из числа ответов со ставками. Как правило, при проведении аукционов ставки в режиме реального времени сравниваются с ориентировочными ставками CPM от других источников спроса (например, с историческими средними ставками CPM). Причина в том, что не все источники спроса поддерживают ставки в режиме реального времени. Аукцион может проводиться:
   • на внутреннем сервере с применением пользовательской логики;
   • на стороннем сервере аукционов;
   • в клиенте на устройстве пользователя.
4. Получите объявление, соответствующее ответу со ставкой. Если Audience Network выиграет аукцион, загрузите объявление, передав поле adm из ответа со ставкой в SDK Audience Network на устройстве пользователя. Обратите внимание: поле adm не содержит само объявление. В нем содержится информация, которая позволяет SDK получить объявление с сервера Audience Network.

Типы интеграции

Аукцион (третий этап в описанном выше процессе биддинга) может проводиться на стороне клиента или сервера. Ниже описаны три разных типа интеграции.

Архитектура интеграции "сервер-сервер"

В режиме межсерверной интеграции сервер аукционов вызывает эндпойнт аукциона Audience Network Facebook и все прочие источники спроса для получения откликов на ставки. После этого сервер проводит аукцион и выбирает ставку-победителя. Сервер аукционов может быть внутренним, с вашей собственной логикой проведения аукциона, или сторонним, интегрированным с аукционами для приложений Audience Network. Благодаря этому вы можете использовать ресурсы сервера и доступную сеть для вызова эндпойнтов аукциона для источников спроса. Вы также можете вносить изменения в интеграцию этих эндпойнтов без обновления клиента.

Интеграция внешнего сервера рекламы

Интеграция внешнего сервера рекламы позволяет объединить агрегацию водопадов с аукционами в приложениях. Для этого выполняется интеграция в режиме "сервер-сервер" с источниками спроса, поддерживающими аукционы в приложениях, а затем данные о победителе аукциона передаются платформе агрегации водопадов, которая запускает водопад и выбирает победивший источник спроса. Такая интеграция служит промежуточным звеном между агрегацией водопадов и аукционами в приложениях. Такой тип интеграции избавляет от необходимости писать собственную логику аукционов.

Запросы и ответы ORTB и поддерживаемые форматы рекламы

Запрос ORTB

Наша конечная точка биддинга поддерживает подмножество протокола OpenRTB версии 2.5.

Примечание. Пример полного запроса см. в руководстве по настройке сервера аукционов

'id' => string, // platform's auction identifier,
'imp' => vec< // slots to bid on
shape(
'id' => string, // platform's identifier for this slot auction
// only for banner impression opportunities
'banner' => shape(
'w' => int, // width
'h' => int, // height
),
// only for native impression opportunities
'native' => shape(
'w' => int, // width 
'h' => int, // height 
),
// only for video impression opportunities
'video' => shape(
'w' => int, // width
'h' => int, // height
'linearity' => int, // 1 = instream, optional
'ext' => shape(
'videotype' => string, // 'rewarded' for Rewarded Video impression opportunities, optional
),
),
'tagid' => string, // Placement ID
'instl' => int, // interstitial flag, 1 = On, 0 = Off, optional
)
>,
// app details (in-app bidding only)
'app' => shape( 
'publisher' => shape(
'id' => string, // publisher app ID
),
),
'device' => shape(
'ua' => string, // device user-agent
'ifa' => string, // ID sanctioned for advertiser use
// Do not send ip or ipv6 if you are requesting bids from the client device.
// For server-side bid requests set ip or ipv6.
'ip' => string, // device IPv4
'ipv6' => string, // device IPv6
'dnt' => int, // "do not track", 1 = On, 0 = Off, optional
'lmt' => int, // "limit ad tracking", 1 = On, 0 = Off
),
'regs' => shape( // regulations object
'coppa' => int, // US FTC regulations for Children's Online Privacy Protection Act, 1 = On, 0 = Off, optional
),
'user' => shape(
'buyeruid' => string, // Audience Network Identity Token, mandatory
),
'ext' => shape(
'platformid' => string, // Mediation partner Platform ID or publisher FB app ID, mandatory
'authentication_id' => string // Authentication token to validate the originator of the request                     
),
'at' => int, // auction type: 1 = First Price, 2 = Second Price
'tmax' => int, // auction timeout in milliseconds
'test' => int, // 0 = normal, 1 = test-mode (we bid $99.99, but don't pay out), optional

Ответ ORTB

Ответ со ставкой действителен в течение 30 минут. Запросить объявление можно в любой момент в течение 30 минут после получения ответа со ставкой. По истечении этого времени показы на основе ставок не оплачиваются.

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

1  
'id' => string // platform's request identifier
'seatbid' => vec<
    shape(
        'bid' => vec<
            shape(
                'id' => string, // Our identifier for this bid
                'impid' => string, // platform's identifier for this slot auction
                'price' => float, // Our bid price on CPM basis, in USD
                'adm' => string, // Our creative - see Rendering The Ad
                'nurl' => string, // URL to get if we win the impression
                'lurl' => string, // URL to get if we lose the impression
            )
        >,
    ),
>,
'bidid' => string, // Our identifier for this response
'cur' => string, // bid currency: USD

Уведомления о выигрыше, проигрыше, счетах и тайм-аутах

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=${AUCTION_LOSS}&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/burl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&auction=${AUCTION_ID}&ortb_loss_code=2"

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

Цены и выплаты

Цены указываются в долларах США за CPM (т. е. цена в размере 4,25 означает выплату в размере 4,25 доллара США за 1000 показов в случае выигрыша ставки). Та же единица измерения должна использоваться для цены окончательного расчета в параметрах nurl и lurl. Выплаты осуществляются непосредственно издателю.

Механизм аукциона

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

Видимость

Для показов в приложении: мы оплачиваем только просмотренные показы независимо от того, была ли наша ставка наивысшей.

Задержка

• Для обеспечения минимальной задержки запросы ставки следует отправлять по одному в каждом вызове API (например, если на аукцион выставлено пять слотов, необходимо вызвать API пять раз — по одному для каждой ставки).
• Конечные точки для отдельных регионов не предоставляются. Инфраструктура Facebook перенаправляет запросы ставок в ближайший дата-центр.
• Используйте постоянные подключения HTTP/2.
• Подставьте в поле tmax ORTB в запросе ставки значение тайм-аута аукциона, чтобы стратегия биддинга выбиралась исходя из величины задержки и результативности. (Дополнительную информацию о поле tmax см. в примере запроса ставки выше.)
• Для достижения целевых показателей задержки обработка может быть частично отложена до момента отображения (т. е. более быстрая ставка может означать более медленное отображение рекламы, и наоборот).
• Мы активно работаем над уменьшением задержки. В настоящее время для биддинга "сервер-сервер" рекомендуется тайм-аут 800 мс.

Дополнительная информация

• Интеграция
• Настройка сервера аукциона
• Настройка клиента Android
• Настройка клиента iOS
• Тестирование
• Устранение неполадок