Facebook Marketing API
Facebook Marketing API uses OAuth 2. You should sign up for an application on Facebook first and get an OAuth client ID and client secret.
Note: The process of having your app approved by Facebook may be lengthy (~5 days).
Setting up your Partner App
Log into your Facebook account.
Create a Facebook Developer account if you don’t already have one: https://developers.facebook.com
Go to
My Apps
: https://developers.facebook.com/appsClick
Create App
, and select Business as the app type.Complete the following sections:
App Display Name This is the name your users will see when they grant consent to access their data.
App Purpose (set to
Clients
.)
Click
Create App
(You will then be asked to enter your password).You should be faced with a screen entitled Add Products to Your App. Under Facebook Login, select
Set Up
.This should now be added. In the menu on the left, select
Facebook Login
>Settings
.Under Valid OAuth Redirect URIs enter
https://Your Service Domain/connector/callback
(Your service domain can be found in your Cyclr console under Settings > General Settings > Service Domain.) and clickSave Changes
.Under App Review on the left, select
Permissions and Features
.Here you're going to set the permissions you'll be asking your user for when they see the consent screen.
The permissions you choose will vary depending on your use case, but you will always need advanced access to the user's public profile to allow them to sign in.
Search for
public_profile
, clickGet Advanced Access
, and complete the confirmation screen.You will notice that Advanced Access to public_profile is granted automatically. The other permissions will require a bit more admin.
For this example, we'll add the
leads_retrieval
permission, which is required if you are working with Form submissions.Once you have requested Advanced Access on this (and any other permissions), you'll be invited to Edit App Review Request. Click this, complete all the required sections, and Submit for Review.
Under Settings, Basic on the left menu, you'll be able to complete any missing sections, and copy your App ID and App Secret. Once your app has been approved by Facebook, you'll be able to use these to authenticate your App in Cyclr.
Authenticating your Facebook Cyclr Connector
Go to your Cyclr Console > Connectors > Connector Library > Facebook Marketing API > Setup
Client ID: This is the App ID displayed after you create the Facebook app
Client Secret: This is the App Secret displayed after you create the Facebook app
Your Facebook Marketing API connector is now set up! You can test it by installing it in one of your user accounts.
Official Facebook Documentation
https://developers.facebook.com/docs/apps/register
Create Ad Set "Promoted Object"
The Promoted Object is required for certain campaign objectives. The below table outlines the required Promoted Object fields based on the Optimization Goal.
Optimization Goal | Promoted Object Field |
---|---|
CONVERSIONS | Pixel ID (Conversion pixel ID) Pixel ID (Facebook pixel ID) and Custom Event Type Pixel ID (Facebook pixel ID), Pixel Rule and Custom Event Type Event ID (Facebook event ID) and Custom Event Type Application ID, Object Store URL, and Custom Event Type for mobile app events Offline Conversion Data Set ID (Offline dataset ID) and Custom Event Type for offline conversions |
PAGE_LIKES | Page ID |
OFFER_CLAIMS | Page ID |
LINK_CLICKS | Application ID and Object Store URL for mobile app or Canvas app engagement link clicks |
APP_INSTALLS | Application ID and Object Store URL |
OFFSITE_CONVERSIONS | Application ID, Object Store URL, and Custom Event Type (Standard Events) |
PRODUCT_CATALOG_SALES | Product Set ID Product Set ID and Custom Event Type |
LEAD_GENERATION | Page ID |