Guide to Install and Use Mini Ads Network (Poly Widgets) for Perfex CRM

Learn how to install, configure, and manage domain-locked advertising campaigns and 7 interactive widget types using the Mini Ads Network & External Widget Distribution Engine (Poly Widgets for Perfex CRM - polywidgets) module.

Quick Installation Guide

Download the module ZIP file (poly_widgets.zip).
Log in to your Perfex CRM Admin dashboard and navigate to Setup > Modules.
Upload poly_widgets.zip and click Activate.
Access the Poly Widgets menu in the admin sidebar to start creating domain-locked campaigns and interactive widgets.

System Architecture & Single-File Obfuscated JS Engine

graph TD
    A[Admin Configures Campaign & Widget in Perfex CRM] --> B[Generate Single-File Obfuscated JS Pixel Payload /widgets/pixel/code]
    B --> C[External Website Embeds Single Script Tag]
    C --> D[Script Executed on External Visitor Browser]
    D --> E{Domain Verification Check}
    E -->|Authorized Domain| F[Render Interactive Widget Layout on External Site]
    E -->|Unauthorized Domain| G[Block Widget Rendering]
    F --> H[CORS Telemetry API /widgets Records Impression Click Hover Analytics]

Domain-Locked Campaign Container & 7 Widget Types Distribution Flow

graph TD
    A[Create Campaign Container with Domain Lock] --> B[Add & Customize Interactive Widgets]
    B --> C[Configure Widget Triggers & Display Rules]
    C --> D[Compile Obfuscated Payload Bundle]
    D --> E[Serve JS Pixel File to Website System]

Public CORS Telemetry API & Impression/Click Tracking Matrix

graph TD
    A[Visitor Interacts with External Widget] --> B[Trigger Async CORS Request to /widgets]
    B --> C[Validate Domain & Widget Payload Token]
    C --> D[Record Daily Impression Count in tblpolywidgets_impressions]
    C --> E[Record Click Event Count in tblpolywidgets_clicks]
    C --> F[Record Hover Event Count in tblpolywidgets_hovers]