[space] Fibr Support [title] What is Fibr AI? [path] Fibr AI/ Fibr is an AI-powered platform that helps you understand, test, and optimize every page on your website without writing code or waiting on developers. ## The Problem Fibr Solves Your website is the hardest-working asset in your marketing stack, but it's also the least flexible. Your ad platforms adapt in real-time. Your analytics get smarter every quarter. Your campaigns are hyper-targeted. Yet when someone clicks through, they land on the same static page as everyone else. That's the gap Fibr closes. **What You Can Do with Fibr** - **Understand what's happening:** See how different audiences, regions, and campaigns perform across your pages. Identify where visitors drop off and why. - **Test without bottlenecks:** Run A/B tests and multivariate experiments without engineering dependencies. Launch in minutes, not sprints. - **Personalize automatically:** Show different content to different visitors based on their ad source, location, behavior, or audience segment. - **Create new pages instantly:** Use Fibr Genesis to generate landing pages from prompts, documents, or reference URLs. - **Track AI-driven traffic:** Monitor how your brand appears in AI assistants and measure traffic from ChatGPT, Claude, Perplexity, and others. ## Who Fibr is For - **Marketing teams** who want to optimize landing pages without filing engineering tickets. - **Growth teams** who need to run experiments at scale and move fast. - **Agencies** managing multiple client accounts and campaigns. - **Enterprise organizations** requiring security, compliance, and team collaboration. **How Fibr Is Different** Most optimization tools wait for you to come up with a hypothesis. Fibr doesn't. - **It starts with insight, not guesswork: **Fibr continuously analyzes your live performance data and surfaces opportunities you might have missed. Instead of staring at dashboards wondering what to test, you'll get clear, actionable hypotheses like "Try a different CTA for your low-intent traffic segment." - Turns raw analytics into prioritized test ideas - Detects drop-offs, anomalies, and friction in real time - Connects with GA4, your CRM, and ad platforms to explain *why* conversions vary - **It scales without slowing you down: **Traditional tools let you run a handful of experiments at a time. Fibr is built for velocity. You can personalize and test across hundreds of URLs, campaigns, or audiences simultaneously. - No waiting on engineering for deployments - Instant rollouts and one-click reversions - Learnings automatically shared across teams - **It's built for where the web is going: **The future of optimization isn't manual. Fibr is designed for an agentic web where experiences are created, adapted, and governed automatically. - Auto-generates and deploys experiences based on detected opportunities - Keeps every variant compliant with built-in governance - Prepares your content for LLM-driven discovery so AI assistants can find and recommend you accurately ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FWRb2Irig2TOfFcVhKBLs%252Fimage.png%3Falt%3Dmedia%26token%3Dea1dc98b-02b3-48c5-9126-5cb623b08c30&width=768&dpr=3&quality=100&sign=ba31f3751087a5abe8a540e66d9c3f5b&sv=3" size="80" width="1888" height="1054" isUploading="false" darkWidth="1888" darkHeight="1054" showCaption="false"} **Common Misconceptions** - **"So Fibr is a CRO tool?"** It's more than that. Fibr combines AI agents with human oversight to give you a full-stack experience optimization system, not just A/B testing. - **"Is this just for marketers?"** Not at all. Fibr is built for cross-functional teams. Marketing, product, and engineering all get shared visibility and clear controls. - **"Will this replace our CMS or analytics?"** No. Fibr layers on top of what you already use. It enhances your stack; it doesn't replace it. [title] Product Change Logs [path] / [title] Team [path] / [title] How to change a Team Member's Role [path] Team/ ## Access Requirements To change the role of the team members, your account must have the **Manage Users** permission. :::hint{type="info"} By default, Admins and Owners can change roles of other users. ::: Steps to change a Member's Role: ::::WorkflowBlock :::WorkflowBlockItem Open **Settings**. ::: :::WorkflowBlockItem Select **Team**. ::: :::WorkflowBlockItem Locate the required user. ::: :::WorkflowBlockItem Select the user's role or access settings. ::: :::WorkflowBlockItem Choose the new role. ::: :::WorkflowBlockItem Save the changes. ::: :::: ## Role Assignment Restrictions Fibr applies additional controls to privileged roles to reduce the risk of unauthorized privilege escalation. | Action | Who Can Perform It | | ------------------------------ | --------------------------------------------------- | | Assign the **Owner** role | Owner only | | Assign the **Admin** role | Owner or Admin | | Assign User or Developer roles | Users with the required user-management permissions | | Create or modify custom roles | Users with role-management permissions | | Modify a built-in system role | Not permitted | | Delete a built-in system role | Not permitted | These controls apply even when users have broader workspace-management permissions. ## Troubleshooting | Issue | Possible Cause | Resolution | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Unable to change a team member's role | Your account may not have the required user-management or role-management permission. | Confirm that your assigned role allows you to manage users and roles. Contact a workspace Owner or Admin if additional access is required. | | Unable to assign the Owner role | Only an existing Owner can assign the Owner role to another user. | Ask the current workspace Owner to perform the role assignment. | | Unable to assign the Admin role | Only an Owner or Admin can assign the Admin role. | Confirm that you are signed in as an Owner or Admin. | | User does not have expected access after a role change | The newly assigned role may not contain the required permissions, or the user may have another role affecting their effective access. | Review all roles assigned to the user and verify that the required permission scopes are included. | | User retains access after a role is removed | The user may have another assigned role that grants the same permission. | Review all roles assigned to the user. Fibr combines permissions across multiple roles. | | Unable to remove or modify a system role | System roles are protected and their permissions cannot be edited. | Assign a different system role or create a custom role with the required permissions. | [title] Configure Fibr Script to your website [path] Fibr Script/ ::Iframely{originalUrl="https://youtu.be/WNLk9lSXVhs?si=qdOKmcgN39gcXa2v" embedUrl="https://youtu.be/WNLk9lSXVhs?si=qdOKmcgN39gcXa2v" title="How to Add the Fibr Script to Your Website?" html="
"} Set up the Fibr script on your website to enable personalization, track user behavior, and run seamless experiments using Fibr AI. ## What You’ll Need - Access to your website's HTML (specifically the \ section) - Admin or developer permissions to edit your site's code - "Manage Settings" access on Fibr Dashboard Adding the Fibr Script takes about five minutes. Once it's installed and validated, you're ready to start running experiments and personalization campaigns. ## Step-by-Step Installation :::::WorkflowBlock :::WorkflowBlockItem Log in to your [Fibr Dashboard](https://app.getfibr.co/) and click Settings in the left-hand menu. ::: :::WorkflowBlockItem Go to the Setup section. You'll see your unique Fibr Script displayed here. ::: ::::WorkflowBlockItem Copy the script and paste it into the `` section of your website. :::hint{type="warning"} Avoid GTM installation Google Tag Manager adds a delay that can cause flickering. Click here to see the impact. ::: ```javascript ``` :::: :::WorkflowBlockItem Save and publish your changes. ::: :::WorkflowBlockItem Back in the Fibr Dashboard, enter your site URL in the field provided and click Add URL. ::: :::WorkflowBlockItem Click Validate, then Check now. ::: ::::: You'll see a success message once Fibr confirms the script is working correctly. ## Handling Subdomains If you add the script to your main domain (e.g., example.com), it will automatically apply to all subdomains (e.g., blog.example.com, shop.example.com). However, if you want the script to run only on specific pages or subdomains, you'll need to add it individually to those pages instead. **Remember to whitelist all domains:** In your Fibr workspace, make sure every domain and subdomain where the script runs is added to your allowed list. Otherwise, Fibr won't recognize traffic from those URLs. ## Troubleshooting :::Heading{depth="3" indent="1"} Fixing Flickering ::: :::Paragraph{indent="1"} If you notice a brief flash where the original page appears before the personalized version loads, try these fixes: ::: :::Paragraph{indent="1"} **Option 1: Use the anti-flicker script** In the Setup section of your dashboard, you'll find an alternate version of the script designed to prevent flickering. Switch to this version if the standard script causes issues. ::: :::Paragraph{indent="1"} **Option 2: Check your script placement** Flickering often happens when the Fibr Script loads too late. Make sure it's positioned at the very top of your \ tag, before any other scripts. ::: :::Paragraph{indent="1"} [Learn more about impact of Fibr Script on Web Performance →](docId\:a87TC_U6cFxfrCaCl7eab) ::: :::Heading{depth="3" indent="1"} Validation Failed: ::: :::Paragraph{indent="1"} If the validation check doesn't pass: ::: :::Paragraph{listStyleType="disc" indent="2"} **Double-check the script placement.** It must be inside the \ tag, not the \. ::: :::Paragraph{listStyleType="disc" indent="2"} **Clear your cache.** Your browser or CDN might be serving an older version of your page. ::: :::Paragraph{listStyleType="disc" indent="2"} **Verify the URL matches exactly.** Include or exclude www. consistently with how your site loads. ::: :::Paragraph{listStyleType="disc" indent="2"} **Check for script blockers.** Ad blockers or privacy extensions can sometimes interfere with validation. ::: Still having trouble? Reach out to us at support\@fibr.ai and we'll help you debug. [title] Impact of Fibr Script on Web Performance [path] Fibr Script/ Every script you add to your website affects performance. We know that slower pages mean lower conversions, so we've engineered the Fibr Script to be as lightweight as possible. To show you exactly what that means, we ran a head-to-head comparison of Fibr against other popular personalization tools: VWO, Kameleoon, and Mutiny. Here's what we found. ## Performance Comparison We measured four key metrics that directly affect user experience and Core Web Vitals scores. Lower impact percentages are better. ### Overall Performance Score | **Tool** | **Without Script** | **With Script** | **Impact** | | --------- | ------------------ | --------------- | ---------- | | **Fibr** | 68.6 | 61.9 | **-9.77%** | | VWO | 68.6 | 58.0 | -15.45% | | Kameleoon | 68.6 | 57.2 | -16.62% | | Mutiny | 68.6 | 58.5 | -14.72% | **Fibr's impact is 35-40% lower than competitors.** *** ### First Contentful Paint (FCP) FCP measures how quickly the first visible content appears. Faster is better for perceived load speed. | **Tool** | **Without Script** | **With Script** | **Impact** | | --------- | ------------------ | --------------- | ---------- | | **Fibr** | 0.91s | 0.99s | **+8.79%** | | VWO | 0.91s | 1.15s | +26.37% | | Kameleoon | 0.91s | 1.11s | +21.98% | | Mutiny | 0.91s | 1.14s | +25.27% | **Fibr adds less than 0.1 seconds. Competitors add 0.2 seconds or more.** *** ### Largest Contentful Paint (LCP) LCP measures when the largest visible element finishes loading. This is a Core Web Vital that affects your SEO. | **Tool** | **Without Script** | **With Script** | **Impact** | | --------- | ------------------ | --------------- | ----------- | | **Fibr** | 1.92s | 2.21s | **+15.10%** | | VWO | 1.92s | 2.31s | +20.31% | | Kameleoon | 1.92s | 2.15s | +11.98% | | Mutiny | 1.92s | 2.60s | +35.42% | **Fibr stays competitive on LCP, with Kameleoon slightly ahead on this specific metric.** *** ### Total Blocking Time (TBT) TBT measures how long the main thread is blocked, preventing user interaction. Lower is better for responsiveness. | **Tool** | **Without Script** | **With Script** | **Impact** | | --------- | ------------------ | --------------- | ----------- | | **Fibr** | 481ms | 587ms | **+22.04%** | | VWO | 481ms | 726ms | +50.94% | | Kameleoon | 481ms | 953ms | +98.13% | | Mutiny | 481ms | 575ms | +19.54% | **Fibr and Mutiny are close here, while Kameleoon nearly doubles blocking time.** *** ## The Bottom Line No personalization script has zero impact, but Fibr consistently ranks in the top two across all performance metrics. In most cases, the difference is significant: competitors often add 2-3x more overhead than Fibr. We're continuing to optimize. Our goal is to make the performance impact negligible so you can personalize confidently without sacrificing speed. *** ## Tips to Maximize Performance Even with Fibr's lightweight script, you can further minimize impact: - **Place the script at the top of your \ tag.** This ensures it loads early and doesn't compete with other resources. - **Avoid installing via Google Tag Manager.** GTM adds latency that can increase FCP and cause flickering. Direct installation is faster. - **Use the anti-flicker snippet if needed.** Available in your Setup dashboard, this prevents the flash of original content before personalization loads. - **Keep your \ clean.** The fewer scripts competing for the main thread, the better your overall performance. [title] Integrate Meta Ads Platform [path] Integrations/ ::Iframely{originalUrl="https://youtu.be/7s56jF0c29Y?si=9khVr3bKGlSKf0Ds" embedUrl="https://youtu.be/7s56jF0c29Y?si=9khVr3bKGlSKf0Ds" title="How to Integrate Meta Ads with Fibr Dashboard?" html="
"} ## What You’ll Need - "Manage Integrations Access" in the Fibr Dashboard - A valid Meta Ads account - Admin access in the Meta Ads Account ## Step-by-Step Integration Guide :::::WorkflowBlock :::WorkflowBlockItem Go to Settings on the Fibr Dashboard ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=232326428/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FTIDFKuQ4q5TaJZfp7ycd%252Fimage.png%3Falt%3Dmedia%26token%3Dff2fff1f-bee2-484c-aa10-0d5e28590fc8) ::: :::WorkflowBlockItem Navigate to **Integrations**. ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=1702397981/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FbDlCyTWyL24OecQvI1eK%252Fimage.png%3Falt%3Dmedia%26token%3Ddeb0fcd9-a2c7-49e0-ab0c-12f4664737c0) ::: :::WorkflowBlockItem Navigate to the **Meta Ads **card and click on **Connect**. ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=-1107874845/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FsxrmyFb5H7ltJszFJLK3%252Fimage.png%3Falt%3Dmedia%26token%3D1a268dc6-e5ec-451c-b3d0-dd8af7cadbf8) ::: ::::WorkflowBlockItem Sign in to your **Meta Ad account **through** Fibr Ad Connect**. :::hint{type="success"} This method uses **OAuth 2.0 Authorization Code Flow**, a secure industry-standard process. Your credentials are never shared with Fibr, and the integration adheres strictly to **Meta’s platform policies** and **user data protections.** ::: ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=1238209185/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FSgQJKDfejxej38KNd7Xa%252Fimage.png%3Falt%3Dmedia%26token%3D2a512d11-18e9-4ad2-a5d6-29c9f392fda4) :::: ::::WorkflowBlockItem Select the Account ID and Name ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=-1026438455/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FAIJBvjjBAiVvnZMqHDHH%252Fimage.png%3Falt%3Dmedia%26token%3D79dd9862-7d04-4581-a934-369974f98708) :::hint{type="info"} The Sync takes several minutes to be completed depending on the number of campaigns selected. ::: ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=-412532362/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FZ267hjhZXrkVinZNwRhc%252Fimage.png%3Falt%3Dmedia%26token%3D081a6a8f-edbf-4cb8-92cf-998c5822c229) :::: ::::: :::hint{type="danger"} If your ads tracking parameters are not aligned with Fibr requirements, you will get an error saying "Ads are missing tracking template". To fix the error, please click here. ::: :::hint{type="warning"} If you make any changes to your Google Ads, return to the dashboard and click on the "Sync Ads" button to refresh the data from the Meta Ads account. ::: [title] How to set tracking parameters on Google Ads? [path] Integrations/Integrate Google Ads Platform/ Fibr synchronizes your Google Ads using the tracking parameters defined in each ad. If these parameters are missing or incorrectly configured, the ads cannot be used for personalization within Fibr. ## Requirements for valid configuration of ads Requirements for valid configuration of ads: - \{adgroupID} - \{keyword} :::hint{type="info"} For the best results, Fibr recommends including *all* of the above variables in your Tracking Template. This ensures full compatibility and maximizes the accuracy and depth of Ad Personalization. ::: **Recommended Tracking Template: ** ```javascript {lpurl}?utm_source={network}&utm_medium=cpc&utm_campaign={campaignid}&utm_adgroup={adgroupid}&utm_content={creative}&utm_term={keyword} ``` ## Steps to fix your tracking template ::::WorkflowBlock :::WorkflowBlockItem Open your **Google Ads** account. ::: :::WorkflowBlockItem Navigate to Admin (located at the bottom of the left-hand menu) and select Account Settings. ::Image[]{src="https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=-1974624067/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FhA3vKTdFyiYVXnjlwX5P%252Fimage.png%3Falt%3Dmedia%26token%3D93b788b6-a0cc-4359-b132-b6e7ac50a440" size="50" width="353" height="462" isUploading="false" darkWidth="353" darkHeight="462" showCaption="false"} ::: :::WorkflowBlockItem Expand the Tracking section. ::Image[]{src="https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=199601964/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252Fc1boNYdPIoqRsr4FKtYK%252Fimage.png%3Falt%3Dmedia%26token%3Dbaacac01-9e2c-4576-aa46-0bd946b183e6" size="90" width="1021" height="414" isUploading="false" darkWidth="1021" darkHeight="414" showCaption="false"} ::: :::WorkflowBlockItem Add the required tracking template, then Save your changes. ::: :::: :::hint{type="warning"} Avoid using third-party tools that generate dynamic tracking templates. If such a tool is currently active, disable it to ensure Fibr can read your URL parameters correctly and use your ads for personaliz ::: [title] Integrations [path] / [title] Integrate Google Tag Manager [path] Integrations/ ::Iframely{originalUrl="https://youtu.be/8bHxGeGeM8U?si=z8GJa9RiLjSE1SrF" embedUrl="https://youtu.be/8bHxGeGeM8U?si=z8GJa9RiLjSE1SrF" title="How to connect Google Tag Manager to Fibr?" html="
"} ## What You’ll Need - "Manage Integrations Access" in the Fibr Dashboard - A valid Google Tag Manager account - Access to the appropriate GTM container - Publishing permissions in GTM ## Step-by-Step Integration Guide :::::WorkflowBlock :::WorkflowBlockItem Navigate to Settings > Integrations on the Left-Hand Menu on the Dashboard ::: :::WorkflowBlockItem Click the Connect button on the GTM card. ::: ::::WorkflowBlockItem Sign in to your Google Account connected to Google Tag Manager(GTM) and allow access when prompted. :::hint{type="success"} This method uses **OAuth 2.0 Authorization Code Flow**, a secure industry-standard process. This process is secure, fully compliant with Google’s API policies, and does not expose your credentials to Fibr. ::: :::: :::WorkflowBlockItem Select and Link Your GTM Container. Follow these steps to link your GTM container: - On the GTM connection page, click on the Google Tag Manager button. This will open your GTM dashboard in a new tab. - Inside GTM, select the container you wish to connect. - Copy the URL of the container page. - Paste this URL back into the Fibr dashboard and click Next. ::: :::WorkflowBlockItem Review the list of default variables and tags to sync and Approve the list. ::: :::WorkflowBlockItem Choose and Approve Fibr events (e.g., impressions, conversions) you’d like GTM to track. ::: :::WorkflowBlockItem Publish Your Changes in GTM - Go back to your GTM Dashboard. - Open the container you linked. - Click Submit > Publish > Continue to apply the changes. ::: :::WorkflowBlockItem Return to the Fibr dashboard and click Approve to finalize the setup. ::: ::::: ## What Fibr Sends to the GTM Data Layer Once connected, Fibr pushes events to the data layer each time a visitor sees a variantt. These events allow you to route important personalization and experiment data into platforms like GA4, Meta Ads, Mixpanel, and more via GTM. Event Name: **fibr\_track\_event** | Variable | Description | | --------------------------- | ----------------------------------------------- | | fibr\_session\_id | User session information ID | | fibr\_user\_id | Fibr unique user ID | | fibr\_variation\_id | Fibr experience user ID | | fibr\_variation\_name | Fibr experience name | | fibr\_campaign\_type | Personalization or Experiment | | fibr\_campaign\_name | Fibr campaign name | | fibr\_campaign\_id | Fibr campaign ID | | fibr\_event | Always set to fibr\_track\_event | | fibr\_workflow\_id | Fibr workflow ID | | fibr\_campaign\_group\_name | Name of the personalization or experiment group | These variables are automatically added to your GTM container during the integration process and can be used to create: - Data Layer Variables - Triggers - Custom Tags This setup gives you full control to build cross-platform tracking and analytics workflows using the data Fibr provides. [title] Integrate Google Analytics (GA4) [path] Integrations/ ::Iframely{originalUrl="https://youtu.be/bw121b4rf84?si=jA5rTlaTS97y_T5L" embedUrl="https://youtu.be/bw121b4rf84?si=jA5rTlaTS97y_T5L" title="How to integrate Google Analytics (GA4) with Fibr?" html="
"} ## What You’ll Need - "Manage Integrations Access" in the Fibr Dashboard - A valid GA4 account - Read and Write access to the GA4 Account ## Step-by-Step Integration Guide :::::WorkflowBlock :::WorkflowBlockItem Click on **Settings** on the Fibr dashboard ::: :::WorkflowBlockItem Navigate to **Integrations**. ::: :::WorkflowBlockItem Click on Connect to integrate GA4 to Fibr Dashboard. ::: ::::WorkflowBlockItem Sign up to your Google Account connected to Google Analytics(GA4) and allow access when prompted. :::hint{type="success"} This method uses **OAuth 2.0 Authorization Code Flow**, a secure industry-standard process. This process is secure, fully compliant with Google’s API policies, and does not expose your credentials to Fibr. ::: :::: :::WorkflowBlockItem Select the Account, Property and Measurement ID. ::: ::::: Once connected, Fibr starts sending a fibr\_impression\_event. Whenever a user views an experience, we’ll send an event to GA4 called fibr\_impression\_event. That event will contain the following properties: - `fibr_session_id`**: **The unique id of a visitor session - `fibr_user_id`: The unique user ID assigned to the visitor - `fibr_variation_id`: The unique ID of the variation that the user saw - `fibr_variation_name`: The name of the variation that the user saw - `fibr_campaign_group_id`: The unique id of the Personalization or Experiment to which the variation belongs - `fibr_campaign_group_type`: The campaign type. This can have 2 values: - Personalization: This specifies that the variation loaded was of a personalization - Experiment: This specifies that the variation loaded was of an experiment - `fibr_campaign_group_name`: The name of the Personalization or Experiment to which the variation belongs - `fibr_campaign_name`: The name of the campaign to which the variation belongs - `fibr_campaign_id`: The unique ID of the campaign to which the variation belongs - `fibr_workflow_id`: The workflow to which the campaign belongs - `fibr_campaign_group_name`: \< Name of personalization or experiment > - `fibr_client_id`: This is a unique identifier for the client - `fibr_is_qualified`: This parameter is to determine whether the user qualified for a personalization or not [title] How to Sync New or Updated Ad Campaigns in Fibr [path] Integrations/Integrate Meta Ads Platform/ Whenever new ads are created or existing ads are updated, they must be synced with Fibr to ensure accurate tracking and personalization. To sync your Google Ads, click Sync Ads in the top-right corner of the dashboard (located just left of the Disconnect button). ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FwiesjtJMRmF32Y6gBQdO%252Fimage.png%3Falt%3Dmedia%26token%3D99fa67e5-185c-44b2-8cc1-7e6c41299fcc&width=768&dpr=3&quality=100&sign=c1efdfd27b66c92ab46279bd5abbbda8&sv=3" size="40" width="388" height="146" isUploading="false" darkWidth="388" darkHeight="146" showCaption="false"} When you select Sync Ads, you’ll see two options for syncing your ad campaigns: - Sync Existing Ad Campaigns - Sync New Ad Campaigns ## Sync Existing Ad Campaigns Choose "**Sync Existing Ad Campaigns"** if you have added new ads or updated any campaigns that were previously synced to the Fibr Dashboard. When this option is selected, Fibr re-syncs all existing campaigns to detect and import any updates or newly added ads. ## Sync New Ads Campaigns Select **Sync New Ad Campaigns** if you want to import campaigns that have not been synced to the Fibr Dashboard before. Choose the campaigns you wish to add, and Fibr will sync them so you can begin creating personalized experiences for those ads. :::hint{type="info"} The Ad campaigns sycned earlier will be pre-selected and blocked. ::: ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252Fkkpz5HYThAWqBw2SEaT6%252Fimage.png%3Falt%3Dmedia%26token%3D9ca84c4e-d464-4550-aefb-b8f711d40364&width=768&dpr=3&quality=100&sign=df42f680f1d17ca69a58e691a0a37f8f&sv=3" size="40" width="835" height="833" isUploading="false" darkWidth="835" darkHeight="833" showCaption="false"} Once synced, Fibr will retrieve ad details, including key metrics like conversion rates, tracking parameters, and more, offering in-depth analysis to support your personalization efforts and helping you craft tailored experiences based on the ad context. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FWvt1328aQy0gtJOOtDnr%252Fimage.png%3Falt%3Dmedia%26token%3D5193dbd1-217a-4329-ae21-90dba0abcaf3&width=768&dpr=3&quality=100&sign=2273998cc1dd0b3d9dfa1d916cef52e0&sv=3" size="90" width="2304" height="1335" isUploading="false" darkWidth="2304" darkHeight="1335" showCaption="false"} :::hint{type="danger"} If your tracking parameters aren’t set up properly according to Fibr’s requirements, Fibr won’t be able to use the ads for personalization. Please [click here](docId\:ZLegT2tVSD4xg0Gf86Sgt) to learn more about how to fix the tracking parameters. ::: [title] Integrate Mixpanel [path] Integrations/ Connect Mixpanel to see how your Fibr experiences influence real user behavior. Once connected, every time a visitor sees a personalized experience or converts, Fibr sends that event straight into your Mixpanel project—so you can measure the impact of your personalizations and experiments right alongside the rest of your product analytics. ## What you'll need Fibr sends events using the **Mixpanel snippet already loaded on your page**. Make sure your site is running your own Mixpanel instance before you connect—otherwise the connection will succeed but no events will appear. You'll need three things from Mixpanel, all created inside your own Mixpanel organization: - **Service Account Username** - **Service Account Secret** - **Project ID** ## Step-by-Step Guide of Mixpanel Integration ::::WorkflowBlock :::WorkflowBlockItem Log in to the Fibr Dashboard and Navigate to **Settings** -> **Integration** ![](https://archbee-image-uploads.s3.amazonaws.com/eXG5mhkZvuhxpNtTfbyHp/IfpE01AUzuDlOV-4Mkyqy_image.png) ::: :::WorkflowBlockItem Navigate to the Mixpanel Card and Click on Connect. ![](https://archbee-image-uploads.s3.amazonaws.com/eXG5mhkZvuhxpNtTfbyHp/-G48xWBXdhk2mTlVGvO1Q_image.png) ::: :::WorkflowBlockItem Add the **Service Account Name, Service Account Secret, and Project ID.** ![](https://archbee-image-uploads.s3.amazonaws.com/eXG5mhkZvuhxpNtTfbyHp/Tbz8iqs8m170KAyuYJBZ6_image.png) ::: :::WorkflowBlockItem Click Connect to complete the **Mixpanel** **Integration** ![](https://archbee-image-uploads.s3.amazonaws.com/eXG5mhkZvuhxpNtTfbyHp/imusiXFlakZD9mYdp_owF_image.png) ::: :::: Troubleshooting | **Symptom** | **Likely cause** | **Fix** | | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | Connection fails right away | Wrong username/secret pair, or the secret was copied incorrectly. | Regenerate the Service Account in Mixpanel and re-enter both values. | | 403 error when connecting | The Service Account isn't scoped to the Project ID you entered. | Confirm the Project ID matches the project the Service Account was created under. | | Status shows **Connected**, but no events appear in Mixpanel | Your Mixpanel snippet isn't on the page, consent hasn't been granted, or the event toggle is off. | Confirm Mixpanel is loaded on the page, check the consent state, and make sure **Send Events to Mixpanel** is enabled. | | Events show up in preview but never in production | Expected behavior—preview mode intentionally suppresses sends. | Not a bug. Validate on a live page instead. | ## Managing and disconnecting - Your Service Account secret is **encrypted at rest** and never shown again after you enter it. - To disconnect, remove the integration in **Integrations → Mixpanel**. This deletes the stored credentials and marks the connection as disconnected. Events stop sending. [title] What Fibr Sends to Mixpanel [path] Integrations/Integrate Mixpanel/ Fibr sends two events, tracked directly through your own Mixpanel instance: | Event | Fires when | | ------------------- | ---------------------------------------------------------------------------------- | | `FIBR_SESSION_VIEW` | A visitor views a page that carries a Fibr experience. | | `FIBR_CONVERSION` | A success metric fires, or a journey, auxiliary, or variable-tracking event fires. | Each event includes these properties: | Property | Description | | -------------- | --------------------------------------------------------------------------------------------- | | experienceId | ID of the personalization or experiment shown. | | experienceName | Human-readable campaign name. | | campaignName | Name of the campaign the experience belongs to. | | url | Page URL where the event occurred. | | eventType | Internal event classification. | | eventName | page\_view for views; the underlying event name otherwise. | | experienceType | Variant or Control. Control covers both a holdout and a visitor who saw the default Original. | :::hint{type="success"} **No personal or per-visitor data is sent: **Events carry only experience and campaign identifiers and the page URL—no visitor or session IDs, and nothing personally identifiable. ::: ## When events do and don't fire Events fire when: - The **Send Events to Mixpanel** toggle is on, and - Your Mixpanel snippet is loaded on the page, and - Any required cookie consent has been granted. A few things to know: - **Consent:** If you use cookie consent, visitors must grant **Performance-category** consent for events to fire. If you haven't configured consent, events fire normally by default. - **Preview mode:** Events never fire while previewing an experience, so testing never touches your production Mixpanel data. - **Failures are silent and safe:** If your Mixpanel instance is missing or a send fails, tracking fails quietly without affecting your other integrations. [title] Untitled [path] / [title] What is Fibr Editor? [path] Fibr Editor/ Fibr Editor is a Chrome Extension which lets you modify your landing pages directly in your browser, without writing code or waiting on developers. Change text, swap images, adjust styling, add pop-ups, and more, all through a visual interface that shows exactly what visitors will see. ## Why Use Fibr Editor? **No developer bottlenecks**: Create and launch variants yourself. No tickets, no code reviews, no waiting for the next sprint. **See changes in real-time:** The editor shows your actual page. What you see is exactly what visitors will see. **Collaborate with your team:** Marketing and product teams can work together visually, making it easier to align on changes before going live. **Safe experimentation:** Test ideas without touching your production code. If something doesn't work, roll back instantly. ## Getting Started The Fibr Chrome Extension Editor allows users to create and manage experiments or personalization campaigns visually with zero dependency on engineering and real-time collaboration between marketing and product teams. To enable Fibr Editor, install the [Fibr Chrome Extension](https://chromewebstore.google.com/detail/fibr-studio/kaifjbkibnnoehbjaaapmnkepmhigibi?pli=1) from the Chrome Web Store and add it to Chrome. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FNiW9CCK9hqBAhFwM0fYQ%252Fimage.png%3Falt%3Dmedia%26token%3D880652ac-29c4-4cfe-ba04-45e129ae7563&width=768&dpr=3&quality=100&sign=516a08d13ebf412c54cd6d7e37278ce5&sv=3" size="80" width="2304" height="1193" isUploading="false" darkWidth="2304" darkHeight="1193" showCaption="false"} [title] Key features of Fibr Editor [path] Fibr Editor/ Fibr Editor gives you full control over your landing pages without touching code. Here's everything you can do. ## Content Editing **Edit any element:** Click on any text, image, video, or button to modify it. Change headlines, update CTAs, swap product images, or replace video embeds. The editor works with most standard HTML elements. **Delete elements:** Remove anything that doesn't belong in your variant. Hide distracting sections, remove outdated banners, or simplify the page for specific audiences. Deleted elements only disappear in your variant; the original page stays intact. **Add widgets:** Insert new components like pop-ups, notification bars, countdown timers, or lead capture forms. Widgets help you add functionality without editing your site's codebase. ## Layout Control **Move and rearrange elements:** Drag sections to reorder your page. Move testimonials above the fold, reposition CTAs, or restructure content flow. The editor maintains your page's layout integrity so nothing breaks. **Resize elements:** Adjust the dimensions of containers, images, and sections. Make a hero image larger, shrink a sidebar, or expand a content block to fill more space. **Group elements:** In Controlled Mode, you can group related elements together. This ensures they load as a unit, preventing awkward partial rendering where some elements appear before others. ## Styling Change visual properties Update fonts, colors, spacing, and backgrounds without CSS. Make a button stand out with a new color, increase text size for readability, or adjust padding for better visual balance. - What you can style: - Font family, size, weight, and color - Background colors and images - Padding and margins - Border styles and radius - Text alignment - Opacity and visibility ## Advanced Editing **Change logs:** Every edit is tracked. You can view saved changes, review drafts, and see the complete history of modifications for each variant. **Conflict detection:** When editing for different devices (desktop vs. mobile), Fibr flags potential conflicts. This helps you catch issues where a change looks great on desktop but breaks the mobile experience. **Draft and publish workflow:** Save work-in-progress as drafts without affecting live experiences. When you're ready, publish with one click. Need to undo? Revert to any previous version instantly. ## Device-Specific Editing **Desktop and mobile views:** Switch between device views to see how your changes look on different screen sizes. Make device-specific adjustments when a single design doesn't work everywhere. **Responsive preview:** Preview your variant across common breakpoints before publishing. Catch layout issues before visitors do. ## Quick Reference | **Feature** | **What It Does** | | ------------------ | --------------------------------------------------- | | Edit Element | Modify text, images, videos, buttons, and more | | Delete Element | Remove any element from your variant | | Add Widgets | Insert pop-ups, banners, and interactive components | | Move/Rearrange | Drag elements to reorder page sections | | Resize | Adjust dimensions of containers and images | | Group Elements | Bundle elements to load together (Controlled Mode) | | Style Changes | Update fonts, colors, spacing, and backgrounds | | HTML Edit | Make direct code changes for advanced customization | | Change Logs | Track all edits with full version history | | Conflict Detection | Identify issues across device views | [title] Limitations of Fibr Editor [path] Fibr Editor/ Fibr Editor is powerful, but it has boundaries. Understanding these limitations upfront helps you plan better and avoid frustration. For most cases, there's a workaround or alternative approach. ## Browser Limitations **Chrome only** Fibr Editor runs as a Chrome extension. It doesn't work in Firefox, Safari, Edge, or other browsers. Make sure your team uses Chrome when creating or editing variants. **Extension must be active** The editor only works when the Chrome extension is installed and you're signed in. If you're having issues, check that the extension is enabled and you're logged into the correct workspace. **Element Limitations** **Some elements can't be edited** Fibr works with standard HTML elements, but certain elements may not be editable: - Elements loaded dynamically via JavaScript after page load - Content inside iframes (like embedded videos or third-party widgets) - Elements with heavy JavaScript manipulation (e.g., some React or Vue components) - Canvas elements and WebGL content - Content generated by third-party scripts **Workaround:** For elements Fibr can't select, use the HTML edit feature to target them directly, or work with your development team to make those elements accessible. **Complex single-page applications (SPAs)** Websites built entirely with React, Angular, or Vue may have limited compatibility. Fibr works best when the DOM structure is stable. If your site heavily manipulates the DOM after load, some edits may not persist correctly. **Workaround:** Test thoroughly in preview mode. For SPA-heavy sites, consider having developers expose stable container elements that Fibr can target reliably. ## Styling Limitations **Inherited styles may override changes** If your site uses CSS with high specificity or !important declarations, Fibr's style changes might not take effect. The editor applies inline styles, which can be overridden by aggressive CSS rules. **Workaround:** Use HTML edit mode to add inline styles with !important, or work with your development team to reduce CSS specificity on elements you want to personalize. **Custom fonts require availability** You can change font families, but the font must be already loaded on your page or available as a web-safe font. Fibr doesn't upload or host custom fonts. **Workaround:** Ask your development team to load any additional fonts you need in the site's CSS, then reference them in Fibr. ## Functional Limitations **No backend changes** Fibr modifies the front-end presentation layer only. It cannot: - Change server-side logic or API responses - Modify database content - Alter form submission destinations - Affect authentication or user sessions **Workaround:** For backend-dependent personalization, work with your development team to create front-end hooks that Fibr can trigger. **No cross-page persistence** Edits apply to individual pages. If you change a header on Page A, it won't automatically change on Page B, even if they share the same template. **Workaround:** Use Fibr's bulk editing feature to apply similar changes across multiple pages efficiently. **Limited form modification** You can edit form labels, placeholder text, and styling. However, you cannot: - Add new form fields that submit data - Change where form data is sent - Modify form validation logic **Workaround: **Use widgets to add supplementary lead capture forms that integrate with Fibr's tracking. ## Performance Considerations **Very large pages may slow the editor** Pages with thousands of DOM elements or heavy media content can make the editor less responsive. The live page won't be affected, but editing may feel sluggish. **Workaround:** Close unnecessary browser tabs, or edit on a simplified staging version of the page first. **Multiple conflicting tools** If you're running other visual editing tools, heatmapping scripts, or optimization platforms simultaneously, they may conflict with Fibr. **Workaround:** Disable other visual editing tools while using Fibr Editor. They can run alongside Fibr in production without issues; conflicts mainly occur during editing. | **Use Case** | **Why It Doesn't Fit** | **Alternative** | | ----------------------------- | -------------------------------- | ------------------------------------------------------- | | Building pages from scratch | Fibr edits existing pages | Use Fibr Genesis to create new landing pages | | Major site redesigns | Too many interdependent changes | Work with developers for structural changes | | E-commerce product data | Product info comes from backend | Use your e-commerce platform's tools | | Dynamic user-specific content | Requires backend personalization | Integrate with your CDP for data-driven personalization | **When to Involve Developers** Fibr Editor handles most marketing-driven changes independently. But some scenarios benefit from developer support: - Making elements "Fibr-friendly" for easier targeting - Loading additional fonts or assets you want to use - Creating stable container elements in SPAs - Setting up backend integrations for advanced personalization - Resolving CSS specificity conflicts A small amount of developer time upfront can significantly expand what you can do with Fibr independently. [title] Untitled [path] / [title] Untitled [path] / [title] Untitled [path] / [title] Success Metric in Fibr Campaigns [path] Analytics and Tracking/ On Fibr, you can define two types of events for every campaign: - **Primary Metric: **The main conversion event for the campaign. Only one event can be set as the primary metric. - **Secondary Metrics: **Other success events that are not primary conversions but indicate engagement. All success metrics apart from the primary metric are treated as secondary metrics. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FSXsFcaatYsMOa8gAfNtB%252Fimage.png%3Falt%3Dmedia%26token%3D9e2163aa-b108-48d3-a411-16c7f150b400&width=768&dpr=3&quality=100&sign=5af8967f8b300e018dd34cb798ca8599&sv=3" size="50" width="1808" height="440" isUploading="false" darkWidth="1808" darkHeight="440" showCaption="false"} On Fibr, you can track your success metrics in couple of ways: 1. **Using GTM: **You can use your existing GTM tags to define your success metric. Fibr seamlessly connects with your Google Tag Manager workspace (details on the setup can be found here). This integration enables us to replicate and monitor the metrics you've configured with GTM on your page. We advise adopting this approach if you use GTM to track your page's metrics. It guarantees consistency between the data displayed on your native analytics dashboard and the Fibr dashboard, eliminating discrepancies, which is crucial for accurate conversion tracking. :::CtaButton{label="How does GTM works in Fibr" openInNewTab="true" indent="2"} ::: 2. **Using Fibr Inline Tracking: **In case you dont have a GTM setup, you can always rely on Fibr Inline Tracking. With Fibr Inline Tracking you can track conversions in 2 ways: - Click Tracking: Track user interactions such as: - CTA button clicks - Link clicks - Any clickable element on the page :::Paragraph{indent="3"} Fibr's visual editor enables you to assign click-tracking metrics to any element on your page, facilitating the tracking of additional metrics that may not be monitored via GTM. ::: :::CtaButton{label="How to add Click Tracing on a Page?" docId="_udejApV3OPKdVNzM43Mg" openInNewTab="true" indent="3"} ::: :::Paragraph{listStyleType="disc" indent="2"} Page Tracking: Track conversions based on the Thank You page, that is, when a user lands on a specific URL after completing an action on the landing page. ::: :::CtaButton{label="How to add Page Tracing on a Page?" docId="OoO5K1Cjv-jt7J8smGKQ0" openInNewTab="true" indent="3"} ::: [title] How to add Page Tracking on a Page? [path] Analytics and Tracking/Success Metric in Fibr Campaigns/ Track conversions based on the Thank You page, that is, when a user lands on a specific URL after completing an action on the landing page. ## Step-by-Step Guide to Add Page Tracking on a Page: ::::WorkflowBlock :::WorkflowBlockItem Navigate to the Campaign Details page for the selected campaign. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252Feywov0BupjWBZTvzjCPq%252Fimage.png%3Falt%3Dmedia%26token%3D9744520c-3e5a-4859-8498-1f3bd83ffd79&width=768&dpr=3&quality=100&sign=f43d9dab6f062503497f4494d1ab8526&sv=3" size="80" width="2304" height="1301" isUploading="false" darkWidth="2304" darkHeight="1301" showCaption="false"} ::: :::WorkflowBlockItem Click on Add a Metric and select "Add Page Tracking" ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FkxZ1gzyhzGABGnFXDAT6%252Fimage.png%3Falt%3Dmedia%26token%3Defe3e169-4620-42f0-b5f1-35c54dbe4567&width=768&dpr=3&quality=100&sign=b4033a9e54ba22bbbc38682db0f08597&sv=3" size="80" width="1914" height="1072" isUploading="false" darkWidth="1914" darkHeight="1072" showCaption="false"} ::: :::WorkflowBlockItem Select the "Page Tracking Metric" you want to track. ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/eXG5mhkZvuhxpNtTfbyHp/V9DiMMqon4iHhfrHLAawF_image.png" size="80" isUploading="false" width="768" height="394" darkWidth="768" darkHeight="394" showCaption="false"} ::: :::WorkflowBlockItem In case you want to add a new page as your "Page Tracking Metric" then click on "Add a New Page" ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FRhOdyH6dcWMMSeoFIGf5%252FUntitled%2520design%2520%2820%29.png%3Falt%3Dmedia%26token%3Ddcba8280-79d0-43d6-871c-043dacdd8846&width=768&dpr=3&quality=100&sign=6b380b6e327c7bb076f55e84f8247516&sv=3" size="80" width="1920" height="1080" isUploading="false" darkWidth="1920" darkHeight="1080" showCaption="false"} ::: :::: [title] How do the GTM metrics work on Fibr? [path] Analytics and Tracking/Success Metric in Fibr Campaigns/ GTM Metrics makes it simple for you to use existing metrics to track personalization performance on Fibr. ## Tag Duplication and How GTM Metric Tracking Works This step is required for Fibr to track the exact same metrics that you are already tracking with your analytics tool. We do it in a way such that no customer data is received by Fibr, even if you have configured it in your original tag. In tag duplication, Fibr creates a custom HTML tag on GTM, which informs Fibr's system once a metric is fired. In order to achieve the firing at the same time as your original tag, we create a trigger, which is a combination of your original trigger and a Fibr script load trigger. This compound trigger ensures that every time your original tag is fired, the Fibr tag also fires, thus maintaining data sanity across your analytics and Fibr analytics. This way of setting up GTM ensures that Fibr does not miss any user activity you are already tracking and that the customer data remains intact within your systems. :::CtaButton{label="How to integrate GTM?" docId="9mdiKgPZ4J1ZlXuK8-zhr" openInNewTab="true"} ::: [title] Understanding Fibr Analytics Dashboard [path] Analytics and Tracking/Analytics Dashboard/ [title] Analytics Dashboard [path] Analytics and Tracking/ Learn how to navigate Fibr's Analytics Dashboard to track performance, analyze key metrics, and gain actionable insights to optimize campaigns and conversions. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FJAC0eqCF5c6DZ3xxvLZw%252Fimage.png%3Falt%3Dmedia%26token%3D6d0fc5a1-be6b-43ae-9e21-28714b8f0f2a&width=768&dpr=3&quality=100&sign=fb79f2eb9f29fce9e2f5364bb631fda3&sv=3" size="80" width="1919" height="992" isUploading="false" darkWidth="1919" darkHeight="992" showCaption="false"} The Fibr Analytics Dashboard provides comprehensive insights into your campaigns' performance. It tracks conversion rates, sessions, and conversions across all your personalization variants, helping you measure the impact of your personalization efforts. ## What can you do - Monitor conversion rates over time - Compare personalization variants against your original page - Measure conversion lift from personalization - Analyze behavioral data through GA4 integration [title] Compliance & Permissions [path] / Write short, task‑focused guides to help users accomplish common goals. Use the examples below to understand how different blocks can improve clarity and guide users effectively. ::::::::Tabs :::::::Tab{title="Using workflows"} Use `/workflow` blocks to guide users through multi‑step tasks. Enhance steps with `/callout` blocks or visuals shown in the **Adding media** tab. ::::::ExpandableHeading ### Workflows and Callouts examples :::::WorkflowBlock ::::WorkflowBlockItem Step 1: Do something :::hint{type="info"} ℹ️ **Note** This is a callout example. ::: :::: :::WorkflowBlockItem Step 2: Continue to the next action ::: ::::WorkflowBlockItem Step 3: Finish the task :::hint{type="success"} ✅ **Sucess** Task was completed successfully. ::: :::: ::::: :::::: ::::::: ::::Tab{title="Adding media"} Add screenshots, videos, or diagrams to make steps easier to follow. Use `/image` for UI captures, `/video` for demonstrations, and `/mermaid` for flow diagrams that clarify logic or data movement. :::ExpandableHeading ### Media examples ### Image ![](https://archbee-image-uploads.s3.amazonaws.com/bNBm7nPJgXjbjLyfbHNh2/MQk6T7Z7WcvmMNS5qACfY-20260402-115228.png) ### Video ::embed[]{url="https://www.youtube.com/watch?v=BZoYneeqxzM"} ### Mermaid ```mermaid graph TD; A-->B; A-->C; B-->D; C-->D; ``` ::: :::: :::::::: *** ::::::ExpandableHeading ## Example how‑to: connect a data source ### Goal Describe what the user will accomplish by connecting a data source. ### Steps :::::WorkflowBlock :::WorkflowBlockItem Open **Settings > Data sources** ::: ::::WorkflowBlockItem Click **Add new data source** :::hint{type="warning"} Different data sources may require additional permissions. Make sure the account you’re using has the correct access. ::: :::: :::WorkflowBlockItem Select your provider from the list ![]() ::: :::WorkflowBlockItem Enter required credentials or API keys ::: :::WorkflowBlockItem Test the connection ::: ::::WorkflowBlockItem Save the configuration :::hint{type="success"} Connection successful! You can now use this data source across the product. ::: :::: ::::: :::::: ### Notes :::hint{type="warning"} Users often skip important configuration steps. Remind them to review each instruction carefully. ::: :::hint{type="success"} Once you complete a guide, consider linking to related how‑tos or deeper documentation to help users continue their workflow. ::: / [title] Untitled [path] / [title] How to add Click Tracking on a page? [path] Analytics and Tracking/Success Metric in Fibr Campaigns/ Fibr's WYSIWYG Editor allows you to track all the clickable elements of a page. To setup your Fibr Editor, click here. ## Step-by-Step Guide to Add Click Tracking on a Page: ::::WorkflowBlock :::WorkflowBlockItem Navigate to the Campaign Details page for the selected campaign. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252Feywov0BupjWBZTvzjCPq%252Fimage.png%3Falt%3Dmedia%26token%3D9744520c-3e5a-4859-8498-1f3bd83ffd79&width=768&dpr=3&quality=100&sign=f43d9dab6f062503497f4494d1ab8526&sv=3" size="80" width="2304" height="1301" isUploading="false" darkWidth="2304" darkHeight="1301" showCaption="false"} ::: :::WorkflowBlockItem Click on Add a Metric and select "Add Click Tracking" ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252Fz2KHykJumAR3FNWTE2Xq%252Fimage.png%3Falt%3Dmedia%26token%3D3c4b1245-ddf7-4404-9ba7-737fe33084d5&width=768&dpr=3&quality=100&sign=5151c92e2c0e97df36ce5e9fac154995&sv=3" size="80" width="1271" height="715" isUploading="false" darkWidth="1271" darkHeight="715" showCaption="false"} ::: :::WorkflowBlockItem In the Fibr editor, select the element you want to track clicks on. ::Image[]{src="https://archbee-image-uploads.s3.amazonaws.com/eXG5mhkZvuhxpNtTfbyHp/sTNekgGhumngDbzbPCuDx_image.png" size="80" isUploading="false" width="768" height="434" darkWidth="768" darkHeight="434" showCaption="false"} ::: :::WorkflowBlockItem On the right Edit section scroll down and select Track Clicks. You can either "Select an existing metric" or "Create a new metric". ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FbOCBlGKyRgoq01ggyfRl%252Fimage.png%3Falt%3Dmedia%26token%3D318864ad-ec0a-451e-b920-d00a02bfdfa0&width=768&dpr=3&quality=100&sign=a09aac5d1d94be60f497f69724e38180&sv=3" size="80" width="1278" height="666" isUploading="false" darkWidth="1278" darkHeight="666" showCaption="false"} ::: :::WorkflowBlockItem Add the Metric and click anywhere on the editor to save it. Then click the Save button to save the metrics. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FFzIev2WCoL5vXjac0v1q%252FScreenshot%25202026-03-05%2520at%25201.47.11%25E2%2580%25AFPM.png%3Falt%3Dmedia%26token%3Da1989dd0-84ca-42eb-8686-40c201f458de&width=768&dpr=3&quality=100&sign=a453d7eaf71a6dd2b7164aef3586db35&sv=3" size="80" width="2304" height="1305" isUploading="false" darkWidth="2304" darkHeight="1305" showCaption="false"} ::: :::WorkflowBlockItem Review the metrics for Mobile as well. Once you've reviewed the changes, click on **Save.** ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252F7SA3UXKvTM3uA5uR3vzl%252Fimage.png%3Falt%3Dmedia%26token%3D12e4f2fa-731d-4f2c-9df3-fe784aa6e347&width=768&dpr=3&quality=100&sign=8ae6582d0f801d362a10ec560e407b51&sv=3" size="80" width="2304" height="1291" isUploading="false" darkWidth="2304" darkHeight="1291" showCaption="false"} ::: :::WorkflowBlockItem The metric will now be saved in the success metrics section. ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FRiWlyVy2KOARLfj7OkCW%252Fimage.png%3Falt%3Dmedia%26token%3D21ae402b-13d6-468c-8c4a-876a683749cc&width=768&dpr=3&quality=100&sign=0ac31f4ee2ff1f05020869aadb3fd638&sv=3" size="80" width="2304" height="1294" isUploading="false" darkWidth="2304" darkHeight="1294" showCaption="false"} ::: :::: [title] Sign Up & Login [path] / [title] Inviting Team Members [path] Team/ ## Access Requirements To invite or manage team members, your account must have the **Manage Users** permission. :::hint{type="info"} By default, Admins and Owners can invite and manage other users. ::: Other roles can invite users only if they have been assigned the required permission through a custom role. :::hint{type="info"} The user who creates the workspace is typically assigned the **Owner** role. ::: ## How to invite your Team Members? ::::WorkflowBlock :::WorkflowBlockItem **Open Settings** Select **Settings** from the left navigation menu. ::: :::WorkflowBlockItem **Open Team Settings** Select **Team** from the Settings menu. ::: :::WorkflowBlockItem Select Invite User ::: :::WorkflowBlockItem Enter the User's Details. Enter the team member's work email address. Select the appropriate system or custom role based on the access they require. Review the details and select **Invite**. ::: :::WorkflowBlockItem User Receives the Invitation Fibr sends an invitation email containing a unique invitation link to the specified email address. The invitation link is: - Unique to the invitation - Valid for 72 hours - Intended for one-time use The recipient must use this link to join the intended Fibr workspace. ::: :::WorkflowBlockItem User Accepts the Invitation The invited user selects the invitation link and signs in or creates their Fibr account using an available authentication method. After successful authentication: - The invitation is validated. - The user is added to the workspace. - The assigned role and permissions become active. - The user appears in the **Team** section. ::: :::: ## Invitation Status Workspace administrators can manage outstanding invitations from **Settings > Team**. Depending on the invitation status, an Admin or Owner can: - View pending invitations - Resend an invitation - Revoke an invitation - Review accepted users - Update a user's role If an invitation expires before it is accepted, resend it to generate a new link. ## Troubleshooting | Issue | Possible Cause | Resolution | | ---------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Invite User option is not available | Your account does not have the required user-management permission. | Contact a workspace Owner, Admin, or user with the required permission to send the invitation or update your access. | | Invitation email not received | The email may have been filtered by the recipient's email provider or corporate security settings. | Ask the recipient to check their spam or junk folder and confirm that the email address entered is correct. You can also resend the invitation from Settings > Team. | | Invitation link has expired | Invitation links are valid for 72 hours. | Resend the invitation from Settings > Team. The recipient should use the newly generated invitation link. | | Invitation link is invalid | The invitation may have expired, been revoked, or already been accepted. | Check the invitation status in Settings > Team. Resend the invitation if required. | | User joined a different workspace | The user may have signed up independently instead of using the workspace invitation link. | Ask the user to use the invitation link associated with the intended workspace. Contact support\@getfibr.co if additional assistance is required. | | Unable to resend or revoke an invitation | Your account may not have permission to manage team members. | Confirm that your account has the required user-management permission. If not, contact a workspace Owner or Admin. | [title] Sign Up & Login Flow [path] Sign Up & Login/ Fibr supports multiple authentication methods, allowing individuals and enterprise teams to access their workspace using their preferred identity provider. ## SignUp/Login Methods You can create or access your Fibr account using the following methods: | **Method** | **Recommended For** | **Requirements** | | ------------------------ | -------------------------------------------------------------- | ----------------------------------- | | **Google** | Teams using Google Workspace | Google account | | **Microsoft** | Teams using Microsoft 365 or Microsoft Entra ID | Microsoft account | | **Email and Password** | Users who prefer email-based authentication | Valid email address | | **Single Sign-On (SSO)** | Enterprise organizations using centralized identity management | Enterprise plan with SSO configured | After signing in, you will be directed to the **Fibr Dashboard**, where you can configure your website, connect supported advertising and analytics platforms, create experiments, and build personalized experiences. To get started, go to the Fibr Sign Up page and select your preferred authentication method. ::::::Tabs :::::Tab{title="Google"} ::::WorkflowBlock :::WorkflowBlockItem Select Continue with Google on the Fibr login page. ::: :::WorkflowBlockItem Select the Google account you want to use. ::: :::WorkflowBlockItem Review and approve the requested permissions, if prompted. ::: :::WorkflowBlockItem After successful authentication, you will be redirected to the Fibr Dashboard. ::: :::: ::Image[]{src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F80aS5Lqrk8qDoq5OTbgm%2Fuploads%2FV73fvteueNGKHsgUJxN7%2FChoose%20Account%20Step%20%7C%20Google.png?alt=media&token=6bdd29c8-1b1b-4e5e-853b-b3e314eb2ffa" size="90" width="1142" height="642" isUploading="false" darkWidth="1142" darkHeight="642" showCaption="false"} :::hint{type="success"} **Security Note: **Google authentication uses OAuth 2.0. Your Google password is entered directly with Google and is not shared with Fibr. ::: ::::: :::::Tab{title="Microsoft"} ::::WorkflowBlock :::WorkflowBlockItem Select Continue with Microsoft on the Fibr login page. ::: :::WorkflowBlockItem Sign in using your Microsoft account. ::: :::WorkflowBlockItem Review and approve the requested permissions, if prompted. ::: :::WorkflowBlockItem After successful authentication, you will be redirected to the Fibr Dashboard. ::: :::: ![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F80aS5Lqrk8qDoq5OTbgm%2Fuploads%2FnV5XuWDlrpwxsnHg2DfU%2Fimage.png?alt=media&token=4faff542-4be8-4dca-a6f6-badd31bdb272) :::hint{type="success"} **Security Note: **Authentication is handled through Microsoft's identity platform. Your Microsoft credentials are entered directly with Microsoft and are not shared with Fibr. ::: ::::: :::::Tab{title="Email"} ::::WorkflowBlock :::WorkflowBlockItem Enter your email address and click **Continue.** ::: :::WorkflowBlockItem Check your inbox for the verification email. ::: :::WorkflowBlockItem Select the verification link in the email to confirm your email address. ::: :::WorkflowBlockItem Create your password to complete account setup. ::: :::WorkflowBlockItem Sign in to access your Fibr workspace. ::: :::: ::Image[]{src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F80aS5Lqrk8qDoq5OTbgm%2Fuploads%2FGuS2yCmIQpK2XdEXON0X%2Fimage.png?alt=media&token=8ac52ac1-7eb8-42c3-a138-f03682e0c069" size="90" width="2146" height="976" isUploading="false" darkWidth="2146" darkHeight="976" showCaption="false"} :::hint{type="success"} **Security Note: **Email verification is required to confirm ownership of the email address. Fibr does not expose account passwords to workspace administrators or Fibr users. ::: ::::: :::::Tab{title="SSO"} :::hint{type="info"} SSO is available for organizations with an eligible Enterprise plan and must be configured for your organization's workspace. ::: Fibr supports enterprise authentication through compatible identity providers, such as Okta, Microsoft Entra ID, and Ping Identity, depending on your organization's configuration. ::::WorkflowBlock :::WorkflowBlockItem Select Continue with SSO. ::: :::WorkflowBlockItem Enter your organization's domain, for example, acme.com. ::: :::WorkflowBlockItem You will be redirected to your organization's identity provider. ::: :::WorkflowBlockItem Authenticate using your corporate credentials. ::: :::WorkflowBlockItem After successful authentication, you will be redirected to your authorized Fibr workspace. ::: :::: :::BlockQuote Don't see the SSO option? Your organization may not have it enabled yet. Check with your IT admin or contact us at *support\@getfibr.co* to get it set up. ::: ::::: :::::: ## Troubleshooting | **Issue** | **Possible Cause** | **Resolution** | | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Verification email not received | The email may have been filtered, delayed, or sent to an incorrect address. | Check your spam or junk folder, confirm the email address entered during sign-up is correct, and select **Resend email**. If the issue persists, contact **support\@getfibr.co**. | | “Domain Not Allowed” error | Your email domain may not be authorized for the workspace. | Contact your workspace administrator or IT administrator to confirm that your domain is configured correctly. If additional assistance is required, contact **support\@getfibr.co**. | | Google or Microsoft authentication option is unavailable | Browser settings, extensions, or authentication restrictions may be blocking the login flow. | Refresh the login page, disable extensions that may block authentication requests, or try using a private or incognito browser window. | | “Email already exists” error | An account may already be associated with the email address. | Return to the login page and sign in using the authentication method previously associated with the account. For email and password authentication, select **Forgot Password** if required. | | SSO login redirects repeatedly or times out | The identity-provider session may have expired or the SSO authentication flow may not be completing successfully. | Close existing Fibr and identity-provider tabs, open a new browser window, and try signing in with SSO again. If the issue continues, contact your IT administrator or **support\@getfibr.co**. | [title] Roles & Permissions [path] Team/ Fibr workspaces support role-based access so teams can collaborate across campaigns, experiments, integrations, and workspace administration while maintaining clear permission boundaries. Invite colleagues to your Fibr workspace and assign the appropriate role based on the level of access they require. ## Fibr Roles Fibr includes four built-in system roles. Built-in system roles are managed by Fibr and cannot be modified or deleted. | **Role** | **Recommended For** | **Access** | | ------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | **Owner** | Workspace owners and primary account administrators | Full access to workspace features, permissions, integrations, campaigns, setup, and billing. | | **Admin** | Team leads and workspace administrators | Administrative access across the workspace, including users, roles, campaigns, integrations, and setup. Billing management is restricted. | | **User** | Marketers, CRO teams, and campaign operators | Standard workspace access for viewing and managing campaigns, along with read access to most workspace features. | | **Developer** | Engineering, implementation, and technical teams | Access to integrations, SDK setup, and implementation-related configuration without campaign or billing administration. | ## Custom Roles Organizations that require more granular access control can create custom roles. Custom roles allow workspace administrators to define access based on specific permissions, such as: - Managing users - Managing roles and permissions - Creating campaigns - Publishing campaigns - Managing integrations - Configuring the Fibr Script - Managing brand guidelines - Accessing Fibr tools and insights - Viewing or managing billing Users can be assigned custom roles in the same way as system roles. ## Permission Matrix | **Feature** | **Permission Scope** | **What It Allows** | | ------------------- | ------------------------ | ------------------------------------------------------- | | Team Management | users.read | View team members in the workspace | | Team Management | users.manage | Invite and manage team members | | Roles & Permissions | roles.read | View roles and their permissions | | Roles & Permissions | roles.manage | Create, edit, and delete custom roles | | Campaigns | campaigns.read | View campaigns | | Campaigns | campaigns.manage | Create and edit campaigns | | Campaigns | campaigns.publish | Publish or end campaigns | | Billing | billing.read | View billing and plan information | | Billing | billing.manage | Manage billing and subscriptions | | Integrations | integrations.read | View connected and available integrations | | Integrations | integrations.manage | Configure and manage integrations | | Integrations | integrations.use | Use connected integrations within campaigns and tools | | Setup | setup.read | View Fibr Script and SDK setup information | | Setup | setup.manage | Manage Fibr Script or SDK setup and validation | | Brand Guidelines | brand\_guidelines.read | View workspace brand guidelines | | Brand Guidelines | brand\_guidelines.manage | Create or edit workspace brand guidelines | | Tools | tools.read | View existing tool reports and AI-generated insights | | Tools | tools.manage | Create and manage tool reports, CRO tools, and AI tools | ## Troubleshooting | Issue | Possible Cause | Resolution | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Unable to change a team member's role. | Your account may not have the required user-management or role-management permission. | Confirm that your assigned role allows you to manage users and roles. Contact a workspace Owner or Admin if additional access is required. | | Unable to assign the Owner role | Only an existing Owner can assign the Owner role to another user. | Ask the current workspace Owner to perform the role assignment. | | Unable to assign the Admin role | Only an Owner or Admin can assign the Admin role. | Confirm that you are signed in as an Owner or Admin. | | User does not have expected access after a role change | The newly assigned role may not contain the required permissions, or the user may have another role affecting their effective access. | Review all roles assigned to the user and verify that the required permission scopes are included. | | User retains access after a role is removed | The user may have another assigned role that grants the same permission. | Review all roles assigned to the user. Fibr combines permissions across multiple roles. | | Unable to remove or modify a system role | System roles are protected and their permissions cannot be edited. | Assign a different system role or create a custom role with the required permissions. | [title] Fibr Script [path] / [title] What is Fibr Script [path] Fibr Script/ The Fibr Script is what connects your website to Fibr. It's a small code snippet that you add once, and it enables everything Fibr does: experiments, personalization, tracking, and real-time optimization.Without it, Fibr can't see your visitors or deliver dynamic experiences. With it, your site can adapt to every campaign, audience, and condition automatically.How It WorksWhen someone visits your site, the Fibr Script runs instantly and does three things: 1. Identifies the visitor. It checks who they are based on your configured rules: which ad they clicked, what audience segment they belong to, whether they're new or returning, their location, and more. 2. Finds the right experience. If the visitor matches any of your active experiments or personalization campaigns, Fibr selects the appropriate variant. 3. Delivers it immediately. The experience loads client-side during page render. Your visitor sees the personalized version without any flicker, delay, or visible swap. This all happens in milliseconds. Your site adapts dynamically without requiring any additional deployments or engineering work. ## Best Practices for Installation - Place it in the \ tag The script needs to load early in the page lifecycle to work correctly. Add it inside the \ section of your HTML. - Put it above other scripts Position the Fibr Script at the top of your \, before analytics tags, tracking pixels, or other third-party scripts. This ensures Fibr initializes first and can deliver the right experience before anything else runs. - Avoid script conflicts If you have multiple scripts that modify page content or load asynchronously, they can interfere with Fibr's timing. Keep your \ clean and test after adding new scripts. - Validate before launching campaigns Before you create experiments or personalization campaigns, confirm the script is working: - Go to Settings → Setup → Validate in your Fibr Dashboard - Enter your URL and click Check - You'll see a confirmation if the script is firing correctly [title] Integrate Google Ads Platform [path] Integrations/ ::Iframely{originalUrl="https://youtu.be/zJfZNCfUTfc?si=Pv2ToLF6XeksgQsP" embedUrl="https://youtu.be/zJfZNCfUTfc?si=Pv2ToLF6XeksgQsP" title="How to integrate Google Ads with Fibr Dashboard?" html="
"} ## What You’ll Need - "Manage Integrations Access" in the Fibr Dashboard - A valid Google Ads account - Edit access to the Google Ads Account ## Step-by-Step Integration Guide :::::WorkflowBlock :::WorkflowBlockItem Go to Settings on the Fibr Dashboard ::: :::WorkflowBlockItem Navigate to **Integrations**. ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=1435384812/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252F8oeVIzXOOSEejwCZRMwJ%252Fimage.png%3Falt%3Dmedia%26token%3D48b66916-f455-4194-a904-f8d8aa845e9c) ::: :::WorkflowBlockItem Navigate to the **Google Ads **card and click on **Connect**. ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=595018958/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252F26w20fTQExDnXBKcR8MH%252Fimage.png%3Falt%3Dmedia%26token%3D8872c280-4539-494c-969e-5c5646dd2a7e) ::: ::::WorkflowBlockItem Sign in to your **Google Ad account **through** Google ***OAuth 2.0 ***Login.** :::hint{type="success"} This method uses **OAuth 2.0 Authorization Code Flow**, a secure industry-standard process. This process is secure, fully compliant with Google Ads API terms and privacy standards. ::: ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=1661351109/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FbbrKp5LdreDqessCvUTs%252Fimage.png%3Falt%3Dmedia%26token%3Db15d5cc4-5c37-4f43-8d6f-32951481b96e) :::: :::WorkflowBlockItem Grant Fibr permission to access your Google Ads data (read access). ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=173430869/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FDIOI3rVfCOv1BALIez9j%252Fimage.png%3Falt%3Dmedia%26token%3Dde0be979-8a9d-475d-bac4-b2d2a02acacd) ::: ::::WorkflowBlockItem Select the Account ID and Name ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=1469651802/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FNX2ZDbjP6tAG9VZGreun%252Fimage.png%3Falt%3Dmedia%26token%3D8bff929c-0919-4f94-aef7-a1c7edb6ea65) :::hint{type="info"} Once you have connected your Google Ads account, Fibr will fetch the Ad Campaigns List. ::: :::: :::WorkflowBlockItem Select the Campaigns you want to sync with Fibr. ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=505203327/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FMyxZGOmexvGY3QxqZEgw%252Fimage.png%3Falt%3Dmedia%26token%3D33026c8e-c897-4d18-a57e-bfbb54f2e6cf) The Sync takes several minutes to be completed depending on the number of campaigns selected. ![](https://images.gitbook.com/__img/dpr=2,width=760,onerror=redirect,format=auto,signature=454274172/https%3A%2F%2Ffiles.gitbook.com%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FaRDgrv3plECewWtKScIy%252Fimage.png%3Falt%3Dmedia%26token%3Db0389607-2e6f-453b-8703-1cd4edc42aa9) ::: ::::: :::hint{type="danger"} If your ads tracking parameters are not aligned with Fibr requirements, you will get an error saying "Ads are missing tracking template". To fix the error, please click here. ::: :::hint{type="warning"} If you make any changes to your Google Ads, return to the dashboard and click on the "Sync Ads" button to refresh the data from the Google Ads account. ::: [title] How to Sync New or Updated Ad Campaigns in Fibr [path] Integrations/Integrate Google Ads Platform/ Whenever new ads are created or existing ads are updated, they must be synced with Fibr to ensure accurate tracking and personalization. To sync the Google Ads, click on "**Sync Ads" **on the top right corner of the dashboard (to the left of "**Disconnect" **button). ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FwiesjtJMRmF32Y6gBQdO%252Fimage.png%3Falt%3Dmedia%26token%3D99fa67e5-185c-44b2-8cc1-7e6c41299fcc&width=768&dpr=3&quality=100&sign=c1efdfd27b66c92ab46279bd5abbbda8&sv=3" size="40" width="388" height="146" isUploading="false" darkWidth="388" darkHeight="146" showCaption="false"} To sync your Google Ads, click Sync Ads in the top-right corner of the dashboard (located just left of the Disconnect button). When you select Sync Ads, you’ll see two options for syncing your ad campaigns: - Sync Existing Ad Campaigns - Sync New Ad Campaigns ## Sync Existing Ad Campaigns Choose **Sync Existing Ad Campaigns** if you have added new ads or updated any campaigns that were previously synced to the Fibr Dashboard. When this option is selected, Fibr re-syncs all existing campaigns to detect and import any updates or newly added ads. ## Sync New Ad Campaigns Select **Sync New Ad Campaigns** if you want to import campaigns that have not been synced to the Fibr Dashboard before. Choose the campaigns you wish to add, and Fibr will sync them so you can begin creating personalized experiences for those ads. :::hint{type="warning"} The Ad campaigns sycned earlier will be pre-selected and blocked. ::: ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252Fkkpz5HYThAWqBw2SEaT6%252Fimage.png%3Falt%3Dmedia%26token%3D9ca84c4e-d464-4550-aefb-b8f711d40364&width=768&dpr=3&quality=100&sign=df42f680f1d17ca69a58e691a0a37f8f&sv=3" size="40" width="835" height="833" isUploading="false" darkWidth="835" darkHeight="833" showCaption="false"} Once synced, Fibr will retrieve ad details, including key metrics like conversion rates, tracking parameters, and more, offering in-depth analysis to support your personalization efforts and helping you craft tailored experiences based on the ad context. ![](https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252FyyimI3P2IYQLyIxfoUN1%252Fimage.png%3Falt%3Dmedia%26token%3D879ec447-82a2-4ae8-828c-1fb1ebff827c\&width=768\&dpr=3\&quality=100\&sign=f70efe537f277f08f10213c31d13b1a0\&sv=3) :::hint{type="danger"} If your tracking parameters aren’t set up properly according to Fibr’s requirements, Fibr won’t be able to use the ads for personalization. Please [click here](docId\:OK5k9oN_yyN3bjv2OO4Sr) to learn more about how to fix the tracking parameters. ::: [title] How to set URL Parameters on Meta Ads? [path] Integrations/Integrate Meta Ads Platform/ Fibr syncs Meta Ads via URL parameters in each ad. Missing or incorrect parameters will prevent those ads from being used for personalization within Fibr. ## Requirements for valid configuration of ads To ensure your ads sync correctly and can be used for Ads Personalization, your Google Ads Tracking Template must include at least one variable from below: - \{\{adset.id}} or \{\{adset.name}} - \{\{ad.id}} or \{\{ad.name}} :::hint{type="info"} For the best results, Fibr recommends including *all* of the above variables in your Tracking Template. This ensures full compatibility and maximizes the accuracy and depth of Ad Personalization. ::: **Recommended Tracking Template: ** ```javascript {lpurl}?utm_source={{site_source_name}}&utm_medium=cpc&utm_campaign={{campaign.name}}&utm_content={{adset.name}}&utm_term={{ad.name}} ``` *or* ```javascript {lpurl}?utm_source={{site_source_name}}&utm_medium=cpc&utm_campaign={{campaign.id}}&utm_content={{adset.id}}&utm_term={{ad.id}} ``` ## Steps to fix your Meta Ads URL Parameters ::::WorkflowBlock :::WorkflowBlockItem Identify the Meta Ads that have invalid or missing URL parameters. ::: :::WorkflowBlockItem Open **Facebook Ads Manager** and select the campaign and ad set containing the affected ad. ::: :::WorkflowBlockItem Navigate to the **Ad level** by opening the ad set and selecting the specific ad. ::: :::WorkflowBlockItem Scroll to the **Tracking** section, locate the **URL parameters** field, and click **“Build a URL parameter.”** ::Image[]{src="https://sites.gitbook.com/preview/site_YrVoe/~gitbook/image?url=https%3A%2F%2F3335504681-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F80aS5Lqrk8qDoq5OTbgm%252Fuploads%252F1mUln3n0fkHvDgtvG8ZO%252Fimage.png%3Falt%3Dmedia%26token%3D19203c14-1f4b-4e3a-a359-f756ad51d21f&width=768&dpr=3&quality=100&sign=660d99918d5d29c3ed7ed8d0d52b3fbf&sv=3" size="50" width="846" height="272" isUploading="false" darkWidth="846" darkHeight="272" showCaption="false"} ::: :::WorkflowBlockItem Click Apply to save your changes, then Publish the updated ads. ::: :::: :::hint{type="warning"} Avoid using third-party tools that generate dynamic tracking templates. If such a tool is currently active, disable it to ensure Fibr can read your URL parameters correctly and use your ads for personalization. ::: [title] Overview [path] / Fibr is an AI-powered platform that helps you understand, test, and optimize every page on your website without writing code or waiting on developers. Get an overview of Fibr's features, integrations, and how to use them to personalize web experiences, run experiments, and optimize conversions at scale. ::::VerticalSplit{layout="middle"} :::VerticalSplitItem - **Fibr AI** - [Sign Up & Login](docId\:xnj8-y0z9JXQgjoQ5-8pm) - [Team](docId\:JHtmoSFnpjMRS51ZqZQbb) - [Integrations](docId\:BJ--t9KspYGSysbgPWac1) - [Fibr Script](docId\:NBiB9cha4Wj1X0Yt83TD0) ::: :::VerticalSplitItem - **Fibr Personalization** - **Fibr Experimentation** - [Success Metric in Fibr Campaigns](docId\:WykhUExEyUnqcUetcbJ-i) - **Fibr Tools** - [Compliance & Permissions](docId:1gY8g6XVeXrKOksmVsTwS) ::: :::: [title] Untitled [path] /