Sepityi Ads Toolkit
Що це за інструмент
Sepityi Ads Toolkit це набір програм командного рядка, написаних на Python з офіційною бібліотекою
google-ads. Я використовую його у щоденній роботі спеціаліста з Google Ads:
для звітів, налаштування акаунтів, чистки пошукових запитів і медіапланування для рекламодавців, з якими працюю.
- Хто користується: лише я, Тимофій Сепітий. Інших користувачів, публічної реєстрації і сторінки входу немає.
- З якими акаунтами працює: мої власні акаунти Google Ads і акаунти клієнтів, привʼязані до мого керуючого акаунта Sepityi MCC (738-802-5570) після того, як клієнт прийняв запит.
- Як авторизується: OAuth 2.0 (desktop flow) з єдиним дозволом
https://www.googleapis.com/auth/adwords, під моїм власним обліковим записом Google. - Поширення: інструмент не продається, не пропонується як сервіс і не передається третім особам.
Що він робить
1. Звіти
Отримує щоденні й місячні показники (покази, кліки, вартість, конверсії, цінність конверсій, пошукові запити, дані аукціонів) запитами GAQL і формує місячний звіт для кожного клієнта: що зроблено, що змінилось порівняно з минулим місяцем і що заплановано далі.
2. Моніторинг пошукових запитів
Раз на день читає звіт про пошукові запити, позначає нерелевантні і готує перелік мінус-слів. За замовчуванням працює в режимі перегляду і нічого не змінює; мінус-слова додаються лише після мого підтвердження.
3. Керування кампаніями
Створює і редагує кампанії, групи оголошень, ключові слова, списки мінус-слів, адаптивні пошукові оголошення й обʼєкти (додаткові посилання, уточнення, структуровані описи) за підготовленим планом. Нові кампанії завжди створюються зі статусом PAUSED, тому нічого не витрачається, доки ми з клієнтом не перевіримо їх в інтерфейсі Google Ads.
4. Аудит перед запуском
Читає структуру і налаштування акаунта (мережі, регіони, мови, ставки, конверсії, оголошення) і перевіряє їх за моїм чеклістом перед запуском кампанії. Лише читання.
5. Підбір ключових слів і прогнози
Через API використовує Планувальник ключових слів, щоб збирати ідеї ключових слів з обсягом пошуку і прогнозувати кліки, покази та вартість за запланованого бюджету. Результат це медіаплан, який клієнт бачить до погодження бюджету. Саме для цього мені потрібен рівень Basic: на рівні Explorer Планувальник недоступний.
Сервіси Google Ads API, які використовуються
| Сервіс | Методи | Призначення |
|---|---|---|
| CustomerService | ListAccessibleCustomers | Перелік акаунтів, доступних моєму керуючому акаунту |
| GoogleAdsService | Search, SearchStream | Звіти й аудити (GAQL, лише читання) |
| CampaignService, CampaignBudgetService, AdGroupService | Mutate | Створення і редагування кампаній, бюджетів, груп оголошень |
| AdGroupCriterionService, CampaignCriterionService | Mutate | Ключові слова, мінус-слова, регіони, мови |
| SharedSetService, SharedCriterionService | Mutate | Списки мінус-слів |
| AdGroupAdService | Mutate | Адаптивні пошукові оголошення |
| AssetService, CampaignAssetService | Mutate | Додаткові посилання, уточнення, структуровані описи |
| KeywordPlanIdeaService | GenerateKeywordIdeas, GenerateKeywordForecastMetrics | Підбір ключових слів і прогнози бюджету |
Очікуваний обсяг значно менший за 15 000 операцій на день: кілька акаунтів клієнтів, один запуск звітів на день і періодичне створення кампаній.
Як обробляються дані
- Дані читаються лише з акаунтів, якими я керую, і лише для роботи, яку доручив власник акаунта.
- Звіти отримує лише власник відповідного акаунта. Дані одного клієнта ніколи не показуються іншому.
- Облікові дані OAuth і токени оновлення зберігаються локально на моєму робочому компʼютері, захищеному паролем, і ніколи не публікуються і не передаються.
- Дані Google Ads не продаються, не використовуються для реклами і не поєднуються з іншими джерелами для створення профілів.
- Докладніше в Політиці конфіденційності; правила користування в Умовах.
Приклад результату
Місячний підсумок у вигляді, як у звіті для клієнта. Приклад, не реальний клієнт.
| Кампанія | Кліки | Вартість, грн | Конверсії | Ціна конверсії | До минулого місяця |
|---|---|---|---|---|---|
| Пошук · Послуги | 1 240 | 18 600 | 62 | 300 | −12% ціна конверсії |
| Пошук · Бренд | 410 | 1 900 | 38 | 50 | +5% конверсій |
| Performance Max | 2 980 | 21 400 | 71 | 301 | +18% конверсій |
Перегляд пошукових запитів (приклад): інструкція ремонт pdf → запропоновано як мінус-слово, безкоштовно → запропоновано як мінус-слово,
послуга ціна київ → залишити. Нічого не застосовується до мого підтвердження.
Контакти
Сепітий Тимофій Ігорович, Київ, Україна
Пошта: tymofii@sepityi.com · Телефон: +380 73 276 5154
Sepityi Ads Toolkit
What the toolkit is
Sepityi Ads Toolkit is a set of command-line tools written in Python with the official
google-ads client library. I use it to run my day-to-day work as a Google Ads specialist:
reporting, account setup, search-term cleanup and media planning for the advertisers I work with.
- Who uses it: only me, Tymofii Sepityi. There are no other users, no public sign-up and no login page.
- Which accounts it touches: my own Google Ads accounts and the accounts of my clients that are linked to my manager account Sepityi MCC (738-802-5570) after the client has accepted the link request.
- How it authenticates: OAuth 2.0 (desktop flow) with the single scope
https://www.googleapis.com/auth/adwords, signed in as my own Google account. - Distribution: the toolkit is not sold, not offered as a service and not given to third parties.
What it does
1. Reporting
Pulls daily and monthly performance (impressions, clicks, cost, conversions, conversion value, search terms, auction metrics) with GAQL queries and builds a monthly report for each client: what was done, what changed month over month and what is planned next.
2. Search-term monitoring
Once a day reads the search terms report, flags irrelevant queries and prepares a list of negative keywords. By default it runs in review mode and changes nothing; negatives are added only after I confirm the list.
3. Campaign management
Creates and edits campaigns, ad groups, keywords, negative keyword lists, responsive search ads and assets (sitelinks, callouts, structured snippets) from a prepared plan. New campaigns are always created in PAUSED status, so nothing starts spending until I and the client review it in the Google Ads interface.
4. Pre-launch audit
Reads the account structure and settings (networks, locations, languages, bidding, conversion actions, ads) and checks them against my checklist before a campaign goes live. Read-only.
5. Keyword research and forecasts
Uses Keyword Planner through the API to collect keyword ideas with search volume and to forecast clicks, impressions and cost for a planned budget. The result is a media plan the client sees before agreeing to a budget. This is the main reason I need Basic access: Keyword Planner is not available at Explorer level.
Google Ads API services used
| Service | Methods | Purpose |
|---|---|---|
| CustomerService | ListAccessibleCustomers | List accounts available to my manager account |
| GoogleAdsService | Search, SearchStream | Reporting and audits (read-only GAQL) |
| CampaignService, CampaignBudgetService, AdGroupService | Mutate | Create and edit campaigns, budgets, ad groups |
| AdGroupCriterionService, CampaignCriterionService | Mutate | Keywords, negatives, locations, languages |
| SharedSetService, SharedCriterionService | Mutate | Negative keyword lists |
| AdGroupAdService | Mutate | Responsive search ads |
| AssetService, CampaignAssetService | Mutate | Sitelinks, callouts, structured snippets |
| KeywordPlanIdeaService | GenerateKeywordIdeas, GenerateKeywordForecastMetrics | Keyword research and budget forecasts |
Expected volume is well under 15,000 operations per day: a handful of client accounts, one reporting run per day and occasional builds.
How data is handled
- Data is read only from accounts I manage, and only to do the work the account owner hired me for.
- Reports go only to the owner of that account. Data from one client is never shown to another client.
- OAuth credentials and refresh tokens are stored locally on my password-protected workstation and are never published or shared.
- Google Ads data is not sold, not used for advertising and not combined with data from other sources to build profiles.
- Full details are in the Privacy Policy; the rules of use are in the Terms of Service.
Example output
Monthly summary as it appears in a client report. Sample data, not a real client.
| Campaign | Clicks | Cost, UAH | Conversions | Cost / conv. | vs last month |
|---|---|---|---|---|---|
| Search · Services | 1 240 | 18 600 | 62 | 300 | −12% cost / conv. |
| Search · Brand | 410 | 1 900 | 38 | 50 | +5% conversions |
| Performance Max | 2 980 | 21 400 | 71 | 301 | +18% conversions |
Search-term review (sample): repair manual pdf → proposed negative, free → proposed negative,
service price kyiv → keep. Nothing is applied before I confirm.
Contact
Tymofii Sepityi (Тимофій Ігорович Сепітий), Kyiv, Ukraine
Email: tymofii@sepityi.com · Phone: +380 73 276 5154