The advertools library was created to fill a gap in the Data Science field, as a set of tools for the ditial marketing practitioner, with a focus on search (SEO/SEM).
While there are many tools for web developers to implement advertising or marketing solutions, this is more for the marketing practitioner, yet available to use for building applications, as you can see on this website.
Python was chosen as it is the most used language in the Data Science, machine learning, deep learning, and AI fields, as well as its approachability for beginners. Another reason is that since it is a generic programming language, you will not be stuck with data libraries, on the contrary, you will be overwhelmed with the avialable choices in many other fields like web development for example.
The documentation is split into four general categories, following the “Diátaxis” system of documentation, as explained below.
Tutorials
This is the “start here” section. Typically you would start with a tutorial on a certain topic, get confident that you can accomplish a task and then move on to more specific areas. Choose the topic/task you like, and keep coming back for updates.
How-to Guides
These are the code “recipes”. Once you are confident in a certain topic and have a specific task in mind, you can find it under how-to guides. This is like a cooking recipe. You have the basic cooking skills, but now you want to the steps to produce a certain dish. There isn’t much learning here, but mostly sets of sequences of code to achieve a specific objective. It is assumed that you know the basics.
Explanations
These are more theoretical topics and geared toward building a deeper understanding of a certain concept or topic. These are not typically to be used for work immediately. There is usually nothing practical in them, but can help you in other areas. For example, learning about how the crawl file is structured will open up many options in your auditing and analysis of crawled websites. There is no “do this, then do that”. It is more about how the columns are organized and named, how rows are created, and how that maps to URLs and their elements, and so on.
Reference
This is simply a listing of all the available functions, classes, objects, and their parameters and options. You come here to check what parameters a certain function has, and what their types are. Coming soon!