The CASAA module allows for site admins to create and manage mapping settings that attach values and settings to the ad-serving and analytics systems to the already established categories and URL paths in their site.
The following sections will cover everything from basic installation to creating managing mapping settings/tagging for the systems used.
After you have downloaded the module and plug-in bundle (currently included with the initial download), install as you would any other module for drupal by placing the taking the entire contents of the expanded archive provided by Drupal into the /sites/all/modules directory of your Drupal site.
When that is complete, goto Administer -> Site Building -> Modules (admin/build/modules) to enable the framework module and any component plug-ins that you wish to use. You must enable all of the sub-modules for your plug-ins to work.
*Please note that enabling any of the plug-ins without enabling the core framework will cause a WSOD (white screen of death)!
*Also note that for sites already using the Context Management Framework (CMF) that installing the CASAA module will install as an upgrade from the CMF and will disable all CMF components. Your existing data and mapping settings will be conserved and migrated into CASAA automatically. For more info please refer to Upgrading from CMF to CASAA.
After enabling the module/plug-ins go to Administer -> User Management -> Permissions (admin/user/permissions). Here, you should enable permissions for the roles that will administering the CASAA module and the tagging/mapping settings for your site.
After installing the system, enabling the necessary plug-ins, and allocating user permissions, the next step is to begin adding account settings for the systems that are being used.
After you have properly installed and enabled the module/plug-ins and configured the user permissions, it's time to setup the account information and global settings for each plug-in system.
Go to Administer -> Site Building -> CASAA Settings (admin/build/casaa) to access the interface for the CASAA module. Under the Global Settings tab you may enter the account information for the systems the you will be using.
In the Global Settings tab you are presented with options for what type of mapping settings you wish to use, Path (URL) mappings and/or Taxonomy term mappings. With those options you may choose to have either path mappings or taxonomy mappings. You may also have both.
*note: choosing either will not remove or delete previous settings that you already have set. It is only an option to help you manage your interface and what you can see and/or manage.
Underneath the global settings for the CASAA module you will see a list of plug-ins installed. There you may insert/add the settings for your accounts with those systems as well as provide default mappings and any other settings that are provided.
Also, with each system installed you will see a checkbox labeled "Enabled" that indicates whether or not it's in use. You may use that option to be able to turn on/off the system in real time as you need it without having to disable the module itself.
* Note: do not disable the module for your plug-in! it may cause an issue that may affect the systems that you're currently using.
After you have entered in the account info and everything else you need you are now ready to begin mapping your site and take control of your ad-serving and analytics!
CASAA allows you to tag and map your site via two different methods. The first, by taxonomy terms, and second, by the url path.
Tagging content using taxonomy terms allows you to bulk tag large amounts of content. You can choose which vocabulary you would like to select terms from and then you can tag values for each term of your choosing.
Tagging content using URL paths gives you options to tag individual pages by its URL or even a series of paths/pages by allowing you to use a wildcard value. The wildcard value allows users to tag a path and all of its sub-directories.
To add a tag for your site, click the "Add Settings" tab in the CASAA menu. The "wizard" will guide you through the basic steps.
The first step in adding a tag is choosing what type of mapping you would like to apply: "Taxonomy Term Mapping" or "Path Mapping."
The next step, after you have chosen which type of mapping to apply, is to choose the plug-ins that you wish to add values for. In the list of available plug-ins, you may choose one or more plug-ins.
Once you have completed the first form, you may click "Next" to continue to the next step; adding values to the plug-ins that you have selected.
The second step in adding new mapping settings is to add your desired values for each of the plug-ins. Each plug-in has its own type of required value and form.
The very form element is the part of your site that you wish to tag. For taxonomy term mappings, here you may select the vocabulary and the terms within that you want to create mappings for.
For URL path mappings, you may type in the path that you wish to map. When providing a path you have the option to provide a wildcard value to be able to include all sub-directories and pages within. For example, the path, "foo" would be a mapping for only that single page. If you were to use the wildcard (*) as in, "foo/*", that would include the "foo" page plus, all of the sub-directories and pages underneath that path. Please be aware though that CASAA recognizes a certain "pecking order" when adding a tagging to any particular page. See the Taxonomy Vs. Path Mapping section for more info.
For more information about the system plug-ins, the required values and other features, please refer to the plug-in documentation for that particular plug-in.
After you have completed that section of the form, click "Save Settings," and your mapping will be applied. Minus any caching or other performance settings for your site, your new mapping will start working the instant it is applied.
CASAA maintains and allows users to create a hierarchical structure between the types of mappings created for the site.
At the top of our proverbial "hill," URL path mappings reign supreme in that the system always looks for a mapped path before searching for other related tags. But, even with path mappings, there is a pecking order.
For instance, we have three path mappings: 'foo', 'foo/bar', and 'foo/*'. The first mapping is solely for the page with the path, "foo" and that page only. The second mapping is solely for the page with the path, "foo/bar." The third mapping includes a wildcard indicator which means that the mapping is for all pages and sub-directories under the "foo" path, including the "foo" page. The way CASAA interprets this is that the non-wildcarded mapping take precedence over the wilcarded mappings as in; If we are on the "foo" page CASAA will pull the mapping for "foo" and ignore the wildcarded mapping. The same goes for the "foo/bar" mapping. But, if we were on the "foo/goo" page/path, CASAA would use the "foo/*" mapping to apply the tagging data.
Continuing within the hierarchy, the level of tagging is the taxonomy term mapping. If a path mapping is not found and taxonomy terms are present within the page being viewed, CASAA will then search for a mapping for the terms.
Drupal's taxonomy is weighted and organized through many variances of parent-child relationships. CASAA allows you to weight your term mappings to better maintain those relationships and provide a more precise tagging tool.
Using term weights you can customize the level of precedence that term and their mappings have over each other. CASAA uses the same scale (-10 to 10) as core Drupal to allow you to weight and float term mappings in the order of precedence that you require.