> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Convert

> An introduction to the Convert Destination

export const OutboundLink = ({linkText, linkTarget}) => {
  return <a target="_blank" href={linkTarget}> {linkText} 
    <div className="inline h-3 w-3 fill-gray-500 dark:fill-gray-100 text-gray-500 dark:text-gray-300 ml-1 mr-1">
      <svg className="inline w-2.5 h-2.5 bg-gray-500 dark:bg-gray-300" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/up-right-from-square.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }}></svg> 
    </div>
    </a>;
};

export const IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

## Overview

Destination Type: <IconText text="Server-side" name="server" iconType="duotone" iconLocation="after" />

<Note> This Converge Destination only supports <OutboundLink linkText="Revenue Goals" linkTarget="https://support.convert.com/hc/en-us/articles/204495499-add-revenue-tracking-to-your-site" /> in Convert.</Note>

***

## Installation instructions

<Steps>
  <Step icon="bullseye" title="1. Create a new revenue goal">
    1. In your Convert dashboard, go to **Goals**  and select **New Goal**.
    2. Click on **Revenue goal**.
           <Frame>
             <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/convert/revenue-goal.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=2710bdb69a36660c9af583538788973f" alt="revenue-goal-picker" width="898" height="324" data-path="images/destinations/convert/revenue-goal.png" />
           </Frame>
    3. Give your goal a name, e.g. `[Converge] Revenue` and choose **Manual Revenue Tracking**. You can leave Goal Description blank.
    4. Click on **Save Goal**.
    5. Copy the Revenue **Goal ID**, you will need it later.
           <Frame>
             <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/convert/goal-id.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=08c924ce2703e24dbb4e8c750652e933" alt="revenue-goal-picker" width="2191" height="386" data-path="images/destinations/convert/goal-id.png" />
           </Frame>
    6. Also write down your **Account Id**, you can find it in the top right corner of the Convert Dashboard.
           <Frame>
             <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/convert/account-id.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=57c1702f553eea7ed5c86410620ecdaf" alt="account-id" width="680" height="177" data-path="images/destinations/convert/account-id.png" />
           </Frame>
    7. Lastly, navigate to **Configuration** > **General Settings** and copy your **Project ID**.
  </Step>

  <Step icon="list" title="2. Create the Converge Destination">
    8. In the Converge sidebar, click on <IconText name="arrow-right-from-line" text="Event streams" /> and then click **Create new Destination**.
    9. Select the **Convert** destination and click **Next**.
    10. Give your destination a **name** (e.g. Convert Destination) and click **Next**.
    11. Fill in the **Account ID** and **Project ID** you copied from **Convert** and click **Next**.
    12. Click on <IconText name="plus" text="Add new mapping" /> and select Placed Order as the source event.
    13. In the Forward As value enter the **Goal ID** you copied from Convert.
    14. Select **Server** as the Forwarding Mode and click **Next**.

    <Frame>
      <img src="https://mintcdn.com/converge/dh0K_Fgr0_qazJsh/images/destinations/convert/convert-custom-mapping-example.png?fit=max&auto=format&n=dh0K_Fgr0_qazJsh&q=85&s=39b0c3e58985ffaab2ae73f28c75a7af" alt="convert-4" width="999" height="271" data-path="images/destinations/convert/convert-custom-mapping-example.png" />
    </Frame>

    15. Select the sources you want to forward events from, then click **Next**.
        <Note>This is a server-side destination, meaning that only server-side sources can be used with this destination. You can still select client-side sources but the events will not be sent to Convert.</Note>
    16. Review any issues and click **Submit**.
  </Step>
</Steps>

***

## Converge functionality

This integration supports the following Converge destination functionality.

| Converge Feature                                     |       Supported       |
| ---------------------------------------------------- | :-------------------: |
| Custom Events                                        | <Icon name="xmark" /> |
| Filters                                              | <Icon name="xmark" /> |
| Server-side Conversions                              | <Icon name="xmark" /> |
| [Conversion amount](/destinations/conversion-amount) | <Icon name="check" /> |

## Event mapping

Converge automatically maps the following events from the [Converge event spec](/sources/converge-spec) to the Convert spec.

<Note> This destination does not forward events like a regular destination. It only sends revenue data to Convert goals. </Note>

| Converge Event Name                                 | Convert   |
| --------------------------------------------------- | --------- |
| [Placed Order](/sources/converge-spec#placed-order) | `Revenue` |
