--- title: Integrate Lytics Audience Sync App slug: data-platform/docs/integrate-lytics-audience-sync-app docTags: createdAt: 2026-08-10T12:05:19.000Z --- Import your Lytics audiences into Optimizely Data Platform (ODP) as real-time audiences. You can use these audiences across different Optimizely products, such as Optimizely Web Experimentation, Feature Experimentation, and Content Management System (CMS) Visitor Groups.  This integration uses the Lytics ODP connector to sync your Lytics audiences and convert them into real-time audiences in ODP. You can choose which customer identifiers to transfer and keep your segmentation current with near real-time audience updates. ## Prerequisites - A Lytics account - An ODP account ## Update API app consent setting You only need to complete the instructions in this section if your app consent setting for the API channel is set to **Opted Out**. This setting must be set to **Opted In** for this app to successfully send data. 1. Go to **Settings > App Consent Settings** in ODP. 2. Set the **Api** app's **Default Consent** to **Opted In**. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ReEqOwz9ep8rHhK3HVmLw_odp-app-consent-setting.png" size="90" width="1054" height="909" isUploading="false" darkWidth="1054" darkHeight="909" showCaption="false"} 3. Click **Update Consent** in the confirmation prompt. ## Configure the integration 1. Go to **Data Setup > App Directory** in ODP. 2. Select the **Lytics** app. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/-KTF8RLwBsVDBilY1YppO-20260720-145648.png) 3. Click **Install App**. 4. Go to the **Settings** tab. 5. Expand **Install Instructions** and copy the webhook URL and the request header authorization token. This is necessary to trigger audience webhooks in Lytics.   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/HYqAl6QhBMfKSMdA42rLn-20260720-145648.png) 6. (Optional) Enter a name for the customer identifier in the **Customer profile identifier field name** section. ODP uses this name to recognize and store the customer's unique ID in its internal records, specifically as `fs_user_id` and `web_user_id`. If you save the default name `_id` for the unique customer ID, select `Lytics ID` in the **Exports Fields** section when [configuring your job in the Lytics app](docId\:Ca5UNFGRvHO01azKE8HY-). This ensures Lytics sends the correct unique customer ID that ODP expects to receive under the `_id` label.    ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fcKrrisppEJKbVq1ahHR6-20260720-145648.png) 7. Click **Save**. ### Configure the audience triggers webhook in Lytics 1. Open the Lytics app. 2. Go to **Jobs** and click **+ Create New**.  ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/bWx0-dQ8o3L1wzQUIfBgG-20260720-145648.png) 3. Select **Webhook > Audience Triggers Webhook** as the job type on the **Select job** page. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ZY9UflpVYeUh-2OO8C3oJ-20260720-145648.png) 4. Enter the job **Label** and click **+ New Authorization** on the **Expiration & Auth > Set job details** page. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/N6S7cge2VWwg7p_LahvLh-20260720-145648.png) 5. Select **Provide authorization as request header or paramater** as the authorization method on the **Authorization method** page. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/8n5tUdZJBGVEIoByG7-Cl-20260720-145648.png) 6. Enter the authorization **Label** in the **Details** section on the **Configure authorization** page. In the **Configuration** section, copy and paste the webhook request authorization header you viewed in step 5 of [Configure the integration](docId\:Ca5UNFGRvHO01azKE8HY-). ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/9HW893grtymL9HrT72XqY-20260720-145648.png) 7. Click **Save and Continue**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/KpBvsLm4-i4bu15H7E9kj-20260720-145648.png) 8. Complete the following steps to select the audiences you want to sync on the **Configuration** page: - Paste the webhook URL you viewed in step 5 of [Configure the integration](docId\:Ca5UNFGRvHO01azKE8HY-). Select **POST** from **HTTPMethod** drop-down list.  ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/2-yUn68XBZ9vB6AldE0BX-20260720-145649.png) - Select **Existing Users** to sync existing records. Select **Enters and Exits** from the **Audience Trigger Events** and **Lytics ID** from the **Exports Fields** drop-down lists. Only select **Lytics ID** if you saved the default value in the **Customer profile identifier field name** in [step 6 of Configure the integration](docId\:Ca5UNFGRvHO01azKE8HY-).  ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yUwXHu9nT3n5OYSiUGCHi-20260720-145649.png" size="100" isUploading="false" showCaption="false" width="3342" height="1124" darkWidth="3342" darkHeight="1124" indent="4"} :::hint{type="info" indent="3"} **Note** The Lytics app supports array-type identifiers. If your customer identifiers are stored as arrays, you must select the same array field in both the **Export Fields** and **Fields to Trigger** sections. The selected fields must reference the same identifier array to ensure correct audience syncing. ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/h1604ORPfOmvjtTwuvc_M-20260720-145649.png" size="100" isUploading="false" showCaption="false" width="3348" height="1336" darkWidth="3348" darkHeight="1336" indent="2"} ::: :::Paragraph{listStyleType="disc" indent="2"} Select **Batch Events**. Follow the recommended batch pattern: ::: :::Paragraph{listStyleType="disc" indent="3"} **Batch Size** – 300 ::: :::Paragraph{listStyleType="disc" indent="3"} **Batch Send Duration** – 3 ::: :::Paragraph{listStyleType="disc" indent="3"} **Simultaneous Calls** – 20 ::: ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/lo8qDtqVFlPX6BQmKkFg9-20260720-145649.png" size="100" isUploading="false" showCaption="false" width="1797" height="793" darkWidth="1797" darkHeight="793" indent="3"} 9. Click **Complete** to complete the configuration. For additional details, see the [Lytics webhook documentation](https://docs.lytics.com/docs/webhooks). ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/0mOFHjw25ELu0b6ZxAdCG-20260720-145649.png" size="100" isUploading="false" showCaption="false" width="3348" height="224" darkWidth="3348" darkHeight="224" indent="3"} :::hint{type="info"} **Note** If a related real-time audience does not exist in ODP during the sync, the Lytics app automatically creates it with the new audience ID `lytics_` and the name and description `Lytics - `. ::: ## Use your Lytics audiences in Optimizely products You must configure the ODP integration with your desired Optimizely product before you can access your Lytics audiences. See the following documentation: - [Optimizely Web Experimentation](docId:8r8kPcfPk_gyXkMubzNwK) - [Optimizely Feature Experimentation](docId:6UBBxxRv331nBIVZ2lun8) ### Access your Lytics audience in Optimizely Web and Feature Experimentation To access your Lytics audience in Optimizely Web or Feature Experimentation, complete the following: 1. Open the Web or Feature Experimentation app. 2. Go to **Audiences**. 3. Edit an audience or click **Create New Audience**. 4. Expand **Real-Time Audiences**, then drag and drop the **Custom Segments** condition into the **Audience Conditions** section. 5. Expand the **Custom Segments** drop-down list and select the audience you connected from Lytics. 6. Click **Save Audience**. :::hint{type="info"} **Note** If you enabled [unified audiences](docId:84TFVeod2XQfvcgSJ5guS), you are redirected to the **Audiences** page in ODP. You can create or update an Experimentation audience in ODP, which displays under **Data Platform Audiences**, and add it to your Lytics audience. Add the audience to an experiment afterwards. :::