Agency Operating Layer & White Label

The Agency Operating Layer in AdFuz Pro transforms WordPress into a proprietary, enterprise-grade client advertising platform.

Rather than a basic “hide logo” toggle, the Agency module operates as an end-to-end multi-tier system:

┌────────────────────────────────────────────────────────┐
│                  Agency Configuration                  │
│       (Name, Logo, Favicon, Colors, Custom CSS)        │
└───────────────────────────┬────────────────────────────┘
                            │
                            ▼
┌────────────────────────────────────────────────────────┐
│              Branding / White Label Layer              │
│       (Multi-tier Resolution: Global -> Client)        │
└───────────────────────────┬────────────────────────────┘
                            │
       ┌────────────────────┼────────────────────┐
       ▼                    ▼                    ▼
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Admin UI   │     │   Reports    │     │ Emails/PDFs  │
│ Custom menus │     │ White-label  │     │ Agency logos │
│ & CSS theme  │     │  overrides   │     │  & headers   │
└──────────────┘     └──────────────┘     └──────────────┘
                            │
                            ▼
┌────────────────────────────────────────────────────────┐
│               Client Configuration Layer               │
│        (Multi-Client CRUD, Isolation, Workspaces)      │
└───────────────────────────┬────────────────────────────┘
                            │
                            ▼
┌────────────────────────────────────────────────────────┐
│           Export / Import Migration Package            │
│       (.adfuz.json, SHA256 Checksum, Zero-Leak)        │
└────────────────────────────────────────────────────────┘

---

1. White-Label Branding Setup

Navigate to Ad Fuz → Agency and select the White-Label Branding tab.

Available Branding Controls

Setting	Description
Enable White-Label Mode	Hides core AdFuz branding badges, links, and attribution across all admin views.
Agency / Brand Name	Your company name displayed across report headers, email digests, and page titles.
Custom Admin Menu Label	Renames the top-level WordPress sidebar menu (e.g. Ad Engine or Apex Media).
Agency Header Logo	Custom logo URL (via Media Library) injected into admin navigation and PDF deliverables.
Agency Icon / Favicon	32x32 icon displayed in menu tabs and client browser bookmarks.
Primary & Accent Colors	Injects dynamic CSS variables (--preview-primary, --preview-accent) across UI controls.
Custom Footer Attribution	Replaces default footer text on reports and email dispatches.
Custom CSS Override	Direct CSS editor to tweak font families, card radiuses, and admin layouts.

Live Interactive Preview

As you update your agency name, logo, or color hex codes, the Live Interactive Preview Box on the right side of the dashboard renders real-time mockups of your branded admin header, quarterly client report, and custom CTA buttons before saving.

---

2. Managing Client Workspaces

AdFuz Pro allows you to segregate campaigns, creatives, ad spaces, and audience definitions by Client Workspace.

Adding a Client Workspace

1. Navigate to the Agency Clients tab.
2. Click + Add New Client in the top right.
3. Fill in the client profile:
   • Client Name: e.g., Acme Corporation
   • Unique Slug: e.g., acme-corp (auto-generated with collision safety)
   • Target Domain: e.g., acme.com
   • Contact Email: Primary client marketing point of contact
   • Status: Active or Inactive
   • Dedicated Client Logo (Optional Override): Overrides global agency logo for this client’s deliverables.
4. Click Save Client Workspace.

1-Click Client Workspace Cloning

Need to replicate an entire promotional setup for a new client in the same niche?

Click the Clone icon () on any client row, enter the new workspace name, and AdFuz Pro deep-duplicates all linked campaign structures, ad placements, and audience rules in seconds.

---

3. 1-Click Starter Blueprints

Starter Blueprints are pre-packaged campaign architectures tailored for high-converting industry use cases.

Built-in Industry Kits

E-Commerce Flash Sale Kit

High-urgency promotional campaign featuring sticky header ribbons, countdown banner slots, product discount placeholders, and conversion tracking tags.

B2B SaaS Lead Capture Funnel

Optimized lead gen blueprint with exit-intent overlay, in-content whitepaper callout slot, and geo-targeted B2B campaigns.

Publisher High-CTR Native Grid

