# Meta Ads

Integrating Meta Ads with our platform takes a few steps to get going.

<figure><img src="/files/Mov2ASI4uVzhr7iQifFx" alt=""><figcaption></figcaption></figure>

## First, create a Meta System User token

{% stepper %}
{% step %}
**Create a Meta App**

Visit [Meta Business Suite](https://business.facebook.com/) and navigate to **Settings** → **Accounts** → **Apps**.

Click **Add**, select **Create a new app ID** and click **Create App**.

Now let's set the app up:

* Set the app name to **Flip.to Integration** and click **Next**.
* Select an app use case: If you see **Measure ad performance data with Marketing API**, choose that. Otherwise, select **Other** and choose **Business** as the app type (you will add the Marketing API as a product in the next step).
* Select your Meta Business Portfolio and click **Next**.

**Verify Marketing API:** Once the app is created, ensure the **Marketing API** is listed under the "Products" section in your app dashboard. If it isn't, click **Add Product** and select **Marketing API**.
{% endstep %}

{% step %}
**Publish your App (Live)**

* Navigate to **Settings** → **Apps.**
* Select the **Flip.to Integration** app
* Click on the **⋯** menu on the left hand side, and select **Open in App Dashboard**
* Navigate to **App Settings** → **Basic**
* Enter the **Privacy policy URL** from your website.
* Navigate to **Publish**, and Click the **Publish** button.
  {% endstep %}

{% step %}
**Create a Meta System User to your App**

Navigate to **Settings** → **Users** → **System Users.**

If you don't have an existing System User, click **Add**, and set the user up:

* Set the user name to **Flipto\_Integration\_User**.
* Set the role to **Employee** and click **Create System User**
  {% endstep %}

{% step %}
**Assign Assets to the Meta System User**

Select the existing or newly created System User from the list.

* Select **Assign assets** from the ⋯ menu (or the **Assign Assets** button on the main pane).
* On Apps, select the newly created App
* On the **Select assets and assign permissions** screen:
  * Select **Apps** from the left-hand menu.
    * Check the **Flip.to Integration** app
    * **Set Permissions:** Under **Full Control**, make sure the Can manage roles, change app settings, test the app, and view analytics toggle is **ON**.
  * Select **Ad account** from the left-hand menu.
    * Choose the specific ad account(s) you want to integrate with Flip.to.
    * **Set Permissions:** Under **Partial access**, make sure the **View Performance** toggle is **ON**.
* Click **Save Changes** or **Assign assets**.
  {% endstep %}

{% step %}
**Create your Meta System User token**

On the System User details page, click **Generate token**.

* Select your **Flip.to Integration** app and click **Next**.
* Set **Token expiration** to **Never** (recommended to prevent integration breaks) and click **Next**.
* **Select Permissions:** Instead of the default, ensure the following two permissions are checked:
  * `ads_read`
* Click **Generate Token**.
* **Copy and Save**: Copy this token immediately. You will need to paste this into your Flip.to account, and Meta will not show it to you again.
  {% endstep %}
  {% endstepper %}

## Next, connect Meta Ads to our platform

{% stepper %}
{% step %}
**Head over to Integrations**

Sign into [your Flip.to account](https://manage.flip.to/) and navigate to **Platform → Mission Control** or **Account Settings → Integrations**.
{% endstep %}

{% step %}
**Click on Meta Ads**

You'll find it in the **Marketing & Ads** section.
{% endstep %}

{% step %}
**Click Add your Meta System User token**

You'll be prompted to add your Meta System User token, which will then allow access to your Meta Ads accounts.
{% endstep %}

{% step %}
**Select your Meta Ads accounts**

After you've authorized Flip.to, you'll be prompted to select one or more of the Meta Ads accounts that you'd like to connect to our platform.
{% endstep %}
{% endstepper %}

## Last up, add tracking parameters to your ads

{% stepper %}
{% step %}
**Head over to Meta Ads**

Sign in to [your Meta Ads account](https://www.facebook.com/business/tools/ads-manager) and go to the **Ads** tab.
{% endstep %}

{% step %}
**Add tracking parameters**

If you have multiple active ads and want to add tracking in one go, be sure to select each of the ads or click the checkbox at the top to select all of the ads at once.\
\
Then click **Edit.**

In **URL Parameters**, add `adid={{ad.id}}` and click **Publish**.

<figure><img src="/files/qhl3WwX4osGpn3C6377B" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

**And that's it.** Your Meta Ads accounts are now connected and data should start flowing into your Flip.to platform in the next 24-48 hours.


---

# 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.flip.to/docs/integrations/advertising/meta-ads.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.