Мы рады анонсировать выпуск обновления нашего 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
}
Это обновление призвано упростить и сделать более гибким процесс управления рекламными кампаниями. Мы надеемся, что вы оцените новые возможности и они помогут вам достигать лучших результатов в ваших рекламных стратегиях.