Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Facebook Marketing

Authentication & Authorization​

Credentials​

  • Facebook Marketing uses an Access Token to authenticate.

  • Access Token can be generated from the Facebook for Developers account (see the DataGrail Help Docs).

  • Publicly exposing your API credentials can allow unauthorized access to the Facebook Marketing API endpoints, and your Facebook Marketing data by a third party. DataGrail stores your API credentials encrypted and protected.

Permissions​

Access Token should be configured with the next permissions (see the DataGrail Help Docs):

  • ads_management

  • ads_read

  • read_insights

Endpoints Utilized​

DataGrail uses the following endpoint to validate that credentials are good based on a successful response:

Version​

DataGrail integration supports the latest Facebook Marketing API (currently v15.0).

Limits​

DataGrail supports requests throttling to stay within 70-80% of specified service rate limits.

Do Not Sell​

For a Do Not Sell request, DataGrail will take the following actions:

  • Fetch all accessible active Ad Accounts which belong to some Business.

  • For each of collected Ad Accounts:

    • Fetch all Custom Audiences of Ad Account.

    • Сheck if Audiences from active Ad Accounts can be edited. Skip audiences that are not active or not ready to be used.

    • Remove an user with a Data Subject email from the Custom Audiences of Ad Account.

  • General request status will be false if at least 1 Audience can be used but can not be really edited or at least 1 deletion operation be failed. Otherwise it will be true.

Endpoints Utilized​

 

Need help?
If you have any questions, please reach out to your dedicated CSM or contact us at support@datagrail.io.

Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.