# Segmentify - Segment Partner Destination Documentation

---
title: [Segmentify](/9F5R7sL9SjG080-iQ5Mq8g) Destination
---

## Template begins here...

> Include a 1-2 sentence introduction to your company and the value it provides to customers - updating the name and hyperlink. Please leave the utm string unchanged.

[Segmentify Personalisation Platform](https://www.segmentify.com/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) provides self-serve predictive analytics for growth marketers, leveraging machine learning to automate audience insights and recommendations.

> Update your company name and support email address.

This destination is maintained by Segmentify. For any issues with the destination, [contact the Segmentify Support Team](mailto:[e-mail]).

> Update your company name (x2) and support email address.

## Getting Started

{% include content/connection-modes.md %}

1. From the Destinations catalog page in the Segment App, click **Add Destination**.
2. Search for **"Segmentify"** in the Destinations Catalog, and select the "Segmentify" destination.
3. Choose which Source should send data to the Segmentify destination.
4. Go to the [Segmentify Dashboard](https://v3.segmentify.com/)[target=_blank], navigate to "Settings > Account Settings", find and copy "Api Key" and "Account Domain".
5. Enter the **"Api Key"** and **"Account Domain"** in the Segmentify destination settings in Segment.

## Supported Methods

Segmentify supports the following methods, as specified in the [Segment Spec](/docs/connections/spec).

### Page

Send [Page](/docs/connections/spec/page) calls to track different page types and also run recomendation, search and engagement campaigns.

For more details check **page view** of web integration documentation on [Segmentify Dev Docs](https://segmentify.github.io/segmentify-dev-doc/integration_web/#page-view).

Example calls for page tracking is given below:

/* 
 * Update Page Name for different pages
 * Minimum required page types for Segmentify:
 * - Home Page
 * - Product Page
 * - Category Page
 * - Basket Page
 * - Checkout Page
 * - Search Page
 * - 404 Page
 */

// Home Page Example
analytics.page('Home Page', {
    pageUrl: 'https://www.exampleshop.com/exaple-page/',    
    referrer: 'https://www.externalpage.com'
});

// Product Page Example
analytics.page('Product Page', {
    subCategory: 'Men>Shoes>Sports'
});

Segment sends Page calls to Segmentify as a `pageview` event with the custom parameters provided in page call:

{
    "page_name": "Product Page",
    "subCategory": "Men>Shoes>Sports",
    "url": "https://www.exampleshop.com/exaple-page/",
    "referrer": "https://www.externalpage.com"
}

### Identify

Send [Identify](/docs/connections/spec/identify) calls to identify current visitor or customer.

For more details check **user operations** of web integration documentation on [Segmentify Dev Docs](https://segmentify.github.io/segmentify-dev-doc/integration_web/#uservisitor-operations).

Example calls for identify is given below:

/* 
 * Description for the fields
 * 
 * username: unique username. Username is used to match Segmentify tracking with your customer identification
 * fullName: Full name of the customer
 * email: Email address of the customer. This must be supplied to use current customer in outbound email campaigns
 * phone: Mobile phone number of the customer. Example: '[phone]’
 * gender: Gender of the customer. Possible values are M or F
 * age: Age of the customer, must be numeric. Example: 27
 * location: Location of the customer. Example: 'New York'
 * custom: Custom parameters for the customer, must be in map format
 */

// Home Page Example
analytics.identify('idXXXXXX', {
    username: 'janedoe',
    fullName: 'Jane Doe',
    email: '[e-mail]',
    phone: '[phone]',
    gender: 'F',
    age: '27',
    location: 'New York',
    memberSince: '23.01.2022',
    custom: {
        'CUSTOM FIELD 1': 'CUSTOM VALUE 1',
        'CUSTOM FIELD 2': 'CUSTOM VALUE 2'
    }
});

Segmentify uses Segment's userId or username as unique visitor identifers.

Segment sends Identify calls to Segöemtify as an `identify` event with the custom parameters provided in identify call:

{
    "userId": "idXXXXXX",
    "type": "identify",
    "traits": {
        "username": "janedoe",
        "fullName": "Jane Doe",
        "email": "[e-mail]",
        "phone": "[phone]",
        "gender": "F",
        "age": 27,
        "location": "New York",
        "memberSince": "23.01.2022",
        "custom": {
            "CUSTOM FIELD 1": "CUSTOM VALUE 1",
            "CUSTOM FIELD 2": "CUSTOM VALUE 2"
        }
    }    
}

### Track

Send [Track](/docs/connections/spec/track) calls to track different events like:
* Product Viewed
* Product Added
* Product Removed
* Cart Viewed
* Order Completed

Segmentify is using [Ecommerce V2 Event Spec of Segment](https://segment.com/docs/connections/spec/ecommerce/v2/)

For more details check **product view, basket and checkout operations** of web integration documentation on Segmentify Dev Docs:
* [Product View](https://segmentify.github.io/segmentify-dev-doc/integration_web/#product-view)
* [Basket Operations](https://segmentify.github.io/segmentify-dev-doc/integration_web/#basket-operations)
* [Checkout Operations](https://segmentify.github.io/segmentify-dev-doc/integration_web/#checkout-operations)

Example calls for identify is given below:

// Product Viewed
analytics.track('Product Viewed', {
    product_id: 'EXAMPLE_PRODUCT_1',
    name: 'Example Product',
    brand: 'Example Brand',
    price: 349.99,
    old_price: 449.99,
    category: 'Men>Sports>Shoes',
    colors: ['black', 'red', 'blue'],
    sizes: ['small', 'medium', 'large'],
    labels: ['new-comer', 'top-seller'],
    url: 'https://www.exampleshop.com/example-product-1/',
    image_url: 'https://cdn.exampleshop.com/example-product-1.png',
    gender: 'M',
    params: {
        field1: 'value1',
        field2: 'value2'
    }
});


// Product Added
analytics.track('Product Added', {
    product_id: 'EXAMPLE_PRODUCT_1',
    quantity: 1,
    price: 349.99,
    currency: 'USD'
});


// Product Removed
analytics.track('Product Removed', {
    product_id: 'EXAMPLE_PRODUCT_1',
    quantity: 1    
});


// Cart Viewed
analytics.track('Cart Viewed', {
    cart_id: 'XXXXXXXXXXXXXXXX',
    products: [
    {
        product_id: 'EXAMPLE_PRODUCT_1',
        name: 'Example Product',
        price: 349,
        position: 1,
        category: 'Men>Sports>Shoes',
        url: 'https://www.exampleshop.com/example-product-1/',
        image_url: 'https://cdn.exampleshop.com/example-product-1.png'
    },
    {
        product_id: 'EXAMPLE_PRODUCT_2',
        name: 'Example Product 2',
        price: 239.99,
        quantity: 2,
        position: 2,
        url: 'https://www.exampleshop.com/example-product-2/',
        image_url: 'https://cdn.exampleshop.com/example-product-2.png'
    }]  
});


// Order Completed
analytics.track('Order Completed', {
    checkout_id: 'XXXXXXXXXXXXXXXXXXXXX',
    order_id: 'ORDER_XXXXXXXXXX',
    total: 27.50,
    subtotal: 22.50,
    revenue: 25.00,
    shipping: 3.00,
    tax: 2.00,
    discount: 2.50,
    currency: 'USD',
    payment_method: 'Visa', 
    products: [
    {
        product_id: 'EXAMPLE_PRODUCT_1',
        name: 'Example Product',
        price: 349,
        position: 1,
        category: 'Men>Sports>Shoes',
        url: 'https://www.exampleshop.com/example-product-1/',
        image_url: 'https://cdn.exampleshop.com/example-product-1.png'
    },
    {
        product_id: 'EXAMPLE_PRODUCT_2',
        name: 'Example Product 2',
        price: 239.99,
        quantity: 2,
        position: 2,
        url: 'https://www.exampleshop.com/example-product-2/',
        image_url: 'https://cdn.exampleshop.com/example-product-2.png'
    }]  
});


// Custom Event
analytics.track('MY_CUSTOM_EVENT', {
    field1: 'value1',
    field2: 'value2'
});

Segment sends Track calls to Segmentify as a `track` event.

---