- Set up CDN self-hosting using Amazon Cloudfront
If you need to download and self-host the Optimizely snippet on your own site, Amazon Cloudfront offers an easy way to do it, via multiple AWS services working together. And because this approach involves setting up a webhook in Optimizely, there will be no need for you to poll for any revisions in your snippet.
Self-hosting is ideal for customers who are using HTTP/2 to serve their website and Amazon Cloudfront as their CDN. By self-hosting, you can eliminate an SSL connection to Optimizely while using multiplexing to request the snippet faster.
While self-hosting with an HTTP/1 connection may eliminate an additional DNS lookup and the SSL handshake, there is no guarantee the script will begin its download earlier than if it was being downloaded directly from Optimizely.
This article will describe how to set up a Lambda function to listen for changes in your Optimizely snippet, how to save that snippet to your S3 bucket, how to call that script from your website, and how to set up your webhook.
This article will help you sync the Optimizely snippet into an S3 bucket, and it, therefore, assumes you are using Cloudfront with an S3 origin.
Create a Lambda function
The first step in the process is to create a new Lambda function. This function will listen for the Optimizely webhook and update your local version of the snippet.
From the AWS interface, create a new Lambda function, starting with a blueprint.
When you create the Lambda function, you can opt to use either NodeJS or Python3. The examples used in this sequence show Python3.
Give your new function a descriptive name, such as
Create a new IAM role, or use an existing IAM role for this function that has access to both:
Amazon S3 (policy:
Amazon CloudWatch logs (policy:
Next, create the function. This will enable you to edit your code.
YOUR-AWS-S3-BUCKET-NAMEwith the bucket where you'd like to store your copy of your Optimizely snippet.
Below is an example of an appropriate Lambda function:
This example configures the function to only accept POST requests, parse that request (based on a successful POST request), and save the Optimizely snippet to your AWS S3 Bucket. The snippet is saved as
After saving your edits to the function, navigate to your API gateway trigger.
Under the API Gateway section, take note of your API endpoint. You'll need this later for setting up your Optimizely webhook.
Configure the Optimizely webhook
In Optimizely, open the project you'd like to self-host and navigate to Settings.
Navigate to the Webhooks tab and click Create New Webhook…
You will be prompted for a URL where a POST request can be sent each time your snippet is updated. Enter the URL of your Lambda API endpoint from step 6 above.
Configure a custom TTL (optional)
To configure a custom TTL for this script, you will need to change your cache setting in your Cloudfront distribution from Customize to Use Origin Cache Headers.
You will then be able to include a cache-control setting in the function that writes the Optimizely data to S3.
If you want your base Cloudfront TTL settings to apply to this script as well, leave Object Caching set to Customize.
Modify the Optimizely snippet
If the Optimizely snippet is already installed on your page, you'll need to remove it and replace it with the new script tag that references your self-hosting path.
If you are new to Optimizely, just add this new script tag in the appropriate spot inside the <head> tag on your page.
The format of this snippet should be:
should now be:
Repeat this step for any additional snippets you may have across your site.
Don't forget, the
/snippet/PROJECTID.js portion is from the Lambda code, and should reflect what's in your Lambda function.