Multi-slot responsive native ad grid with smart rotation, frequency capping, and ad-blocker recovery slots.

Safe Variable Token Substitution

When applying a blueprint to a client workspace, AdFuz Pro automatically replaces placeholder tokens in ad headlines, landing page URLs, and campaign names:

Token	Description	Resolved Example
{{client_name}}	Full name of the client	Nike Running Corp
{{client_slug}}	Machine-readable slug	nike-running
{{client_domain}}	Client domain / website	nikerunning.com
{{agency_name}}	Global agency brand name	Apex Growth Agency
{{year}} / {{month}}	Current calendar year/month	2026 / September

---

4. Configuration Migration (Export & Import)

AdFuz Pro features an enterprise-grade migration engine that allows agencies to package complete marketing configurations and deploy them across multiple staging, staging-to-production, or client WordPress sites.

Zero-Leak Guarantee

Export packages (.adfuz.json) contain strictly configuration schemas (campaign hierarchies, targeting profiles, creative templates, UTM presets).

They NEVER export or leak:

• Live visitor analytics or impressions
• Customer IP addresses or tracking logs
• Passwords or user accounts
• API keys, license keys, or server secrets

Exporting Configuration Packages

1. Go to the Export Configuration tab.
2. Select the source workspace (Global or specific Client).
3. Check the desired components (Campaigns, Ad Spaces, Creatives, Targeting Rules, A/B Experiments, Smart Rotation, UTM Presets).
4. Click Export & Download JSON Package.
5. The generated file includes a canonical SHA256 Checksum for tamper-proof verification.

Multi-Phase Import Pipeline

When importing an .adfuz.json file into another site:

1. Schema & Checksum Validation: Verifies envelope format adfuz-config and schema version 1.0.
2. Dry-Run Preview Simulation: Simulates the import and checks for slug conflicts without modifying your database.
3. Collision Strategy:
   • Create New: Safely clones duplicate items with an incremental suffix (e.g. promo-banner-2).
   • Skip Existing: Preserves existing items that match identical UUIDs or slugs.
   • Update Existing: Overwrites matching entities with the package configuration.
4. Dependency Resolution & ID Remapping: Automatically maps parent/child bridge references in wp_adfuz_campaign_ads and wp_adfuz_campaign_ad_spaces.
5. Audit Journal: Generates a detailed itemized execution log stored in wp_adfuz_agency_import_runs.

---

5. Protected Artifact Storage & Diagnostics

Exported files and cached deliverables are stored in a hardened server directory:

wp-content/uploads/adfuz/agency/
├── .htaccess      (Deny from all - direct browser access blocked)
├── index.php      (Silence is golden execution block)
└── exports/       (Cryptographically hashed JSON artifacts)

Click the System Health button in the header at any time to inspect:

• Storage directory write permissions and .htaccess protection status
• Active white-label mode status
• Client workspace and blueprint counts
• Server environment (PHP version, memory limits, WP version)

---

Frequently Asked Questions (FAQs)

Will enabling White-Label mode affect existing campaigns or ad shortcodes?

No. White-Label mode only modifies the presentation layer (WordPress admin menu labels, page headings, PDF headers, and shortcode branding attribution). All underlying ad rotation engines, shortcodes ([adfuz_space id="1"]), and delivery scripts continue running identically.

Can different clients have different primary colors and logos?

Yes. AdFuz Pro implements a multi-tier branding hierarchy:

1. Global Agency Settings: Default for all unassigned campaigns and reports.
2. Client Workspace Overrides: Custom logo and contact info defined per client.
3. Report-Specific Overrides: An optional toggle switch inside any report definition allows one-off branding customization.

How does 1-Click Workspace Cloning handle ad placements?

When you clone a workspace, AdFuz Pro duplicates all linked campaign flight dates, creative variants, targeting criteria, and ad space bindings into new database records with unique UUIDs, leaving the original workspace completely untouched.

Can I export configurations from a Localhost staging site to Production?

Yes. The configuration exporter uses relative schema references and variable tokens ({{client_domain}}). When imported on your live server, landing page URLs and asset links resolve cleanly to the target environment.