# Conversion API

In Shoppego, you can set the **Conversion API** on your **Facebook Pixel**. With this **Conversion API,** the data you will receive through your **Facebook Pixel will be&#x20;**<mark style="color:red;">**more accurate.**</mark>

{% hint style="info" %} <mark style="color:red;">**Note**</mark>: This Conversion API function is only available on the Ultimate plan. However, you can use it for " Forms."
{% endhint %}

{% embed url="<https://youtu.be/dLYwf_YcwGA>" %}

## Get an Access Token

To set up the **Facebook Conversion API**, you only need to enter the **Conversion API token** on the **Shoppego** platform. Very easy!

1. In your pixels section, select the pixels you want to use click on the Open in **Events Manager** tab

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FTgkit5Aa5lhmoVDVVtbK%2Fevent%20manager.PNG?alt=media\&token=995dc7e9-fc4a-4569-b413-4a943ff3ce46)

2\. Next, you will be taken to a new site. On this page click on the **Settings** tab

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FgadjwLUS3p7BHMEftBk0%2Fsettings.PNG?alt=media\&token=677a52ec-8b1b-4bdb-b05e-514873649298)

3\. On the settings tab, press **Get Started** in the Set up Manually column.&#x20;

{% hint style="info" %} <mark style="color:red;">**Note**</mark>: *If the button <mark style="color:red;">**cannot be pressed**</mark> make sure your email is set in **Ads Manager**.*
{% endhint %}

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FuJyyDEbPivz2iwNjSRog%2Fmanually.PNG?alt=media\&token=5f70a4f6-986e-4ffb-b59f-d6427934f902)

4. *Click **Continue**.*

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2F6tCzhm0DqBncXjaLJBhJ%2Fcontinue.PNG?alt=media\&token=050914d8-03b3-4065-b9a9-00d8c5a911e6)

5\. Tick ​​on the **Purchase event** and **Initiate checkout or Leads.** After you tick both events, you can click **Continue**

{% hint style="info" %}
For websites that use the purchase function, it is recommended that you use the Purchase and Initiate checkout event. For websites that only use the leads"Forms" function, it is recommended that you use the Leads event.
{% endhint %}

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2Fpiv1jdtM5qOBszn3FcPK%2Fi.p.PNG?alt=media\&token=86bb98a3-8d4a-4ca4-9567-5239ac1de247)

6\. Make sure **the setting of event details for your Initiate Checkout event is the same as the picture below**. Once you make sure it is the same, you can click on the **Continue** button

{% hint style="info" %}
For the Leads event, you can still follow all the parameters.
{% endhint %}

![](/files/pU0rWUpX4K7jS5oXCswQ)

7\. Next, make sure the **setting event details for the Purchase event is as shown below**. Once you make sure it is the same, you can click **Continue**

![](/files/xpFlA5F84j1RYKmbfvxp)

8\. On this page, you can make sure it is the same as on your settings display. Once you make sure it is the same you can click **Continue**

![](/files/4loA0sQeqIbxXPpcEawf)

9\. Click **Finish** and then with that your setting is complete.

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FukfqUHfLXLvNoTyj3zcN%2Ffinish.PNG?alt=media\&token=7d327538-c9e4-4696-90d3-942190860ae0)

10\. Next, you can click again on the **Settings** tab

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FgadjwLUS3p7BHMEftBk0%2Fsettings.PNG?alt=media\&token=677a52ec-8b1b-4bdb-b05e-514873649298)

11\. Get a token for your API conversion by pressing **Generate access token**. **You need to save this access token for assignment in Shoppego**.

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FBn9k0VayjFNxArrbZoZW%2Fsetup%20manually.PNG?alt=media\&token=a0d6e780-e685-45cd-b25a-5bb6fa02b08a)

### Setup in Shoppego <a href="#setup-pada-commerce" id="setup-pada-commerce"></a>

Once you have access to the Conversion API token. You are required to enter the access token into your Shoppego account.

1. Log in to your Shoppego accoun&#x74;**.** Click on **Settings -> General**. Enter your access token in the **Facebook Pixel Access** **Token** field and click the Save button

![](/files/btd9gZu6SW0PSXTjCt4C)

## Perform a Test event on the setting

1\. In your pixels section, select the pixels you want to use click on the Open in **Events Manager** tab

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FTgkit5Aa5lhmoVDVVtbK%2Fevent%20manager.PNG?alt=media\&token=995dc7e9-fc4a-4569-b413-4a943ff3ce46)

2\. Next, you will be taken to a new site. On this page click on the **Test events** tab

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2F7G4UoD5n6jkKyqvvJ9Mc%2Ftestevemts.PNG?alt=media\&token=03905565-89a4-43e8-8e99-fa4e7b660071)

3\.  In the **Test server event** tab you can save your **Test event code** by clicking on your test code box.

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FMX7jD7tkCytSElpwjlF3%2Ftest.PNG?alt=media\&token=f9f2800b-eb7a-475f-a2ec-8954232047ac)

4\. Next, you need to enter this code in the settings in Shoppego. You will need to Log back into your Shoppego account.

![](/files/lCN7aw3FznaFFoOAyya2)

5\. Click on **Settings -> General**. Make sure your Test event code is in the **Facebook test\_event\_code** field and click the Save button

![](/files/LIGt5QICVDtt1z6hg2H5)

6\. Next, you need to return to **Test Events** and enter your store domain in the **Test browser events**. When done click on the Open Website button.

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FUeGREIh8fFeeuMQq8hCZ%2FCapture.PNG?alt=media\&token=2194e8e7-4ae8-4015-b968-22a21f922e7c)

After you click the button, you will be taken to your **website page.** You can **refresh** first to ensure that the **page view even**t can be **triggered** on your **test event settings**. If it can be triggered you can **proceed to another trigger event process**.&#x20;

If your setting is successful, at the test event you will receive **Initiate checkout** and **Purchase** **events along with deduplication** information that comes from the **Server**.

![](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M9wsSS6q4a48unw5U0k%2Fuploads%2FsXKxrlQgteYFX7ycqg6j%2Fphoto_2021-12-21_11-24-21.jpg?alt=media\&token=40383796-f360-45d9-9580-ccb2cd8d4de2)

{% hint style="info" %}
**\*\* After you have finished setting this test event. You need to&#x20;**<mark style="color:red;">**delete the facebook test event code**</mark>**&#x20;in your Commerce settings. \*\***
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.shoppego.com/en/integration/tracking-and-analytics/facebook/facebook-pixel/conversion-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
