Skip to main content
Ad networks organize paid acquisition data in PNLight. Use them to group campaigns by network and account, normalize attribution names, and configure delivery settings that paid traffic depends on.

​
How ad networks are structured

PNLight uses three levels for paid acquisition setup:
  • Network: a provider such as Facebook or a custom traffic source.
  • Account: a connected Facebook ad account or a custom account inside that network.
  • Campaign: a synced or manual campaign that appears under the selected network or account.
Use this structure to keep attribution, postbacks, and reporting aligned across the dashboard.

​
Before you start

For a Facebook connection, prepare access in Meta before you add the account in PNLight.
  • You need admin access to the Meta business portfolio that owns the ad account.
  • You need access to the ad account that runs the campaigns.
  • You need a Meta dataset or pixel if you want PNLight to send events through Meta Conversions API.
  • You need an app link or landing URL for click redirects.
PNLight uses the Marketing API token to sync campaigns and spend. PNLight uses the pixel token only when you enable Conversions API event delivery.

​
Connect a Facebook account

1

Open Networks

Select a project and open Networks.
2

Connect Facebook

Click Connect Facebook.
3

Enter Marketing API settings

Add Facebook Ad Account ID and Facebook Access Token (Marketing API).
4

Enter Conversions API settings

Add Facebook Pixel ID (Conversions API) and Facebook Pixel Access Token (Conversions API) if you want PNLight to send events to Meta.
5

Set the default redirect URL

Add Redirect URL (default). PNLight sends users to this URL after it records the ad click.
6

Create the account

Save the account. PNLight validates the credentials and makes the account available for campaign sync.

​
Get the Facebook credentials

You need a Facebook ad account ID and a Marketing API access token to connect a Facebook account. Add the pixel ID and pixel access token only when you want PNLight to send mapped events to Meta Conversions API.

​
Get the ad account ID

1

Open Meta Ads Manager

Open the ad account that runs the campaigns you want to sync.
2

Copy the account ID

Copy the numeric ad account ID from the account selector or account settings.
3

Keep the ID format

You can paste the ID as act_123456789 or 123456789.

​
Get the Marketing API access token

Create a system user token for PNLight. Do not use a short-lived Graph API Explorer token.
1

Open the business portfolio

Open Meta Business Settings and select the business portfolio that owns the ad account.
2

Create a system user for PNLight

Open Users > System users and click Add. Name the user PNLight or another clear service name.
3

Give the system user ad account access

Select the system user, click Add assets, choose Ad accounts, and select the ad account you will add to PNLight. Grant access that allows PNLight to read campaigns, ad sets, ads, and insights.
4

Choose the Meta app

Click Generate new token and select the Meta app that belongs to the same business portfolio. If you do not have an app yet, create one in Meta for Developers and connect it to this business portfolio.
5

Select Marketing API permissions

Select ads_management. Select ads_read too if Meta shows it for your app.
6

Copy the token

Generate the token and copy it immediately. Paste it into Facebook Access Token (Marketing API) in PNLight.
Meta reference: Marketing API authorization.

​
Get the pixel ID and pixel access token

Use these values only when you want PNLight to send mapped events to Meta Conversions API.
1

Open Events Manager

Open the dataset or pixel that should receive PNLight events.
2

Copy the pixel ID

Copy the pixel or dataset ID from the data source details.
3

Generate the access token

Open the Conversions API settings for the data source and generate an access token.
4

Copy the token

Paste the pixel ID into Facebook Pixel ID (Conversions API) and the token into Facebook Pixel Access Token (Conversions API) in PNLight.
Meta reference: Conversions API get started.

​
Add a custom network or account

Use a custom setup when the traffic source is not connected through Facebook sync.
1

Create the network

In Networks, click Add network and enter the network name and key.
2

Add aliases

Add attribution aliases such as provider-specific names or normalized labels that PNLight should treat as the same network.
3

Add an account

Open the network row and click Add account.
4

Enter account details

Add Account name, optional External account ID, and Default redirect URL.

​
Configure network settings

Open a network from the table when you need to manage shared delivery settings. Use the network page to:
  • Rename the network.
  • Update attribution network aliases.
  • Define default system event postbacks.
  • Define default app event postbacks.
  • Map PNLight events to Facebook standard events when you use Facebook Conversions API.

​
Configure account settings

Open an account when you need account-specific click and delivery settings. Use the account page to:
  • Set or change the default redirect URL.
  • Copy URL for your Ad for Facebook campaign destinations.
  • Update Facebook access tokens.
  • Update Facebook pixel credentials.
  • Turn Send events to Facebook Conversions API on or off.

​
After setup

  • Open Campaigns and sync or review the campaigns for that account.
  • Use ad network and ad campaign filters across Analytics, Customers, and Events.
  • Keep attribution aliases current when your provider sends a new network label.
  • Turn on Conversions API only after the pixel credentials and event mapping are ready.
Use Campaigns after you connect an account to review enabled campaigns, costs, postbacks, and campaign metrics.