Marketing API Sample Submission

Let's say you are developing a browser-based app that your clients can use to create and run ads on Facebook. To access your clients' Ad Accounts, Campaigns, and Product Catalogs through the Marketing API, your app needs to be approved for the Ads Management Standard Access level and the ads_management, pages_read_engagement, and catalog_management Permissions.

After adding and configuring the Marketing API product, implementing Facebook Login, and confirming your app uses data in accordance with our Platform Policy, you begin the App Review process so you can take your app Live.

Step 1: Add Permissions

You sign into your App Dashboard and click App Review, then click Permissions and Features.

You search for "ads_management" to locate ads_management and Ads Management Standard Access, and request them both. You locate and add pages_read_engagement and catalog_management, and continue the request.

Step 2: Describe Data Usage

Now you describe how your app will use the data to which you are requesting access. In the Requests section, you click Edit Request.

Click the arrow icon in the Tell us how you'll use ads_management row.

Provide a general description of what your app does, then explain how the ads_managemen` Permission will help the people using your app. You enter the following description in the Tell Us Why Are Requesting ads_management section:

"The app is used by advertising account managers to set up ad campaigns, manage ads, and view reports that show metrics about ads. The ads_management permission allows them to get data about existing Facebook ads and to create ads. Without this permission, the app can't function."

Step 3: Upload a Screen Recording

In the Upload Screencast section, you click Upload File and upload a short, minute-and-half screen recording of a user signing into your app and exploring the user interface in the same way you described in your instructions.

You upload your screen recording, which shows a user following your instructions.

Something Went Wrong
We're having trouble playing this video.

You then save your changes and repeat these steps for the pages_read_engagement and catalog_management Permissions and the Ads Management Standard Access level descriptions. Because your screen recording shows how both Permissions and your Feature are used, you use the same screen recording for all of them.

Step 4: Complete App Verification

To complete the app verification process, click the arrow in the Provide verification details row.

Click Yes to agree to Facebook Platform Policy.

Then, enter instructions that a submission reviewer can follow to verify that your app uses the Permissions and Features you have requested in the way you have described. You also indicate when this happens in the screen recording that you have uploaded.

"To see how our app uses these permissions:

  1. Go to AdsApp.com.
  2. Log in with your Facebook account.
  3. In our left nav, click Accounts.
  4. Choose the test_account. (Users can associate other Facebook ad accounts with the app; we have pre-populated it with this test account that we set up just for app review.)
  5. You should see a page that lists the campaigns associated with this account.
  6. Click the test_campaign, then under Ad Set, click Create.
  7. You should see a UI where you can create a new ad set.
  8. Under Ads, click Create. You should see a UI where you can create a new ad, including uploading images or video.
  9. Go back to the left nav and click Reports.
  10. You should see a screen where you can make choices to set up reports.

The accompanying screencast shows ads_management being used whenever the user displays ad information or a new entity is saved: for example, at 00:10, 00:18, 00:32, 1:12, and 1:19.”

Step 5: Submit

You have supplied everything a reviewer will need to verify that your app uses the Permissions and Access Levels in an approved manner, so you click Submit For Review.