Adobe Analytics Validator

Description

This Chrome extension simplifies debugging and validation of your Adobe Analytics (AA) implementation. It leverages the power of Google's Gemini generative AI API as a core part of an experiment to explore how GenAI can boost productivity in technical tasks. By intercepting AA requests, parsing the payload, and validating it against user-defined rules, this extension provides immediate feedback in the browser's developer console, streamlining your workflow.

The GenAI Advantage: This extension isn't just about validation; it's about exploring the potential of GenAI to automate and simplify complex tasks like creating and applying validation rules. The flexibility and intelligence of the Gemini API allow the extension to handle free-form, human-readable rules, making the validation process more efficient and intuitive.

Key Features

• Real-time validation of AA requests.
• Customizable, human-readable rules. Experiment with different rule formats and complexities!
• AI-powered validation with Google's Gemini, showcasing the potential of GenAI for productivity.
• Clear and formatted results directly in the console.

1. Installation

Install the extension from the Chrome Web Store. Once installed, the extension icon will appear in your browser toolbar.

2. Setting up Validation Rules

The extension validates your Adobe Analytics data based on rules you provide in a text file. Here's how to create and upload your rules file:

• File Format: Create a plain text file (.txt) with your rules. Each line in the file represents a rule. Comments are supported using #.
• Rule Structure: Each rule follows the format FieldName: ValidationRule. Here's a breakdown:
  • FieldName: The name of the Adobe Analytics variable (e.g., pageName, eVar1, prop2, events, products, etc.).
  • ValidationRule: Specifies the validation criteria. Several rule types are supported:
    1. required: The field must be present and not empty.
    2. text: The field can contain any text (including empty strings).
    3. url: The field must be a valid URL.
    4. number: The field must be a number.
    5. [value1, value2, ...]: The field must match one of the listed values. Case-sensitive.
    6. (value1, value2, ...): The field is optional. If present, it must match one of the listed values. Case-sensitive.
    7. eight-digit number: Field must be an eight-digit number.
    8. uuid: The field must be a valid UUID (Universally Unique Identifier). (Optional, if present, must be a UUID)
    9. ISO 8601 timestamp: Field must be a valid ISO 8601 timestamp format.
    10. country code: Field must be a valid country code.
    11. language and locale: Field must be a valid language and locale code.
    12. begin with "some string": Field must begin with the specified string.
    13. [1 to 15]: Field must be a number between 1 and 14 (inclusive).
    14. no or eight-digit number: Field must be either "no" or an eight-digit number.
    15. Conditional Rules: Use if statements to apply rules based on other fields. For example: v1: if pev2 is click Event then text. Supported operators include is, is not, contain, contain not.
• Uploading Rules:
  1. Open the extension popup.
  2. Click "Choose File" to select your rules file.
  3. Click "Submit" to upload the rules. A confirmation message will appear.

3. Enabling GenAI Validation

The extension uses Google's Gemini AI to validate the rules. To enable this:

1. Open the extension popup.
2. Check the "Enable GenAI Validation" toggle. A warning will be displayed explaining the privacy implications (your data will be sent to Google's servers).
3. Click "OK" on the warning to confirm.
4. Add/Change your GenAI API Key:
   1. Click on "Add/Change API Key" button.
   2. Enter your API key in the input field.
   3. Click "Save". Your key will be stored securely.
5. Select the Gemini Model from the dropdown.
6. Click "Save Settings" to apply the API key and model settings.

4. Viewing Validation Results

Once you have uploaded your rules and enabled GenAI validation, the extension will automatically validate Adobe Analytics calls made by your website. The validation results will be displayed directly in your browser's console:

• Formatted Output: The results are displayed in a clear, formatted way, showing the field name, the value sent, and whether the validation passed or failed. Error messages are provided for failed validations.
• Collapsible Sections: The output is organized into collapsible sections (e.g., "eVars," "props," "Lists") for easier navigation.
• Product List Validation: Product-specific rules are displayed under each product in the products array. This helps pinpoint issues with individual product data.
• Validation Summary: A summary of validation errors is shown to give a quick overview. You can expand the summary to see all validation results (including successful ones).

5. Example Rules File

The provided rules-examples.txt file contains various examples of validation rules. You can adapt and extend these rules to fit your specific requirements.

6. Disabling GenAI Validation

To disable GenAI validation:

1. Open the extension popup.
2. Uncheck the "Enable GenAI Validation" toggle. The setting will be saved immediately.

Privacy Policy

This extension stores your provided Gemini API key locally in your browser's storage. No data is collected or shared by the extension itself. However, when GenAI Validation is enabled, your Adobe Analytics payload and rules will be sent to Google's Gemini API for processing. Refer to Google's privacy policy for details on how they handle your data.

Change log

• 1.05 - Fix display issues, optimize value display order
• 1.04 - Better error handling
• 1.00 - Initial release