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

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

Updated this week

Мы рады анонсировать выпуск обновления нашего 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?