Объяснение пар ключ-значение (KVP) в PubGuru

Этот пост был последний раз обновлен 21 марта 2022 г.

В MonetizeMore мы используем множество пар ключ-значение (KVP) для передачи информации для таргетинга и отслеживания в стеке рекламы. Вот что означает каждый KVP:

• m2_bidder : код участника торгов для победителя аукциона ставок в заголовке для этого показа.
• m2_pb : максимальная ставка победителя аукциона ставок в заголовке для этого показа. PubGuru поддерживает международную валюту, поэтому в качестве валюты используется та валюта, которую издатель использует в DFP.
• m2_size : размер объявления-победителя аукциона ставок в заголовке для этого показа.
• m2_config : представляет версию кода HB, а также имя конфигурации. Это позволяет нам вычислять производительность различных версий нашего кода HB.
• m2_bidder_list : за небольшой процент просмотров страниц мы исключаем из аукциона одного участника торгов. Это позволяет нам увидеть подъем, вызванный каждым участником торгов. Каждый символ в этой строке соответствует участнику торгов. Мы использовали это, чтобы найти участников торгов, которые просто заполняли других или замедляли аукцион до точки снижения RPM страницы.
• test1, test10, test50, test90 : периодически издатели хотят тестировать позиции, которые подходят только для определенных просмотров страниц. Для каждого из них по умолчанию установлено значение «0». Для 1% просмотров страниц test1 = 1. Для 10% просмотров страниц test10 = 1. Для 50% просмотров страниц test50 = 1. И для 90% просмотров страниц test90 = 1.
• m2_traffic : хотя мы по умолчанию используем назначение ставок заголовков для 100% просмотров страниц, мы можем отключить назначение ставок заголовков для определенного процента просмотров страниц. Этот KVP сообщает вам, был ли включен HB для этого показа и для какого процента просмотров страниц он был включен. Так, например, «hbon-50» означает, что для 50 % просмотров страниц в этом сегменте был включен HB, и для этого конкретного показа был включен HB.
• m2_overbid : по умолчанию для позиций HB мы устанавливаем максимальную ставку в размере 20 долларов США или эквивалентной суммы в иностранной валюте для издателей, использующих другие валюты в своем аккаунте DFP. Любая ставка, превышающая это ограничение, округляется в меньшую сторону. Это связано с тем, что в DFP есть ограничение как для позиции за все время, так и для активной позиции. Безответственное создание позиций может полностью разрушить учетную запись DFP, а поскольку учетные записи DFP привязаны к учетным записям AdX и Adsense, это уничтожит всю цепочку учетных записей Google издателя. Это бесспорно плохо. Тем не менее, у некоторых издателей есть аудитория, для которой может быть выгодно поднять предельную ставку выше 20 долларов. Поскольку ограничения KVP за весь срок нет, мы используем m2_overbid для отслеживания ставок, которые превышают лимит ставок и округляются в меньшую сторону. Издатели, которые увидят, что ставки, не являющиеся незначительными, превышают их лимит, будут повышены.
• m2_timeout : это комбо KVP, используемое для отслеживания времени аукциона. KVP имеет следующий формат: t#e# или иногда t#e#x#. Число, следующее за t, — это базовое время ожидания, установленное для аукциона. Число, следующее за буквой e, — это фактическое время, прошедшее с начала аукциона. Иногда это время короче тайм-аута (все ставки возвращаются раньше, а DFP готов к запуску показов). Иногда это превышает время ожидания (обычно из-за того, что DFP не готов).
• m2_auction_extension : это комбо KVP используется для отслеживания параметров, проверяемых для расширения аукциона. При продлении аукциона мы проверяем плотность ставок издателя и распределение для этого просмотра страницы и, возможно, продлеваем аукцион, если это может быть выгодно.
• pageview : устанавливается равным 1 для каждого нового просмотра страницы. Чтобы рассчитать количество просмотров страниц, в которых наша технология действительно работала, просуммируйте общее количество выполненных и невыполненных показов pageview = 1. Это может отличаться от Google Analytics, потому что GA обычно не блокирует рекламу, тогда как DFP блокирует рекламу. Не обращайте внимания на число доходов.
• session : это похоже на KVP просмотра страниц, за исключением того, что вместо этого отслеживаются сеансы. Чтобы рассчитать количество сеансов, в которых наша технология действительно работала, просуммируйте общее количество выполненных и невыполненных показов, где сеанс = 1. Опять же, это может отличаться от GA из-за блокировки рекламы.
• request_uri : некоторые издатели хотят отслеживать доход по статье. Самый простой способ для издателей сделать это — атрибуция дохода request_uri. Это все после доменного имени. Однако важно отметить, что KVP имеют ограничение в 40 символов, поэтому издатели с длинными URL-адресами могут урезать свои значения request_uri.
• session_depth : представляет количество просмотров страниц в сеансе пользователя. Некоторые издатели хотят включить определенных партнеров по запросу только в более поздних просмотрах страниц в сеансе.
• a9 : PubGuru поддерживает загрузку неопубликованной технологии Header Bidding Amazon A9. A9 не обрабатывается внутри нашей оболочки, но мы синхронизируем два тайм-аута между HB и A9, чтобы ни один из них не мог завершить аукцион досрочно. В этом KVP мы отслеживаем состояние A9 в момент срабатывания показа.
• google : Google как рекламная компания требует, чтобы контент издателя был безопасным для бренда и в целом подходил для семейного просмотра. Чтобы учесть это, у нас есть система предупреждений, которая ищет и идентифицирует спорный контент. Затем издатель может установить google=0, google=no или google=off, чтобы отключить все позиции Google для этого показа.
• обертка : обычно используется, когда издатель настроил тест 50/50 между PubGuru и другой оболочкой. Если установлено значение 50%, можно просто сравнить общий доход между двумя сегментами оболочки, чтобы увидеть, у какого из них выше RPM страницы.

KVP атрибуции доходов

PubGuru Header Bidding также поддерживает атрибуцию прибыли. Это делается через UTM, и у каждого UTM есть соответствующий KVP: utm_source , utm_campaign , utm_content , utm_term , utm_medium . Поскольку DFP не поддерживает отчеты по нескольким KVP, мы также поддерживаем комбинированные KVP:

• utm_source_campaign : источник и кампания, разделенные двоеточием.
• utm_scm : источник, кампания и канал, разделенные двоеточиями.

Сторонние KVP

Некоторые из наших рекламных партнеров также добавляют KVP в рекламный стек. К ним относятся:

• amznbid : хеш ставки для Amazon A9.
• oxb, ox160x600 , ox300x250 , ox300x600 , ox320x50 , ox728x90 и подобные: некоторые реализации OpenX bidder использовали эти KVP.