Skip to main content
With the Meta Ads integration, you can:
  1. Run enhanced app campaigns.
  2. Import all your ad campaigns (app and web).
  3. Enable Appstack to audit Meta’s reporting capabilities.
  4. Allow Appstack to send in-app events, postbacks (signals) back to Meta.
To successfully connect Meta Ads, you must:
  1. Have Full/Admin control access to the right ad business portfolio (including Business Manager and Meta for Developers). Partial access is not enough to make the integration work.
  2. Ensure the app used in Appstack (it must be created in Meta for Developers) is connected to the correct ad account.

​
Connect to Meta Ads

The first step is to connect your Meta Ads account with Appstack. Follow these steps:
  1. In Appstack, from the side menu, select Integrations > Meta Ads
  2. Click on Connect to Meta Ads
  3. In Meta’s access integration flow, select the correct business portfolio that contains the proper ad accounts and apps
  4. Ensure that you click on Select all ad accounts
  5. Accept the requested permissions and click on Save
  6. Click on Got it and then you will get redirected to Appstack’s integration page

​
Configure the Conversion API

Configuring the Conversion API with Appstack will allow you to run enhanced app campaigns using the assigned ads link.
1

Configure the dataset and Conversion API access token

The dataset receives all app events, not only Appstack-attributed ones. Choosing the wrong dataset will cause your app’s events to be sent to the wrong destination.
Follow these steps if you don’t have an existing dataset:
  1. In the ‘Connect your data’ pop-up, click on Create a new dataset.
  2. On the next screen, leave the CAPI toggle on, and don’t select any category. Click on Create.
  3. Choose the ad accounts you want to connect to this dataset and click on Next.
  4. Select Set up Conversion API.
  5. On the next screen, click on See other ways to set up, select Set up with Meta, and click on Connect now.
InformationFor additional information on how to get the Conversion API access token, follow the official instructions: Get access token
  1. Once the connection shows as Active, select the correct dataset ID from the dropdown in Appstack.
  2. To generate the Conversion API access token, follow these steps:
    • Go to your Meta Events Manager.
    • Select the correct dataset from the drop-down.
    • Click on Settings in the right sidebar.
    • Scroll down to the Conversions API section.
    • Click Generate Access Token.
    • Copy the generated token.
    • Paste the access token in the Conversion API access token field.
  3. Click on Save to confirm the dataset ID and access token, enabling the integration.
2

Sending events

To successfully send in-app events to Meta Ads, select the in-app events from the dropdown button under the ‘Appstack SDK events’ column, and map each one to the corresponding Meta standard event.Appstack will send the mapped standard event to Meta Ads (to the selected dataset) via the Conversion API, and this event will be used as the optimization goal when setting up the ad campaign.
Information
  1. To complete this step successfully, you first need to receive an install event from the Appstack SDK.
  2. Once the in-app events are selected, they will take between 30 and 90 minutes to appear in your dataset in the Meta Events Manager.
  3. Appstack sends all events to Meta Events Manager, not only the attributed ones.
  4. Events sent by Appstack are mapped to Meta’s standard events, so they’ll be recognized automatically in Meta Events Manager alongside any standard events already flowing into your dataset from other sources.
3

Verify the Appstack domain

Follow these instructions to verify the Appstack domain in Meta Events Manager:
  1. Inside the proper dataset, go to Settings and scroll down to the Traffic Permissions - Websites section.
  2. Click on Create an allow list.
  3. Look for the domain appstack.tech and click Add to allow list.
  4. Click on Confirm.
You must wait for the in-app events to arrive before doing this step.
4

Create your first enhanced app campaign

  1. Copy the ad link from the Appstack’s integration page (located at the bottom of the page).
  2. Inside Meta Ads Manager, click on + Create to start the campaign creation flow.
  3. Select Sales (recommended) as the campaign objective.
  4. At the ad set level, under the ‘Conversion’ section, select Website only as the ‘Conversion location’, select the correct dataset (same as in Appstack), and for the ‘Conversion event’ select the event you want the campaign to optimize for.
  5. At the ad set level, under the ‘Placements’ section, click on ‘Show more settings’ and select only Mobile and the correct operating system depending on the advertised app. Also, you must disable ‘Audience Network’ as a platform.
  6. At the ad level, paste the ad link into the ‘Website URL’ box. Don’t paste the URL parameters in the ‘Tracking’ section; copy them from the first step.
Information
  1. App installs (appstack_install) are available as a metric in Ads Manager only if they were selected as an optimization goal. You can still see them inside the Appstack dashboard.
  2. To unlock the appstack_installs metric, you need to launch a campaign that optimizes for this event. Once you do it, you will be able to unlock this metric for all future campaigns.
  3. Remember to always select mobile-only and the correct operating system in the ‘Placements’ section at the ad set level.
  4. If you optimize for value (ROAS) and your events include trials, Meta Events Manager will flag a “Send higher quality price data for more accurate ROAS calculation” notice saying the value field is missing on some events. This is expected. Trials have no purchase value, so they’re sent without one, while value optimization expects a value greater than 0, and none of this breaks attribution or your campaign.

​
Pre-Launch EAC Checklist

​
Troubleshooting

​
General tips

  1. Check your permissions: Ensure you have the required access levels for each platform.
  2. Verify app connections: Ensure your app is correctly connected to the ad accounts.
  3. Missing dataset: Click on Refresh datasets below the dataset dropdown to update the token.
  4. Update tokens: Generate fresh API keys and access tokens by reconnecting.
  5. Contact support: If issues persist, reach out to our support team with specific error messages at support@appstack.tech.

​
Error messages