How to Integrate Meta Ad Account with Pearl Diver
Authorizing Meta via Pearl Diver Dashboard and accessing Pearl Diver audience in your Meta ad account
- A Meta ad account and valid login credentials
- Ensure you have connected an audience for the data you would like to send through the Meta integration, and this audience has the 'Meta' action selected
- Log in to your Pearl Diver dashboard
- Click the + icon next to Actions on the right hand side of the dashboard home page
- Click on Meta in the left hand panel
- Click Authorize - this will prompt you to log in to your Meta account
-
A new window will open to authorize the Meta integration
-
Log into the Meta account associated with the correct ad account. The account you choose must have full access to the ad account you want Pearl Diver to upload your audience data to. Click Continue as to log in.

-
Select the desired option for pages you want Pearl Diver to upload data and click Continue

-
Select the desired option for the business you want Pearl Diver to upload data and click Continue. It must be affiliated with the ad account you want the data to be sent to.

-
You will then be shown a review page of your chosen settings. Click Continue to proceed.

-
You will then be shown a confirmation page. Click Got It to proceed.

-
You will see a Pearl Diver confirmation screen. Please close this tab.Once you have closed the Authorization Successful window, the dashboard page will retrieve a list of the ad accounts your chosen Meta account has access to.

- In the Ad Account drop down below the Authorized as section, select the Meta ad account you would like to send the audience data to. Once selected, click Update.

- In the Audience Configuration section (right below the Action Configuration) select the drop down menu to Add New Audience. If you would like all website visitors to be sent to Meta, select All Leads and click Update.

- How to segment website visitor data with Pearl Diver Audiences
- Click on Audiences in the sidebar menu of your Meta Ads Manager account

- Your Pearl Diver audiences will be listed as shown below:

- Click the Pearl Diver audience to see information about the audience and how it's being utilized. Navigate to the History tab to verify records have synced from Pearl Diver
To utilize the audience data in an ad campaign, select the Pearl Diver audience you would like to use in the audience section when creating an ad set.
❓Should I use Many to One and One to One Mapping
When you authorize Meta Ads for the first time in Pearl Diver, the system defaults to 1:1 audience mapping. This is the recommended setting for sending multiple audiences to your Meta ad account to ensure you can identify the different audiences in Meta
❓What happens to existing audiences if:
Switching from Many to One to One to One:
-
Identify all connected audiences.
-
For each connected audience:
-
Create a corresponding audience/list/tag in Meta or Google if it doesn’t already exist.
-
Map the Pearl Diver audience to the new destination audience.
-
Switching from One to One to Many to One:
-
Consolidate audiences in Meta/Google, and map all Pearl Diver audiences to the consolidated list.
Example Use Case in Pearl Diver:
User creates an audience in Pearl Diver with demographic filters and is named "High-Value Customers." With 1:1 mapping, a Custom Audience is automatically created in Meta Ads with the same name and will appear as "PDV | High Value Customers" in the audience section in your Meta ad account
Switching Mapping:
User switches from many:1 to 1:1 mapping for Meta Ads.
Pearl Diver identifies existing audiences and creates new Custom Audiences in Meta for each Pearl Diver audience.
Updating On-Site Resolution Audience Filters:
User modifies the "High-Value Customers" audience in Pearl Diver (changes filters, adds demographic filter, etc). The updates will sync to the corresponding audience/list/tag in Meta or Google.
FAQs
❓How do I enable 1:1 Web audience mapping for the Meta ads action?
When you authorize Meta Ads for the first time in Pearl Diver, the system defaults to 1:1 audience mapping. Once authorization is complete, you can start adding audiences, and each audience in Pearl Diver will be mapped individually to Meta Ads using the naming format "PDV | [Audience Name]".
❓Where can I change the audience mapping settings?
You can modify the audience mapping settings on the Actions page under the Audience Mapping section.
❓What happens when I change my audience mapping from 1:1 to many:1?
When you switch from 1:1 mapping to many:1, Pearl Diver will:
-
Create (or update) a single audience/list in Meta Ads.
-
Use the naming convention “Pearl Diver” for the audience/list.
❓What happens when I switch from many:1 to 1:1 mapping?
When switching from many:1 to 1:1, Pearl Diver will:
-
Create new audiences/lists in Meta Ads for each audience already connected to the action (if they don’t already exist).
❓What happens if some audiences fail to be created when switching to 1:1?
-
If any audience creation fails, an appropriate error message will be displayed.
-
Pearl Diver will retry or prompt the user to manually verify the connection in Meta Ads.
❓What happens when I switch from 1:1 to many:1?
When switching from 1:1 to many:1, Pearl Diver will:
-
Merge all connected audiences into a single Meta Ads audience/list.
-
Use the naming convention: “Pearl Diver”.
❓What if an audience with the name ‘Pearl Diver’ already exists in Meta Ads?
Pearl Diver will update the existing “Pearl Diver” audience instead of creating a duplicate.
❓Will my existing audience data be lost during mapping changes?
No, audience data remains intact. Pearl Diver updates audiences dynamically in Meta Ads without deleting any data.