# Salesforce Marketing Cloud

Integrating **HIVO with Salesforce** streamlines the process of managing and distributing content, allowing marketing teams to launch campaigns faster while maintaining consistent brand messaging. This integration enables users to access, display, and manage digital assets (images, videos) directly within Salesforce — without needing to upload them manually.

<details>

<summary>Benefits</summary>

* **Faster Campaign Execution:** Speed up content creation and delivery by accessing HIVO assets directly within Salesforce.
* **Consistent Branding:** Ensure all visuals, videos, and documents are sourced from HIVO — maintaining brand consistency across every touchpoint.
* **Personalized Content:** Easily select, edit, and use assets tailored for specific audiences.
* **Improved Efficiency:** Eliminate manual steps through seamless integration, reducing time spent searching and managing content.

</details>

### **Key Features**

* **Integration & Workflow**
  * [**Seamless Embedding:**](https://support.hivo.co/integrations/salesforce-marketing-cloud#how-to-integrate-hivo-with-salesforce) Add and **embed HIVO assets directly into Salesforce content,** including emails, campaigns, and landing pages.
  * [**Secure Authentication:** ](https://support.hivo.co/integrations/salesforce-marketing-cloud#step-1-access-hivo-integration-in-content-builder)Authenticate and log in easily via **Single Sign-On (SSO)** OR log in using your HIVO account **email and password.**
  * [**Custom Domain Support**](https://support.hivo.co/integrations/salesforce-marketing-cloud#troubleshooting-alert-embed-url-feature-is-not-active-on-this-client)**:** For custom domain support, please [contact HIVO support](https://support.hivo.co/contact).&#x20;
* **Discovery & Organization**
  * [**Flexible Browsing**](https://support.hivo.co/integrations/salesforce-marketing-cloud#search-and-view-management-from-the-hivo-connector)**:** Navigate your library your way with new **Collection views and Asset/Folder views.**
  * [**Advanced Search:**](https://support.hivo.co/integrations/salesforce-marketing-cloud#step-2-search-and-select-assets-from-the-hivo-library) Locate assets instantly by keywords, or utilize Advanced Filters to drill down by file type, metadata and Date.
* **Asset Management & Transformation**
  * [**On-the-fly Resizing**](https://support.hivo.co/integrations/salesforce-marketing-cloud#resize-assets-from-hivo-connector): Use the new **Resize feature** to adjust asset dimensions directly within the integration before embedding.

### How to integrate HIVO with Salesforce

#### 🔹 **Step 1: Go to Salesforce Settings**

* Navigate to **Settings** → **Apps** → **Installed Packages**

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fdhck2FxtcYJfYX85Mc1n%2FGroup%20801.png?alt=media&#x26;token=0d46ee32-4a8e-4bf1-8b47-01003e4361f0" alt=""><figcaption></figcaption></figure>

* Select **Add New and** Enter the **Package Details** as needed (name, description, access permissions, etc.)

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FAJjCLH5SCiHxnrHfBP58%2FGroup%20802.png?alt=media&#x26;token=0b7338fc-1cac-4928-92dd-77141f3b0831" alt=""><figcaption></figcaption></figure>

#### 🔹 **Step 2: Create a Custom Content Component**

* In **Installed Packages** → Click **Add Component**&#x20;

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fj4yaDTG1daLmCeMXcAa6%2FGroup%20804.png?alt=media&#x26;token=baad236d-4274-4522-b833-fffe5f0b3a37" alt=""><figcaption></figcaption></figure>

* Select **Custom Content Block** → click **Next**

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FhVAtteIM10zLFuT38mUf%2FGroup%20805.png?alt=media&#x26;token=bc1cae4b-b5c4-4d66-b61e-b3275440a80b" alt=""><figcaption></figcaption></figure>

#### 🔹 **Step 3: Configure the HIVO Endpoint**

* Enter the **Name** and **Endpoint URL** as follows:

```
https://d1e0flt4ltuyq8.cloudfront.net/
```

* Save your configuration to **complete the connection setup.**

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Ff318gLxC6dWzR74noWAP%2FGroup%20806%20(1).png?alt=media&#x26;token=32e6a296-34c6-43d9-b6e0-c935dbbac80c" alt=""><figcaption></figcaption></figure>

### How to login HIVO in Salesforce Marketing Cloud (SFMC)

#### 🔹 **Step 1: Access HIVO Integration in Content Builder**

* &#x20;**Open Content Builder**
  * In Salesforce Marketing Cloud, select **Content Builder** from the main navigation bar.
  * Open the **Content Blocks** or **Email Templates** section where you want to add content.
* **Access HIVO Integration**
  * Click **Add Content Block** → find **HIVO Asset** (under the **Custom Blocks** section).
  * **Drag and drop** the HIVO icon into your template.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FRgC749NTUpYlBd1DyXeO%2FGroup%20810.png?alt=media&#x26;token=ecce57f8-9247-40ea-a68e-839b9e711162" alt=""><figcaption></figcaption></figure>

#### 🔹 **Step 2: Log in**&#x20;

You can log in using one of the following methods: Log in easily via **Single Sign-On (SSO)** Or Log in using your HIVO account email and password.

👉 **Method 1: Log in to Your HIVO Account using email and password**

* A **HIVO login window** will appear, enter your **HIVO Email** and **Password**.
* Once successfully authenticated, you’ll be redirected to the **HIVO Library** within Salesforce.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FDs3bcjAtxPgh4XNymERW%2FGroup%20899%20(1).png?alt=media&#x26;token=3bccfe66-7daa-4545-9b1b-33123a720152" alt=""><figcaption></figcaption></figure>

👉 **Method 2:** Log in easily via **Single Sign-On (SSO)**

* **Case 1: You have an active HIVO login session (have not logged out)**
  * The system will automatically detect your active login session.
  * You are not required to re-enter your email or password.
  * The authentication process will be completed automatically in just a few seconds.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fhiyu7u10LXxjg5JKPu4Z%2FGroup%20900%20(1).png?alt=media&#x26;token=aa75bd6b-a557-4920-82bd-7a23b681a7d3" alt=""><figcaption></figcaption></figure>

* **Case 2: You have logged out of your HIVO account**
  * When attempting to access HIVO from Salesforce, the system will automatically redirect you to the official HIVO login page for authentication.
  * Please enter your HIVO account email and password to authenticate.
  * Upon successful authentication, the system will automatically log you into HIVO within the Salesforce interface.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F5AyNgMTy1XhSEmWXMtLc%2FGroup%20901.png?alt=media&#x26;token=4149e929-cac9-4cad-ad48-f87482ee4e1e" alt=""><figcaption></figcaption></figure>

### Search and View management **from the HIVO Connector**

The HIVO Connector provides powerful tools to help you easily find and manage assets while ensuring all displayed asset adheres strictly to your corresponding HIVO permissions and access rights.

**1. Search Asset**

* Quickly locate assets using search bar, based on the asset's **name, tags**.

**2. Advanced Filtering**

Use the Filter feature to narrow down your search results based on specific asset attributes:

* Filter by **Type**: Limit results by file format (Images, Videos, Documents).
* Filter by **Metadata**: Apply filtering using custom metadata fields and their corresponding values.
* Filter by **Date**: Filter results by specific date ranges, including:
  * Added date range&#x20;
  * Produced date range

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F0ITrrCyCSWcW1XILUTYt%2FGroup%20904.png?alt=media&#x26;token=7b866edb-29c2-410d-ac34-0c61b0f1283a" alt=""><figcaption></figcaption></figure>

**3. Switch View Mode**

The HIVO Connector supports multiple view modes to accommodate various asset management and browsing styles:

<table data-header-hidden><thead><tr><th width="171.8369140625"></th><th></th></tr></thead><tbody><tr><td><strong>View Mode</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>Asset Mode</strong></td><td>Displays all assets in a list format, ideal for searching by keywords or tags.</td></tr><tr><td><strong>Folder Mode</strong></td><td>Displays the folder structure of the asset library, allowing you to navigate based on storage hierarchy.</td></tr><tr><td><strong>Collection View</strong></td><td>Displays pre-created Collections. These are groups of assets organized by theme, project, or event, independent of their physical folder location.</td></tr><tr><td><strong>Categories View</strong></td><td>Displays assets sorted by predefined Categories within the system, typically used for classification by industry or content type (e.g., Marketing, Product Shots, Event Photos).</td></tr></tbody></table>

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2Fjmj22W8TZeZZjy7xnJKC%2F1216_1_.gif?alt=media&#x26;token=2371cc4a-68b9-4905-8467-713625716f54" alt=""><figcaption></figcaption></figure>

### **Resize Assets from HIVO Connector**&#x20;

The Resize feature within the HIVO Connector allows you to instantly create new image versions with custom dimensions, ensuring these versions are synchronized back to the HIVO library.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2F31bE7YkrOQKQgf8p09xL%2F1216.gif?alt=media&#x26;token=9db622a2-5c01-4623-905f-471921684660" alt=""><figcaption></figcaption></figure>

**🔹 Step 1: Select Asset & activate Resize feature**

* In the HIVO Connector interface, select the image asset you wish to resize.
* Click the **Resize button** to open the resize configuration pop-up window.

**🔹 Step 2: Enter Name the New Version**

* Within the customization window, you must enter a Version Name for the new resized image. This name is mandatory for synchronization and storage of the resized version in your main HIVO library.

**🔹 Step 3: Customize Dimensions & Advanced Customization**

* **Customize Dimensions:**
  * **Suggested Dimensions:** Select from a list of quick, suggested size options.
  * **Select from Template:** When choosing "Template," a list of Custom Versions predefined in your HIVO’s Version Settings will be displayed for selection.
  * **Custom Dimensions**: Manually enter the desired width and height according to your specific needs.
* **Advanced Customization:**
  * Add Background (PNGs only): Allows you to add a background color if required.
  * Select Anchor Point: Set the anchor point (e.g., top-left, center) to ensure the key part of the image is maintained during cropping or resizing.

**🔹 Step 4: Apply to resize asset**

* Click the **Apply button** to complete the resizing process.
* Then, click **“Embed”** to insert the asset into the block or template.

### **Embedding Assets from HIVO Connector**&#x20;

* Select the **version** of the asset you want to add, then click **“Embed”** to insert the asset into the block or template. If you want to replace it with another asset, simply repeat this action to choose a new one.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FYN4LRyOuwuKhbw8W1oZt%2FGroup%20905.png?alt=media&#x26;token=4beb8e1e-5ca9-43b7-b71a-d89e987e5588" alt=""><figcaption></figcaption></figure>

* After selecting **“Done Editing”**, if you wish to change the inserted asset, **click directly on the asset within the block** — the **HIVO Library** will reopen, allowing you to choose a replacement.
* Once finished, click **“Save”** to save your template.

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FkjxZeGwRGvOnkKe9Wrjg%2FGroup%20815.png?alt=media&#x26;token=19f90f92-d107-485b-86e0-f1a3b7191bd5" alt=""><figcaption></figcaption></figure>

#### ⚠️ Troubleshooting Alert: Embed URL feature is not active on this client

This message indicates that your HIVO account has not been fully configured with the necessary permissions to display assets outside of the HIVO system.

* For HIVO assets to be displayed and utilized (embedded) within SFMC, your HIVO account must be configured by an Administrator with two essential options activated:
  * **Enable CDN and new Public Assets**
  * **Custom domain**
* Since the activation of these features requires high-level system administration privileges, please take one of the following steps for assistance:
  * **Contact your internal Admin**
  * **Contact the HIVO Support Team**

<figure><img src="https://2446612760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0sjg5GpIPr5HzBTJYqYe%2Fuploads%2FPLmZzp01l10MeKVEARdX%2FGroup%20906.png?alt=media&#x26;token=bcca37bb-5547-4fc2-9633-4ef4cb582461" alt=""><figcaption></figcaption></figure>

If you have any questions, don't hesitate to ask, we're always here to help!
