The i360 Facebook API is designed to seamlessly integrate i360 voter and consumer data directly with your Facebook Business Manager for digital advertising efforts.
Before accessing the i360 Facebook API, you must have access to Facebook Business Manager and at least one Ad Account associated with the Business Manager. You’ll need to provide the i360 Media Team will your Facebook Business ID to implement the API.
Once you have an audience created in i360 Search, click Save. This will display the side panel to create a name for your search. Once you save the Audience, click Save again. When your search has been saved, you will have the option to select Export at the bottom of the screen (see below).
This will open the side panel to continue. At this point, you may rename your search. Be sure to select Facebook Export as your Export Type. Click Continue.
The side panel will update to display the New Facebook Export panel. If this is your first time using the i360 Facebook API, you will need to log in to Facebook using credentials that have access to the Facebook Business Manager.
On this page, you will need to confirm:
Saved Audience: This is the name of your saved i360 search.
Business: This should match the business you are exporting to. If your use has access
Ad Account: Select the Facebook Ad Account for your audience. If you have access to multiple Ad Accounts, you can select from the dropdown.
Facebook Audience: This is the name of your audience that will be exported to Facebook via the API. NOTE: This audience will automatically revert to the most recent audience in Facebook. To create a new audience, click the “+ Add Facebook Audience” button and type in the name of your audience. You can also add a description. If you do not create a new Facebook Audience, your audience will export into the selected Facebook Audience.
Once you click the Place Order button, the Facebook API will kick off the matching process to Facebook. The audience will immediately appear in the Ad Account chosen for the export. The matching process typically takes an hour depending on the export size, with Facebook reporting the match can take up to 24 hours.
NOTE: If you have not set up the Facebook API yet, you will need to send the following details to i360:
Facebook Business Manager ID:
Ad Account ID:
You'll also need to accept the Facebook Custom Audience Terms and Conditions before using i360 audiences for targeting:
We will send over a Partnership Request to your provided Ad Account ID. Once this request is accepted, under your Audiences page in FB, i360 audiences can be used for targeting in Meta.
Accepting the Facebook Partnership Request Audience
Navigate to: https://adsmanager.facebook.com/adsmanager/audiences
Click the ‘Accept Terms’ button (screenshot below)
Reporting Usage
Due to the nature of the Facebook API, all clients must submit a monthly usage report to i360 for billing purposes. Details are below -
Navigate to Facebook Ads Manager
Ads Reporting > Create new report
In Report Builder
Customize Ad Set level columns to include:
Required date Field (month/quarter for report)
Ad Set Name
Impressions
Amount Spent
Included Custom Audiences
Download + Screenshot Report
Download report with included columns and provide a screenshot of the report including the total results for impressions and spend in the screenshot (This is for our reporting purposes internally).
Send to i360 Digital Segments team ([email protected])
A monthly reminder email will be sent in the first week of the month to all API exporters.
Not Authorized to Run Political Ads on Facebook?
Since i360 data is for political advertising purposes only, all advertisers must be authorized to run political ads on Facebook. If you’re not authorized to run political ads, please follow the steps below:
Ad authorization checklist
Ensure you meet the following requirements before you begin the ad authorization process:
Be the Page admin or advertiser on the Page from which you're running ads about social issues, elections or politics. If you're not a Page admin or advertiser, you should ask an admin on the Page to add you as an admin or share this content with the Page admin and have them complete the ad authorization.
Have a Page with at least one Page admin with confirmed identity. This person doesn't have to be the one that created a specific disclaimer in order to use it. Only the Page admin can create or edit disclaimers for the country the ads will run in. Advertisers can create ads with disclaimers without Page admin permissions, as long as they aren't creating or editing disclaimers.
Have two-factor authentication enabled.
Have the following unexpired materials and information available:
A US passport, driver's license or State ID card
A US-based residential mailing address
Identity confirmation process
We’ll use your official ID to help confirm your identity. To do this, we partner with trusted service providers. We may also use it to help detect and prevent harm like impersonation or ID theft.
We take the following steps to help keep you and everyone else on Facebook safe:
As soon as you upload your ID, it’ll be encrypted and stored securely.
To help improve our systems that detect impersonation and fake IDs, we normally store IDs for up to one year. You can reduce this to 30 days at any point in your identity settings.
We may store your name and date of birth for longer to comply with local laws.
We'll also keep your ID expiry date for longer in case we need to ask for an updated document
Two factor authentication requirements
We recommend that you don’t turn two-factor authentication off. If you turn it off, your disclaimers and ads will be disabled. Your authorization will be revoked and you’ll need it to complete the authorization process all over again. Your ads and disclaimers will remain disabled until completion.
Ad disclaimer requirements
When running ads about social issues or politics, it’s important you review how disclaimers work. Only the Page admin can create or edit disclaimers for the country the ads will run in. Advertisers can create ads with disclaimers without Page admin permissions, as long as they aren't creating or editing disclaimers.
Websites, phone numbers, email addresses and addresses provided on disclaimers should be functional and correct at all times. We periodically check for accuracy and if provided information appears to be invalid or unavailable, your ads will be taken down.
Link to Facebook Help Doc: https://www.facebook.com/business/help/208949576550051?id=288762101909005
Confirm your identity to run ads about social issues, elections or politics (United States)
To confirm your identity, choose the best option for you below. Once finished, link your ad account and proceed to set a disclaimer.
Option 1: Desktop
Go to your Page. If your Page is managed in a business portfolio, you'll need to access your Page through Meta Business Suite to complete the rest of the steps.
Select Settings in the top-right corner.
In the left menu, select Issue, electoral or political ads.
In the Where will you run ads? section, choose the dropdown and select United States.
Below Confirm your identity, select Get started.
Select Get started again.
Set up two-factor authentication. If you've already set up two-factor authentication, you can skip this step:
On the Secure your account with two-factor authentication section, select Next.
Choose a security method and follow the steps to complete the set up.
When you get to the Enter your confirmation code section, select Next.
Choose the settings you'd prefer and select Next.
Note: You must keep two-factor on at all times. If you turn it off at any time, you'll lose your authorization and be unable to run ads about social issues, elections or politics. Any disclaimers you created will also be paused, along with any active ads that you created.
Select Confirm your primary country / region, then select Next.
Provide your mailing address to help us confirm your identity, then select Submit.
Select how you want to upload your ID, then select Next.
Choose the type of identification you'd like to use. US driver's licenses, state ID cards and passports are accepted. Any document submitted must be issued by a US government agency or department. Select Next.
Add images of your preferred type of identification. Any images you upload will need to be either JPG or PNG files and be less than 20 MB in size. The address on your photo ID does not have to match the address where you currently receive mail.
Photo requirements:
Use a clear and focused image against a dark background
Keep the ID flat with all 4 corners visible
After you successfully upload your image, select Submit.
Once all is done, select Finish.
Option 2: Going directly to www.facebook.com/id
Select Start identity confirmation, then select Running ads about social issues, elections or politics.
Select United States as country where you'll run ads. Select Get started.
Set up two-factor authentication. If you've already set up two-factor authentication, you can skip this step:
On the Secure your account with two-factor authentication section, select Next.
Select a security method and follow the steps to complete the set up.
When you get to the Enter your confirmation code section, select Next.
Choose the settings you'd prefer and click Next.
Note: You must keep two-factor on at all times. If you turn it off at anytime, you'll lose your authorization and be unable to run ads about social issues, elections or politics. Any disclaimers you created will also be paused, along with any active ads that you created.
In the Your primary country location section, select confirm your primary country / region.
Provide your mailing address to help us confirm your identity, click Submit.
Select the type(s) of identification you'd like to use. After selecting, select Next.
Add images of your preferred type of identification.
Any images you upload will need to be either JPG or PNG files and be less than 20 MB in size. The address on your photo ID does not have to match the address where you currently receive mail.
After you successfully upload your image, select Submit.
Once all is done, select Finish.
Link to Facebook help doc: https://www.facebook.com/business/help/2992964394067299?country_select=US