{"id":19176851,"url":"https://github.com/googleads/search-campaign-setup-booster","last_synced_at":"2025-02-23T01:16:45.337Z","repository":{"id":233141246,"uuid":"596011072","full_name":"googleads/search-campaign-setup-booster","owner":"googleads","description":null,"archived":false,"fork":false,"pushed_at":"2023-03-24T06:40:34.000Z","size":157,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-04T02:30:13.197Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/googleads.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-01T09:23:50.000Z","updated_at":"2024-08-05T20:34:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"2b1a23df-5c40-4398-956c-5d5005c017fc","html_url":"https://github.com/googleads/search-campaign-setup-booster","commit_stats":null,"previous_names":["googleads/search-campaign-setup-booster"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleads%2Fsearch-campaign-setup-booster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleads%2Fsearch-campaign-setup-booster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleads%2Fsearch-campaign-setup-booster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/googleads%2Fsearch-campaign-setup-booster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/googleads","download_url":"https://codeload.github.com/googleads/search-campaign-setup-booster/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240254292,"owners_count":19772393,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T10:30:40.153Z","updated_at":"2025-02-23T01:16:45.309Z","avatar_url":"https://github.com/googleads.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Search Campaign Setup Booster\n**Disclaimer**: This is not an official Google Product.\n\nThis is a tool that illustrates how to leverage [Google Ads API](https://developers.google.com/google-ads/api/docs/start) to create campaigns and ad groups as well as, fetch keywords ideas and get estimated metrics.\nThis tool is created by Google Ads gPS GrCN team. Please contact your gPSer if you have any questions. As an alternative, you may also create an issue in the GitHub issue tracker.\n\n# Introduction\n\nThis app is an all-in-one request form built with Flask on Google Cloud AppEngine for Search Ads. It helps onboarding Google Ads search campaigns with a single click, including creating multiple ad groups and generating text creatives.\nThis toolkit uses keyword planner API. Functions are executed on Google Cloud Platform. This toolkit can easily be deployed for both developers and users.\n\n# Architecture\n\nThe tool contains the following parts:\n\nCloud: The project leverages the Google Cloud Function and scheduler to fetch requests from request Google Sheets, and extract categories from the website homepage, create campaign \u0026 ad groups, get new keywords from api, and write text creatives based on templates.\n\nWeb: This is a web frontend built on Flask and Google AppEngine, to let users easily submit requests. It has several parts to fill: receiver email, client information, target and bidding, and other optional fields.\n\n\n# Setup\nThis tool requires a Google Ads API Developer Token and an OAuth Client ID and Secret.\n\n- You can refer this [link](https://developers.google.com/google-ads/api/docs/start) to apply for a Developer Token.\n\n- Follow this [link](https://support.google.com/cloud/answer/6158849?hl=en) for instructions on how to obtain an OAuth client ID and secret.\n\nAfter creating your own Google Ads API Token and OAuth Client ID and Secret, you can continue these steps:\n\n- copy `web/config.py.template` to `web/config.py`\n\n- edit the params in `web/config.py`\n\n```\nPROJECT_ID = 'INSERT_GCP_ID_HERE'\nCLIENT_ID = 'INSERT_CLIENT_ID_HERE'\nCLIENT_SECRET = 'INSERT_CLIENT_SECRET_HERE'\nDEVELOPER_TOKEN = 'INSERT_DEVELOPER_TOKEN_HERE'\n```\n\n# Init\n\nUse Firestore as a NoSQL Storage. Give your email account access to both your Google Ads account and Google Sheets.\n\nRemember to give the `project_id@appspot.gserviceaccount.com` Role and Permissions\n\n`gcloud init` to choose your GCP\n\nRun `python setup.py` to generate credentials for sheets and google ads\n\nRun `gcloud auth application-default login` if you need google cloud credentials\n\nRequest form, make a copy of https://docs.google.com/spreadsheets/d/1L_h22t3SWFflmU-RbpUkOtM_Lc78Ooo-otf4azZzSNw\n\n# Develop\n\nweb: open your terminal and run:\n\n```\nsh dev.sh\n```\nor\n```\nexport FLASK_APP=web/main.py\nexport FLASK_ENV=development\nflask run --host=0.0.0.0 --port=80\n```\n\nCheck cloud/functions/search_ads for more details:\n\n- collection.py: extracts website structures, each category creates an adgroup\n- generate.py: generates text creatives based on templates\n- mining.py and estimate.py: fetches new keywords and estimate metrics with google ads keyword ideas api\n- category.csv: templates lists\n- language.csv and location.csv: language and location code to name mapping csv\n\nfunctions\n\n`python /path/to/functions/main.py`\n\n# Deploy\nopen your terminal and run:\n\n`sh deploy.sh`\n\nthen run:\n\n```\ncd web\ngcloud app deploy\n```\nNavigate your browser to the https://yourappname.appspot.com/ link\n\n# Upload\nHow to use the results after execution:\n- keywords recommendation results: used as a complementary of all keywords, you can choose more keywords from it.\n- ads campaign results: either upload from google ads backend as a google sheet or download to an excel file, then upload as a file.\n\n# Disclaimer\n\nThis is not an official Google product.\n\nThis solution, including any related sample code or data, is made available on an “as is,” “as available,” and “with all faults” basis, solely for illustrative purposes, and without warranty or representation of any kind. \n\nThis solution is experimental, unsupported and provided solely for your convenience. Your use of it is subject to your agreements with Google, as applicable, and may constitute a beta feature as defined under those agreements. \n\nTo the extent that you make any data available to Google in connection with your use of the solution, you represent and warrant that you have all necessary and appropriate rights, consents and permissions to permit Google to use and process that data. \n\nBy using any portion of this solution, you acknowledge, assume and accept all risks, known and unknown, associated with its usage, including with respect to your deployment of any portion of this solution in your systems, or usage in connection with your business, if at all.\n\n# License\n\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0.html)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleads%2Fsearch-campaign-setup-booster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogleads%2Fsearch-campaign-setup-booster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogleads%2Fsearch-campaign-setup-booster/lists"}