https://github.com/s0und0fs1lence/ads-zero
Alert system for marketing campaings
https://github.com/s0und0fs1lence/ads-zero
analytics facebook-ads facebook-api facebook-api-graph google-ads marketing-automation
Last synced: 8 days ago
JSON representation
Alert system for marketing campaings
- Host: GitHub
- URL: https://github.com/s0und0fs1lence/ads-zero
- Owner: s0und0fs1lence
- License: apache-2.0
- Created: 2025-03-07T16:45:03.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-03-07T18:35:07.000Z (8 months ago)
- Last Synced: 2025-03-07T19:29:41.572Z (8 months ago)
- Topics: analytics, facebook-ads, facebook-api, facebook-api-graph, google-ads, marketing-automation
- Language: Go
- Homepage:
- Size: 4.88 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 ads-zero
**ads-zero** is an alpha-stage alerting system built for modern marketers. It fetches campaign data from channels like **Facebook**, **Google**, **TikTok**, and **Taboola**, applies customizable rules, and sends notifications via **email**, **Telegram**, or **Slack** when conditions are met.
> **Note:** Currently, only the Facebook integration is implemented, with ClickHouse used for data storage. Postgres support is planned along with additional data sources. The Kafka engine for scalable deployment is fully implemented.
## ✨ Features
| Component | Status | Details |
| ----------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------- |
| **Data Fetching** | Facebook ✅
Google ⏳
TikTok ⏳
Taboola ⏳ | Fetches marketing campaign data from multiple sources. |
| **Rule Engine** | Customizable ✅ | Execute one or more rules against the fetched data to detect defined conditions. |
| **Notification** | Email, Telegram, Slack ✅ | Send alerts to users when specific conditions are met. |
| **Data Storage** | ClickHouse ✅
Postgres ⏳ | Save the fetched data for further analysis. |
| **Deployment** | Single Component ✅
Kafka ✅ | Use as a standalone component with an internal ticker or deploy at scale using Kafka. |
| **Configuration** | Database Configurable ✅ | Configure alerts via database table records. Planned: JSON interface for simpler setups. |## 📊 Project Status
- **Alpha Stage:** Minimal implementation for Facebook data integration.
- **Storage:** ClickHouse is the current working solution. Postgres support is planned.
- **Deployment:** Supports both single component mode (internal ticker) and scalable deployment using Kafka.
- **Configuration:** Alerts are currently configured through database table records. A JSON-based configuration interface is planned for users who do not need long-term data storage.## 🚀 Getting Started
1. **Clone the Repository**
```sh
git clone
cd ads-zero-1
```
2. Install any necessary dependencies.
3. Configure your notification channels (email, Telegram, or Slack).
4. Start testing and contributing to the development of additional data sources and rule implementations.## Contribution
Contributions are welcome! Please feel free to fork the repository and submit pull requests with improvements or new features.
## License
This project is licensed under the terms of the Apache License 2.0.
## Contact
For any questions or collaboration ideas, please open an issue in the repository.