Skip to main content
This page is also available in English.
Коли користувач редагує групи оголошень або ключові слова в майстрі створення кампанії, бекенд може автоматично перегенерувати Responsive Search Ads (RSA), щоб вони відповідали актуальному вмісту групи оголошень. Це відбувається через фонові задачі — API повертає відповідь одразу, а RSA генеруються асинхронно.

​
Як це працює

Кожен endpoint мутації груп оголошень та ключових слів приймає опціональний query-параметр: 
?regenerate_rsas=true   (за замовчуванням)
?regenerate_rsas=false  (вимкнути)
Коли regenerate_rsas=true (за замовчуванням) і мутація впливає на поля, релевантні для RSA, бекенд:
  1. Визначає назву та опис компанії з пов’язаного AssistantKnowledgeItem
  2. Збирає активні (не видалені) ключові слова для кожної зміненої групи оголошень
  3. Ставить у чергу фонову задачу generate_rsas_for_ad_group для кожної зміненої групи
  4. Повертає звичайну відповідь одразу — генерація RSA відбувається асинхронно
Якщо до Google Ads акаунту чернетки не прив’язана компанія, регенерація RSA пропускається без помилки. Це може статися для нещодавно підключених акаунтів, які ще не мають сутності компанії.

​
Які endpoints це запускають

​
Endpoints з авто-регенерацією

EndpointМетодКоли запускається регенерація RSA
.../drafts/{id}/ad-groupsPATCHЗмінюється назва групи оголошень або текст ключового слова
.../drafts/{id}/ad-groupsPOSTСтворюється нова група хоча б з одним ключовим словом
.../drafts/{id}/ad-groups/{ag_id}PUTЗмінюється назва групи оголошень
.../drafts/{id}/ad-groups/{ag_id}/keywordsPOSTЗавжди (додано нове ключове слово)
.../drafts/{id}/ad-groups/{ag_id}/keywords/{kw_id}PUTЗмінюється текст ключового слова
.../drafts/{id}/ad-groups/{ag_id}/keywords/{kw_id}DELETEЗавжди (ключове слово видалено)

​
Що НЕ запускає регенерацію

Ці зміни не вважаються релевантними для RSA:
  • Зміна cpc_bid_micros групи оголошень або ключового слова
  • Зміна match_type ключового слова
  • Зміна final_url ключового слова
  • Створення групи оголошень без ключових слів
Правило: RSA перегенеровуються, коли змінюється контент, що впливає на текст оголошень (назва групи, текст ключового слова, наявність ключових слів). Зміни ставок та таргетингу не впливають на текст оголошень.

​
Як вимкнути

Передайте ?regenerate_rsas=false на будь-якому з вищезгаданих endpoints, щоб пропустити автоматичну регенерацію. Використовуйте це, коли:
  • Користувач робить швидкі пакетні редагування, і ви плануєте запустити регенерацію вручну в кінці
  • Ви оновлюєте лише ставки або метадані і хочете гарантувати, що фонові задачі не запускаються
  • Користувач вручну редагував текст RSA і не хоче, щоб він був перезаписаний
# Перейменувати групу оголошень без регенерації RSA
curl -X PATCH "https://dev-api.cattix.com/api/v1/campaigns/drafts/42/ad-groups?regenerate_rsas=false" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "ad_groups": [
      { "id": 988, "name": "Оновлені брендові терміни" }
    ]
  }'

​
Ручна регенерація

Ви також можете запустити генерацію RSA явно, незалежно від параметра regenerate_rsas:
EndpointЩо робить
POST .../drafts/{id}/ad-groups/{ag_id}/rsa/generateЗгенерувати RSA для однієї групи оголошень
POST .../drafts/{id}/rsas/generate-allЗгенерувати RSA для всіх груп оголошень у чернетці
Обидва endpoints не потребують тіла запиту — назва компанії, опис та URL цільової сторінки автоматично визначаються з прив’язаної компанії чернетки та AssistantKnowledgeItem. Обидва повертають task_id для полінгу. RSA створюються асинхронно фоновим воркером.
Якщо до Google Ads акаунту чернетки не прив’язана компанія, ці endpoints повертають 400 з повідомленням про помилку. Це відрізняється від авто-регенерації (яка пропускається без помилки).

​
Коротка довідка: блок-схема рішень

Запит на мутацію надходить
  │
  ├─ regenerate_rsas=false? ──► Пропустити. Готово.
  │
  ├─ Чи змінилося RSA-релевантне поле?
  │    │
  │    ├─ Назва групи оголошень змінилася?      ──► Так ──► Регенерація для цієї групи
  │    ├─ Текст ключового слова змінився?        ──► Так ──► Регенерація для батьківської групи
  │    ├─ Ключове слово створено?                ──► Так ──► Регенерація для батьківської групи
  │    ├─ Ключове слово видалено?                ──► Так ──► Регенерація для батьківської групи
  │    ├─ Група створена з ключовими словами?    ──► Так ──► Регенерація для нової групи
  │    └─ Тільки ставки/match_type/url?          ──► Ні  ──► Пропустити
  │
  └─ Поставити фонову задачу в чергу
       └─ Відповідь повертається одразу
Авто-регенерація замінює існуючі RSA для змінених груп оголошень. Якщо користувач вручну редагував заголовки або описи RSA, ці зміни будуть перезаписані. Використовуйте ?regenerate_rsas=false, щоб зберегти ручні редагування.