Skip to main content

Обновление 04.07.2024 API: Расширение функциональности для более тонкой настройки рекламных кампаний

Расширение функциональности для более тонкой настройки рекламных кампаний

Updated over 10 months ago

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

1. Расширение условий (Conditions) для настройки таргетинга

Добавлены новые параметры для более детализированной настройки условий таргетинга в ваших кампаниях:

- browser (Браузер)**

- connectionType (Тип подключения)**

- isp (Интернет-провайдер)**

- operatingSystem (Операционная система)**

- referrer (Источник перехода)**

Пример использования новых параметров в JSON-структуре:


{
"browser": "Firefox",
"connectionType": "Fiber",
"isp": "ISP Example",
"operatingSystem": "Linux",
"referrer": "example.com"
}

2. Поддержка двух форматов для указания стран

Улучшена поддержка указания стран при настройке геотаргетинга. Теперь доступны как старый, так и новый формат:

- Старый формат:

"countries": ["US", "CA"]

- Новый формат:

"countries": [
{ "code": "US" },
{ "code": "CA" }
]

3. Дополнения к GET ответам

В ответы метода GET добавлены новые поля, позволяющие более гибко управлять кампаниями:

- metarefresh и metarefreshDomain для управления механизмами обновления страницы.

- conditionalPathsGroups и inlineFlow для настройки логики перенаправлений.

Пример кода с новыми полями:


"conditionalPathsGroups": [
{
"logical": "OR",
"paths": [
{ "direct": 1 }
]
}
],
"inlineFlow": {
"defaultPaths": [
"direct"
]
}

4. Новый метод для обновления компаний

Введен новый метод `/campaign/2/{campaignId}`, предназначенный для полного обновления модели flow кампании:


POST /campaign/2/{campaignId}
Content-Type: application/json

{
"newFlowModel": "..."
}

5. Расширенные возможности для создания и обновления кампаний

Теперь при создании и обновлении компаний доступны как документированный формат API, так и формат, используемый при получении данных через GET. Это касается таких параметров, как trafficSource, country, state, и language.

Пример использования:


"campaign": {
"trafficSource": "Direct",
"redirectTarget": {
"country": "US",
"state": "NY",
"language": "en"
}
}


6. Новый метод для экспорта клик-логов

Добавлен новый метод для экспорта данных клик-логов через API. Этот метод позволяет выгружать данные по визитам за определенный период с указанием часового пояса. После завершения выгрузки ссылка на данные будет отправлена на ваш email. Также можно указать фильтры для определенных кампаний. По умолчанию данные выгружаются для всех кампаний.

Пример использования:

GET /click-log
Content-Type: application/json

{
"from": "2024-01-01 00:00:00",
"to": "2024-01-31 23:59:59",
"timeZone": "UTC",
"format": "CSV",
"email": "[email protected]",
"campaignId": [123, 456, 789]
}

7. Новый метод для обновления затрат по кампании

Добавлен новый метод для обновления затрат по кампании через API. Этот метод позволяет эффективно обновлять данные о затратах для конкретной кампании.

Пример использования:

POST /report/manual-cost
Content-Type: application/json

{
"from": "2024-01-01 00:00:00",
"to": "2024-01-31 23:59:59",
"timeZone": "UTC",
"campaignId": 123,
"cost": 1000
}

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

Did this answer your question?