---
title: "Acquia-VWO Connect "
date: "2024-08-20T11:38:23+00:00"
summary: "Integrate Acquia Conversion Optimization powered by VWO with Drupal using Acquia-VWO Connect. Capture content metadata, create segments, and export custom widgets."
image:
type: "page"
url: "/conversion-optimization/acquia-vwo-connect"
id: "2256363e-b687-4f39-9906-fc7d72e2ba44"
---

Table of contents will be added

Getting started
---------------

The [Acquia-VWO Connect Drupal module](https://www.drupal.org/project/acquia_vwo) integrates your site with Acquia Conversion Optimization powered by VWO. It replicates the functionality of the [VWO module](https://www.drupal.org/project/vwo) and provides additional Acquia-specific features.

VWO enables the creation of segments, and this module provides additional Drupal-specific configurations to allow you to capture content metadata with page views in Conversion Optimization.

This module currently supports field mappings for Content Section, Content Keywords, and Persona from common content type taxonomies on the site to create segments in Conversion Optimization Testing and Conversion Optimization  Personalize.

Requirements
------------

The following are the requirements for installing and configuring the Acquia-VWO Connect module:

*   Drupal website on the [current Drupal version](https://docs.acquia.com/service-offerings/guide/software-life-cycle#supported-drupal-version)
*   Administrative access to your Drupal website
*   [Conversion Optimization](#convert) subscription
*   Conversion Optimization account ID

Installing the module and configuring the content
-------------------------------------------------

1.  From [Drupal.org](https://www.drupal.org/project/acquia_vwo), install the [Acquia-VWO Connect module](https://www.drupal.org/project/acquia_vwo) and its dependencies.
2.  On your Drupal site, click **People** > **Permissions** or access `http://[site_URL]/admin/people/permissions`.
3.  Configure user roles and permissions for VWO.
4.  Click **Configuration** > **Acquia VWO Settings** or access `http://[site_URL]/ /admin/config/system/acquia_vwo`.
5.  Configure the Acquia-VWO Connect module:
    1.  In the **VWO Account ID** field, enter the account ID.
    2.  Click **Submit**.
    3.  Click the **Extract Account ID** tab to extract the account ID.
    4.  On the **Visibility** tab, configure the visibility to show only on specific pages, roles, or content types.
    5.  On the **Field Mapping** tab, select the field that you want to use for each segment.
        
        For each segment, you can reuse existing fields or create new vocabularies and term reference fields.
        
    6.  Click **Save configuration**.
6.  To understand content types:
    1.  Click **Structure** \> **Content Type** \> **Manage Fields**.
    2.  Locate the field types with an entity reference to a taxonomy term.
    3.  Click **Taxonomy > List Terms** to view details of the data populated.
    4.  Determine whether the content is configured to capture additional taxonomy terms with data such as Category, Tags, and Persona.

Utilizing Drupal taxonomy in Conversion Optimization 
-----------------------------------------------------

1.  Go to **Personalize or Testing.**
2.  Edit or create a new campaign to edit your experience.
3.  Select **Custom Segment.**
4.  Filter by **Page Visit** to define the targeting criteria.
    
    The Drupal taxonomies are attached to a page visit. You can access the new content types in the sub criteria.
    

Acquia VWO Content Governance
-----------------------------

Acquia VWO Content Governance submodule enables you to export content from your Drupal website into VWO as custom widgets, which can be used in your VWO campaigns.

### **Configuring the Acquia VWO Content Governance submodule**

To install the Acquia VWO Content Governance submodule:

1.  Install the Acquia-VWO Connect Drupal module.
2.  On your Drupal site, click **Manage** > **Extend**.
3.  On the **List** tab, select the **Acquia VWO** and **Acquia VWO Content Governance** checkboxes.
4.  Click **Install**.
5.  On the main menu at the top, click **Configuration**.
6.   In the **System** section, click **Acquia VWO Connect Settings**.
    
    The system displays the **Acquia VWO Setup**.
    
7.  On the **Settings** tab, enter your VWO Account ID in the **VWO Account ID** field.
8.  Click **Save Configuration**.
9.  On the main menu at the top, click the **Content Governance** tab.
10.  Enter your VWO API key to authenticate the module with VWO.
     
     If you do not know your VWO API key or need to generate the API token, do one of the following:
     
     *   Click the link [https://app.vwo.com/#/developers/tokens](https://app.vwo.com/#/developers/tokens) provided below the **VWO API KEY** field.

The system redirects you to the VWO Developer Dashboard. For more information about how to generate a VWO API token, visit [How to Access VWO API?](https://help.vwo.com/hc/en-us/articles/360020559993-How-to-Access-VWO-API).

1.  Click **Save Configuration**. 

**Configuring Entities** 

*   To enable Component Content entities for VWO Export for all users other than Site Studio users:
    1.  On your Drupal site, click **Manage** > **Structure**.
    2.  Click **Content Types**.
    3.  On the Content type page, locate the content type that you want to export. 
        
        For example, Article.
        
    4.  In the **Operation** column, click the dropdown arrow and click **Edit** to modify the content type settings.
        
        The system displays the Edit Article content type page.
        
    5.  On the left menu, click **Acquia VWO Content Governance Settings**.
    6.  Select the **Make article available as Acquia VWO custom widgets** checkbox.
    7.  (_Optional_): Select the **Export all article entities as VWO custom widgets** checkbox if you prefer to always export all article entities in VWO.
        
        If you do not select this checkbox, the system provides the **Export to VWO as Custom Widget** checkbox option when creating or editing an entity of the configured entity type.
        
    8.  In **Render View Mode**, leave the default value or select the appropriate option.
    9.  In **Render Role**, leave the default value or select the appropriate option.
    10.  Click **Save**.
         
         The system exports your content to VWO and makes it accessible in **My Library** in VWO. For more information, visit [Working with Library in VWO Editor](https://help.vwo.com/hc/en-us/articles/900004432686-Working-with-Library-in-VWO-Editor).
         
*   To enable Component Content entities for VWO Export for Site Studio users:
    1.  On your Drupal site, click **Manage** > **Configuration**.
    2.  In the **System** section, click **Acquia VWO Connect Settings**.
        
        The system displays the **Acquia VWO Setup** page.
        
    3.  On the main menu at the top, click the **Content Governance** tab.
    4.  On the **Content Governance** page, click **Site Studio Configuration** to expand the menu.
    5.  Select the **Make all Site Studio Component Content entities available to VWO as Custom Widgets** checkbox.
    6.  (_Optional_): Select the **Export Site Studio Component Content entities as VWO custom widgets** checkbox if you prefer to always export all article entities in VWO.
        
        If you do not select this checkbox, the system provides the **Export to VWO as Custom Widget** checkbox option when creating or editing an entity of the configured entity type.
        
    7.  In **Render Role**, leave the default value or select the appropriate option.
    8.  Click **Save Configuration**.
        
        The system exports your content to VWO and makes it accessible in **My Library** in VWO. For more information, visit [Working with Library in VWO Editor](https://help.vwo.com/hc/en-us/articles/900004432686-Working-with-Library-in-VWO-Editor).