Facebook Ads Connection

Create Facebook Ads Connection

There are two ways to connect to Facebook with Rivery:

1. Signing in with your Facebook email and password and granting the Rivery Facebook app access to your data.
2. Using your own Custom App.

A new connection can be created on the river screen using the button “create a new connection” or in the connections screen.


Connection details will pop up regardless of how you create the River.

Signing In With Your Facebook Email and Password

1. Insert the name of the connection in the "connection name" input
2. Click on "Sign in with Facebook" button.
   1. Facebook connection pop up should open.
   2. Connect to the Facebook account that you’d like to use in Rivery.
   3. Click on "Save" in order to keep that account in your Rivery account.

• If nothing happens after clicking the "Sign in with Facebook" button, your browser may have blocked the pop up:
• On the right side of the URL in your browser, there is supposed to be a button of "popup blocked":

• Click on the button and select "always allow popups from Rivery".
• Click again on the “Sign in with Facebook” button and a pop up to connect to Facebook will show up on your screen.

3. Click on "Test connection". If the test passes passed, you're good to go with the Facebook connection.

Configure a Custom App Connection with Facebook Ads in Rivery

Follow these steps to configure a Custom App connection for Facebook Ads in Rivery:

1. Create a Custom App in Facebook Developer Console

• Go to Facebook Developer Console.
• Click on Apps and then Create App.
  
• Fill in the required details, such as the App Name, App Email.
• Add Use Cases.
• Select a Business Portfolio and click Go to Dashboard.

2. Generate API Credentials

• After creating the app, navigate to App Settings > Basic to retrieve the App ID (Client ID) and App Secret (Client Secret).
• These credentials will be used in Rivery for authentication.

3. Configure App Domains and IP Whitelist

• In App Settings, under the Basic tab:

  • Add your Rivery console URL (e.g., https://console.rivery.io/) and https://rivery.io/ to the App Domains section.
  • Enter the Privacy Policy URL: https://rivery.io/privacy-policy/
  • Enter the Terms of Service URL: https://rivery.io/terms-of-use/
  • Select the category that best fits your app.

• In the Advanced tab, under the Security section, include the whitelisted IPs for your specific region.

4. Set Up Facebook Permissions & Features

• Go to the App Review section and open Permissions & Features.
• Add the following permissions for Facebook Ads:

• Permissions:
  • ads_read
  • ads_management
• Features:
  • Ads Management Standard Access

5. Authorize the App

• Navigate to Publish > Go Live, and click Go Live to publish your app.
• In the left-hand menu, under the Submit for Review section, complete the app review and business verification process with Meta.
• After Meta approves and authorizes your app, you can establish a connection in Rivery using the Custom App.

6. Configure the Custom App in Rivery

1. In Rivery, go to Connections.

2. Click Create New Connection and choose Facebook Ads.

3. Select Custom App as the Authentication method.
   Enter the App ID (Client ID) and App Secret (Client Secret) retrieved from the Facebook Developer Console.

   Please Note: If you have an Access Token, you can use it instead of the App ID and App Secret, but not both simultaneously.

4. Click Test Connection to authenticate with Facebook Ads.

5. Click on Save in order to keep that account in your Rivery account.

7. Test and Use the Connection

• After successful authorization, test the connection to ensure it is working properly.
• Once connected, you can start building data pipelines in Rivery using Facebook Ads data.

Enforce Two-Factor Authentication

1. Go to your Facebook user and set your Security and Login settings to be Two-Factor Authentication.

1. Click on Security & Login section



2. Click on Edit - Use two-factor authentication



3. Click on Use Text Message

4. Create a Facebook connection in Rivery.

Your Facebook login will require to enter the user/pass and the code that you will receive to your phone.

Once you set the user and connection with Two-Factor Authentication you will not be required to create a connection again.

Add a Facebook Page to your Instagram Business Account

Optionally, you can add Facebook Pages to your Instagram Business Account to allow use of your professional account for the ads you create on Facebook.

See here for more information about the additional business tools available to you when connecting these accounts.

Prerequisites:

• Convert your account to an Instagram professional account.
• Be an admin of the Facebook Page you'd like to connect to.

Steps:

1. Go to your profile.

2. Select Edit Profile.

3. Under Public Business Information, Select Page.

4. Choose a Page from your Pages that you'd like to connect or select Create a New Facebook Page.

   Manage Pages issue

In case you see this error: Facebook Error: (#100) Pages Public Content Access or no data is returned from one of the following reports: promoted pages, ads leads or adcreative. The problem may be related to a missing scope in Rivery's connection to Facebook or missing a role to the page you are trying to fetch data from.

Please go inside your Facebook connection with incognito mode from your internet browser,
If you cannot enter the settings in your connection as shown below, please clear all your cookies relevant to Facebook.

Make sure you set especially the manage_pages for all pages found in the list found in the pages.
Select all pages in the list:

Turn on the permissions you see that are relevant to your meta data extraction. If you can, switch all permissions to yes. Rivery doesn't ask for permissions that can change your pages or posts (e.g., manage pages allow reading access while** publish pages** allow Rivery read/write access). Therefore, switch Manage your Pages to yes which is used to read page posts, and page fields.
If you didn't select any pages the manage pages permission will be blocked:

Assign a Role in a page

The account you connect to Facebook in Rivery must have a proper Role in the corresponding Page you want to read from.