# Omnisend

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FCm9cSaz14MTVMk9Y9nwe%2Fomnisend%201.png?alt=media&#x26;token=8d8694fb-8d81-4ac7-adbf-880c3d280de0" alt="" width="350"><figcaption></figcaption></figure>

***

### Website

{% embed url="<https://www.omnisend.com/>" %}

***

### Adding the Plugin

Navigate to Admin -> Plugins -> Email Service Providers.

Select the Omnisend title.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F9YXvNJAyw5K32nGuh5VV%2Fimage.png?alt=media&#x26;token=ad02a479-cb43-4bde-adec-8a84901600d9" alt=""><figcaption></figcaption></figure>

Click Activate.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FCE7Y1lCnTDuaSD6Nq9kN%2Fimage.png?alt=media&#x26;token=231378bd-27fd-49cd-9707-68b07c30eb90" alt=""><figcaption></figcaption></figure>

Fill in your Omnisend apiKey found here: <https://app.omnisend.com/integrations/api-keys>

Click Connect.

***

### Standard Event Tracking

Standard Event Tracking includes these events:

* Started Checkout
* Placed Order
* Paid for Order
* Ordered Product
* Fulfilled Order
* Cancelled Order
* Refunded Order
* Subscription Restarted

Add Standard Event Tracking for a campaign by editing the plugin and clicking +Route.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FCdiI6CY5nI5WvsQ1bQfd%2Fimage.png?alt=media&#x26;token=75cb592b-73ba-45c6-b129-3119e87df6e1" alt=""><figcaption></figcaption></figure>

Then change the Checkout Champ Campaign filter to a specific campaign or All Campaigns and click Create.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F99ugzqnCUvlvgA7Y1xP8%2Fimage.png?alt=media&#x26;token=a0c780ce-5c31-431c-9457-0e298fe739f3" alt=""><figcaption></figcaption></figure>

***

### Other Campaign Routes

Routes for other Customer Types can be added and will be sent to Omnisend as custom events.

Tags (comma separated) can be added to other routes that will be set on the Contact at Omnisend and also sent as event properties.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FnpuvXCuK4JCgQDQ0XFHj%2Fimage.png?alt=media&#x26;token=f5de8f35-4c22-4625-beac-e335fdc725f5" alt=""><figcaption></figcaption></figure>

***

### Properties Sent to Omnisend

<details>

<summary>Properties sent on all events as applicable</summary>

* platform: Checkout Champ&#x20;
* orderID
* orderDate
* orderType
* orderStatus
* campaign
* externalOrderId
* billingAddress
* shippingAddress
* currency
* lineItems
  * productID: campaignProductId in the CRM
  * productPrice
  * productQuantity
  * productSKU
  * productTitle
  * productDiscount
  * productDescriptor
  * billingCycleType
  * productDescription
  * productCategory
  * productImageURL
  * productVariantID
  * productVariantTitle
  * externalVariantDetailId
  * productVariantImageURL
  * txnResponse
  * nextBillDate
  * purchaseStatus
  * refundRemaining
* value
* shippingPrice
* subTotalPrice
* totalPrice
* totalTax
* totalDiscount
* refundRemaining
* totalAmount
* fulfillmentStatus
* shippingMethod
* tracking
  * code
  * courierTitle
* tags
* billingCycleNumber
* customer / campaign level custom fields
* Order custom1-5 values

</details>

<details>

<summary>Started Checkout</summary>

* abandonedCheckoutURL (includes products in the query string)

</details>

<details>

<summary>Ordered Product</summary>

* product
  * productID
  * productPrice
  * productQuantity
  * productSKU
  * productTitle
  * productVariantTitle
  * productDiscount
  * productDescriptor

</details>

<details>

<summary>Cancelled Order</summary>

* cancelReason

</details>

<details>

<summary>Refunded Order</summary>

* totalRefundedAmount

</details>

<details>

<summary>Subscription Restarted</summary>

* Product Name
* Purchase ID
* Subscription Status: Active
* Next Bill Date

</details>

***

### Subscribing contacts to channels

Contacts will be subscribed based on the emailOptIn and marketingOptIn parameters sent when the customer was created in the CRM or otherwise updated.&#x20;

Customers without email or SMS contact enabled in the CRM will be sent to Omnisend as non subscribed.