Sepityi Ads Toolkit
Коротко українською. Sepityi Ads Toolkit: мій власний внутрішній інструмент на Google Ads API. Ним користуюсь тільки я, для акаунтів, які веду: мої власні та акаунти клієнтів, що самі надали мені доступ. Інструмент робить звіти, допомагає будувати й налаштовувати кампанії, чистити пошукові запити і рахувати прогнози бюджету через Keyword Planner. Публічно він не продається і третім особам не надається.
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 96 276 5144