Note: Email Studio uses Image API to dynamically display content. For more details on Image API, please take a look at the Image API documentation.
Table of contents
What is Email Studio?
If you're a brand marketer looking to activate curated content in your email marketing campaigns, Email Studio is the right tool for you. Email Studio allows you to generate an HTML/CSS snippet with a click of a button, and you can simply copy & paste the code into your email template editor. The code snippet is also mobile responsive out-of-the-box, which helps you quickly embed the content without any additional coding.
If you're looking to develop your own HTML and CSS, but want to retrieve dynamic content from Social Native, you have the option of using the Image API to embed content in your email templates. Unlike the RESTful API, the Image API allows you to retrieve curated content from your Social Native Media Library without having to develop code to parse JSON responses from the standard RESTful API.
How do I use Email Studio?
The Email Studio can be found by clicking the "Email" navigation item under the "Activate" tab in the UGC Solution platform, or by visiting this URL directly: https://www.photorank.me/admin/email
Getting started
The tool is split into two main sections:
On the left, you can modify the configuration of the snippet (e.g., source, styling, and extra parameters)
On the right, you can preview the content as well as have access to the HTML/CSS snippet generated by the tool.
First, select the appropriate parameters (see the next section for details on different configuration options provided) on the left side of the tool.
Use device toggles on the top-right corner of the tool to preview the code in mobile, tablet, and desktop device widths.
Select the desired Clickthrough Link option, then enter in either a Fallback URL or a Landing Page URL (see Clickthrough link section for more details on this functionality).
Once you're ready to grab the code, click the "Get Code" button.
In the overlay, copy the code into your clipboard by clicking the "Copy code" button. Then, go ahead and paste the code from your clipboard into the editor of your choice.
You can also toggle between Responsive HTML/CSS and Non-responsive HTML code. This is helpful when you want to apply your own CSS styling for more complex display requirements.
Configuration Options
Here you can find details and descriptions of all of the different customization options that you can pick and choose from.
Content Source
Filter type – choose where you want to source your content from.
Media Library – retrieves content from your Media Library
Stream ID – retrieves content from a specific stream
Product ID – retrieves content from a specific product stream
Category ID – retrieves content from a specific category
Filter value – this text field shows up when you select either one of the following Filter type options: Stream ID, Product ID, or Category ID.
The value should correspond to the identifier of the object type that is decided by the Filter type option. You can find the identifiers under Streams, or Category section.
Stream ID and Product ID:
Category ID:
Sorting Preferences – choose how you want to order the content. For more information on each of the sorting options, please refer to our API documentation.
Recent – Sorts content by chronological order (descending)
Shuffled – Sorts content by random order. The randomness is recomputed every 30 minutes.
Photorank – Sorts content by its Photorank score. This score is predicted by the Social Native Machine Learning algorithm when the media object is registered in the system.
Clickthrough Rate – Sorts content by its click-through rate. Requires event interactions via Social Native Widgets or Analytics API.
Manual – Sorts content by the stream's manual sorting. See Featured Content – Streams on how to use this option.
Styling
Image Resolution – The resolution of the image to retrieve.
Note: if using Enable Cropping (see below) functionality, the application will use the selected Image Resolution as the source content to apply post-processing for cropping.
Square - 90x90px image. Cropped, does not maintain ratio.
Thumbnail - 150x150px image. Maintains ratio
Mobile - 320x320px image. Maintains ratio
Normal - 640x640px image. Maintains ratio
Original - Original image without modifications
Number of Images – The total number of images to display. Maximum value is 8 images.
Padding Size – The size of margin around the container and padding between the images (in pixels). Maximum value is 20 pixels.
Images per row in Mobile – The total number of images per row to display in mobile responsive view. Defaults to showing 2 images per row.
Enable Cropping – Enables cropping functionality. Source image aspect ratios may vary. In order to alleviate potential image sizing / container styling issues, cropping may be applied to keep image sizes consistent.
Crop Size – Size of the cropped image. Min/max dimensions: 5x5 to 640x640.
Crop Fit – The fit type of the cropped image. Emulates CSS3 background-size properties
Cover - Scales the image as large as possible without stretching the image. If the proportions of the image differ from the element, it is cropped either vertically or horizontally so that no empty space remains.
Contain – Scales the image as large as possible without cropping or stretching the image.
Crop Position (only available with Crop Fit = Cover) – Used to define the center position of the cropped image.
Center – focus on the center region of original image.
Entropy – focus on the region with the highest Shannon entropy.
Attention – focus on the region with the highest luminance frequency, color saturation and presence of skin tones.
Crop Background (only available with Crop Fit = Contain) – Defines the surrounding background of the cropped image.
Extras
Fallback Image URL – Used to specify the fallback image in case no image is found using the parameters. This value must be URI encoded.
Passing dynamic variables
To display product or category specific UGC in email campaigns (i.e., cart abandonment or post-purchase emails), you can amend the image URLs generated by the Email Studio.
Let's say you want to pull in product-specific content. First, click the "Get code" button to open the code snippet overlay (we're using Non-responsive code to keep the code simple).
Copy the code into your editor of choice, then in the code snippet, look inside the `src` attribute of the <img> tags. Add the parameters `&filter=product_id&filter_value=#{{product_id}}` to the end of the URL (highlighted in red)
<img src="https://...=cover&crop_position=center&position=0&filter=product_id&filter_value=#{{product_id}}" border="0" ... /><img src="https://...=cover&crop_position=center&position=1&filter=product_id&filter_value=#{{product_id}}" border="0" ... /><img src="https://...=cover&crop_position=center&position=2&filter=product_id&filter_value=#{{product_id}}" border="0" ... /><img src="https://...=cover&crop_position=center&position=3&filter=product_id&filter_value=#{{product_id}}" border="0" ... /><img src="https://...=cover&crop_position=center&position=4&filter=product_id&filter_value=#{{product_id}}" border="0" ... />
If you look at the code above, you can see that the parameter value for `filter_value` is `#{{product}}`. Replace this with the appropriate product ID variable within the email platform.
The result should be that when the email goes out to the users, the `filter_value` parameter value is replaced with the product information pertaining to the dynamic data inside the email template.
Note: Please be aware that by implementing stream/product/category specific UGC in your email campaigns, there may be a question of coverage as some products may not have enough UGC to fill the slots, or some will have none. In cases like these, the Image API displays the last image repeatedly. Alternatively, you can use the Fallback Image URL feature to display a placeholder image in place of the repeated image.
Clickthrough link
Under Clickthrough link section in the sidebar, you can configure the clickthrough logic of the images you want to display in your email.
Dynamic Routing feature allows you to link the images to the stream or product URL associated with the images. This is helpful for email marketers to implement a click-through experience without having to layer additional data on within the template inside the email platform (i.e., having to supply dynamic URLs from the ESP to the href attribute of the <a> tag that wraps the <img> tag).
When users click on the images, Social Native will dynamically route users to the product page URLs based on the product tagged to the images. If the image is tagged to multiple products, then first product tagged will be used. In cases where images are not tagged to any active products, the Fallback URL will be used instead.
You can also use the Fixed Landing Page option if you wish to link the images to a static URL of your choice.
FAQs
Question: How do I set up emails with UGCs displaying specific products. For example, in cart abandonment or post-purchase emails?
Please see Passing dynamic variables section for detailed instructions.Question: Can I use my own HTML/CSS with Email Studio?
Yes! By default, the code generated by Email Studio contains HTML and CSS. However, if you want to generate a code without HTML and CSS, you can use a toggle to generate only the image tags. Please see Getting started section for more details.Question: Is the code generated from Email Studio fully responsive?
The HTML and CSS is fully responsive out of the box. For more complex display requirements, we recommend turning off Responsive HTML/CSS in the code overlay then applying your own HTML and CSS to the image tags generated by Email Studio.Question: If my UGCs are videos, will they render in the email widget?
Videos are not supported currently. But, we are exploring this as a potential feature. We will keep you updated on any new feature releases so you don't miss out.Question: The Email Studio is really great! What if I want Social Native content to be automatically pushed to my ESP?
If you want to store UGCs in your ESP directly, you can use the standard export or create a custom application using our standard API. Since Email Studio is designed to remove the integration effort between Social Native and the email platform, we highly recommend trying out Email Studio first. 😀
Need help?
If you are experiencing any issues or have further questions, please contact our Support team.