• Создана пользователем пользователь-1e7cc. Последнее обновление: апр. 05, 2020 Время чтения: 3 мин.

Основы

Этот раздел описывает общий способ загрузки сегментов DMP в Getintent DSP. Рабочий процесс выглядит следующим образом:

  • DMP  загружает данные по протоколу SFTP на сервера Getintent

    • Пакетирует файлы с сегментами

    • Классифицирует файлы с сегментами метаданных 

    • DSP начинает использовать сегменты для таргетинга

Форматы названия файлов с сегментами

Данные DMP должны храниться в файлах txt.gz и называться следующим образом: 

[DMP ID].[дата в формате yyyy-MM-dd_HH-mm-ss].[FILE ID].txt.gz 
Где:

  • [DMP ID] строковый идентификатор 
  • [DATE] дата создания файла в указанном формате.
  • [FILE ID] уникальный ID файла

Пример:

some_dmp. 2015-07-15_12-00-00.632a0017-bbda-4be7-a5fe-6a2478b65c89.txt.gz

Формат данных

Первая строка файла должна быть заголовком и всегда будет игнорироваться. Дальнейшая строка должна следовать синтаксису ниже:

[DMP USER ID]<tab>[DSP USER ID]<tab>[SEGMENTS TO ADD]<tab>[SEGMENTS TO REMOVE] 
Где:

  • [DMP USER ID] – DMP  id пользователя  (может быть пустым)
  • [DSP USER ID] – DSP id пользователя  (может быть пустым)
  • [SEGMENTS TO ADD] –  разделенный запятыми список сегментов. Каждый сегмент должен быть помечен id или id: expiration (в UTC / миллисекундах). Пример «1,2,3» или «1,3,4: 1437061152368». Если срок действия не указан для сегмента, применяется политика срока действия по умолчанию (настроенная для DMP).
  • [SEGMENTS TO REMOVE] – запятая разделяет списки сегментов

Примечания:

  • Должен присутствовать только один из [DMP USER ID] или [DSP USER ID] (зависит от того, какая сторона хранит таблицы соответствия пользователей)

Формат ID пользователя

В качестве отображения (в формате инвентаря на рабочем столе) [DMP USER ID] или [DSP USER ID] может служить любая строка, которая не содержит символ «:».

Для мобильного ID пользователя DMP каждый идентификатор пользователя должен иметь префикс

Префикс

Значение

Примеры

m_raw

Необработанный идентификатор рекламодателя  (iOS IDFA или Android Advertising ID). С учетом регистра

Android
m_raw:dec820aa-41ae-43e0-b3b1-19e2ab258233
iOS
m_raw:C78B8B75-885A-4573-B394-CEB5B1337BA3

m_md5

В настоящее время не поддерживается

m_md5: 86d8638a89ae4a53a57746500f268bcc
(hash of dec820aa-41ae-43e0-b3b1-19e2ab258233)
m_md5: d03b31165b28e930419700bcba1cd7ab
(hash of 0AAF2E9B-8237-66FE-4768-35EF193327CA)
m_md5: 95a3c8be285dcb7b83a4a76f3bf4a4f6
(hash of 7D50A078-3388-8161-AC55-FFE718377953)

m_sha1

В настоящее время не поддерживается

В настоящее время не поддерживается


Соответствие пользователей

Getintent может хранить таблицы соответствия пользователей на своей стороне, но это нежелательно и является возможным только в случае, если это единственный вариант сотрудничества с DMP. 

Поддерживаются следующие случаи:


DSP инициирует синхронизацию

DMP инициирует синхронизацию

DMP хранит таблицы соответствий

DSP называет :

//dmp_url?...[DSP_USER _ID]

DMP хранит соответствие

DMP называет :

//[Getintent domain]/p/cm/[DMP_NAME]?u=[DMP_USER_ID]

DMP хранит соответствие

DSP хранит таблицы соответствий

DSP называет :

//dmp_url?...[DSP_USER _ID]

DMP редиректит к:

//[Getintent domain]/p/cm/[DMP_NAME]?u=[DMP_USER_ID]


DSP хранит соответствие

DMP называет :

//[Getintent domain]/p/cm/[DMP_NAME]?u=[DMP_USER_ID]

DMP хранит соответствие


Импорт таксономии

Для поддержания актуальности списка сегментов рекомендуется использовать автоматический импорт таксономии. Файл таксономии должен быть расположен в том же месте, где размещен пакетный файл. Таксономия должна иметь тот же префикс имени, что и пакетный файл:[ дата в формате yyyy-MM-dd_HH-mm-ss].[FILE ID].taxonomy.json

Таксономия должна быть предоставлена в формате json и соответствовать следующему формату:

НодаОписание

Обязательно

idID сегмента в таксономии DMP

да

nameНазвание сегментада
cost_type

Тип комиссии RATE или FIX


cost_value

CPM в случае FIX или проценты в случае RATE комиссии


currencyВалюта сегмента RUB/USD
advertisersid рекламодателей, которым должен быть доступен сегмент
available_to_all

Должен ли сегмент быть доступен всем рекламодателям (по умолчанию: false).

Если установлено значение true, массив рекламодателей также должен быть пустым.



Если стоимость не указана, будет использоваться цена по умолчанию из настроек DMP.

Taxonomy File example
[
    {
        "id": 1000,
        "name": "Mens 18-24",
        "cost_type": "RATE",
        "cost_value": 20,
        "currency": "USD",
        "advertisers": [
            1000,
            2000,
            3000
        ]
    },
    {
        "id": 1001,
        "name": "Mens 25-29",
        "cost_type": "FIX",
        "cost_value": "1",
        "currency": "USD",
        "advertisers": [
            1000,
            2000,
            3000
        ]
    }    
]











  • Нет меток