Intro
An Instagram business profile gives you access to promoted posts and Instagram ads, providing you the tools to grow your reach and engagement. It uses powerful advertising tools, so you can set up, run, and track campaigns to create deeper relationships with your business online and offline. The Domo Instagram Business Partition Connector enables you to pull the details about your Instagram media insights, user insights, users’ media, and much more. Use Domo’s Instagram Business Partition Connector to share, collaborate, and export your Instagram Business data in multiple formats. To learn more about the Instagram API, visit their page (https://developers.facebook.com/docs/instagram-api).
You connect to your Instagram Business account in the Data Center. To successfully connect to Instagram Business, you must first connect your Instagram account to a Facebook page and then grant Connector access to your Facebook user. The steps for doing this are described in continuation. This topic discusses the fields and menus that are specific to the Instagram Business Partition Connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Why should I use the Instagram Business Partition Connector?
The Instagram Business Partition Connector allows you to do an initial pull of historical data, known as Backfill, from Instagram Business once and then update only the most recent data on subsequent runs. This differs from the regular Connector, which requires you to either replace the entire dataset everyday to get the most up to date information, or appends duplicate rows to the dataset.
Configuring the Connector to backfill your data
Configuring the Connector for initial run
The Backfill field in the Connector determines how much historical data prior to the value in the End date field to bring into the dataset on the first run of the Connector.
Example: If the End Date field is set to March 30th 2021 on the initial run of the Connector, and the Backfill Days is set to 10, the Connector will bring in data between March 20th 2021 and March 30th 2021 on the initial run.
Configuring the Connector for subsequent runs
After the initial run, the Connector will only request a limited amount of data from the provider on subsequent runs. You can configure the Connector to update rows that have already been added to the dataset as well as new rows, or just add new rows. To configure the Connector for subsequent runs, use the Start Date and End Date fields to describe the date range the Connector should request data for.
The Start Date determines how far back the Connector should request data for, and the End Date determines the last day the Connector requests data for.
Example: If the Start Date is set to 3 days ago and the End Date is set to today, then
- On April 3rd, the Connector will request data for March 31st – April 3rd.
- On April 4th, the Connector will request data for April 1st to April 4th. It will update the rows in the dataset for April 1st and April 3rd , and create a new row for April 4th.
- On April 5th, the Connector will request data from April 2nd to April 5th. It will update the rows in the dataset for April 2nd to April 4th, and create a new row for April 5th.
Replacing Backfill
At some point, you may want to refresh the entire dataset. To do so, reset the backfill. You can reset the backfill by selecting the Replace Backfill checkbox. While this checkbox is selected, the Connector will run your dataset for the specified date range every time and will replace all previous data with the new data in the dataset. Note that, you need to uncheck the Replace Backfill checkbox after the first run. If you are using Append as an update method, be aware that you will lose all past history.
Using Append vs Replace Dataset Update Modes
For best results, use the 'Append' update method with Partition Connectors. The 'Replace' method will only replace the data in the dataset with the data pulled in subsequent runs, and will lose historical data.
Prerequisites
To use the Instagram Business Partition Connector, you need the following:
- An Instagram Business account. You can use a standard Instagram account, and it will be converted into an Instagram Business account during the setup process.
- A Facebook page URL that will be linked to the Instagram account. Each Facebook page can be connected to ONE Instagram Business account.
- A Facebook administrator user account URL for the page you are linking to Instagram.
Connecting to Your Instagram Business Account
This section enumerates the options in the Credentials and Details panes in the Instagram Business Partition Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most Connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
In the Credentials pane, you connect to your Instagram Business account via Facebook. This can only be done once you have 1) connected Instagram to a Facebook page, and 2) enabled access for your Facebook user. Steps for accomplishing these tasks are provided in continuation.
Once you have connected to Instagram Business through Facebook, you can use the same account any time you go to create a new Instagram Business Partition DataSet.
Connecting Instagram to Facebook
To connect your Facebook page to Instagram, follow these instructions:
-
Log into Facebook and navigate to the page you want to connect to Instagram.
-
Click on Settings in the top right corner.
- In the Settings screen, select Instagram in the list on the left, then click Log In in the Manage Instagram on Facebook pane.
-
In the Instagram login screen, enter the username and password of the Instagram account you want to connect to Facebook.
If the Instagram account is not a business account, you are prompted to switch to a Business profile, as shown here:
-
(Conditional) If the preceding dialog appears, click Continue, then click Done.
Once linking is complete, you will see your Instagram profile's business information in your Facebook page's settings.
Enabling Your Facebook User
Once you have linked your Instagram account to a Facebook Page, you must ask Domo to enable your Facebook user to have access to the Connector. This can be done by contacting Domo Support and asking for access. You will need to provide the following information:
-
The URL of your company Domo instance (e.g. mycompany.domo.com)
-
Your Facebook username. This must be the username of the user who will be using the Connector. This is not the name of the Page or Instagram account. You can find your username in the Facebook URL when you go to your Facebook profile:
-
Once your user has been enabled (which can take up to 5 business days,) you will need to accept the invitation in your Facebook notifications.
Note: The notification may not be visible in the mobile app and we recommend checking on a desktop.
Details Pane
This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.
|
Menu |
Description |
||||||||
|---|---|---|---|---|---|---|---|---|---|
|
Report |
|
||||||||
| Instagram Business Account Page | Select the Facebook page your Instagram Business account is linked to. | ||||||||
| Media Type | Select a media type. When selecting Story, keep in mind that media data for stories can usually be retrieved only for 24 hours after the story was created. | ||||||||
| Media Metrics | Select the metrics to include in the final report. | ||||||||
| Media Items | Select how media will be chosen for this dataset. | ||||||||
|
Media
|
Select a media item. Note: Please select only one Media Type from above, as this field supports only one media at a time.
|
||||||||
| Start Date - Specific | Select the first date in your date range using the date selector. | ||||||||
| End Date - Specific | Select the last date in your date range using the date selector. | ||||||||
|
Start Date - Relative
|
Enter the number of days back that you would like to get data from (start day). Combine with End Date to create a range of represented days. For example, if you entered 10 for Start Date and 5 for End Date, the report would contain data for 10 days ago up until 5 days ago. |
||||||||
|
End Date - Relative
|
Enter the number of days back that you would like to get data to (end day). Combine with Start Date to create a range of represented days. For example, if you entered 10 for Start Date and 5 for End Date, the report would contain data for 10 days ago up until 5 days ago. |
||||||||
| Other Instagram Business Account Pages | Enter a comma-separated list of Instagram page names. For example, 'domo, nike'. | ||||||||
| Reporting Timeframe | Select the timeframe for each day in the final report. | ||||||||
| User Metric | Select metrics to include in the final report. | ||||||||
| Backfill | Enter the number days to backfill the data for. | ||||||||
|
Replace Backfill |
While this checkbox is selected, the dataset will retrieve data as per the dates selected and replace all the data in the dataset. If you are using Append as an update mode, be aware that you will lose all past history. |
Other Panes
For information about the remaining sections of the Connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.
FAQs
What do I need to know about connecting via Facebook's OAuth?
When connecting your Instagram Business account with Domo, a Facebook OAuth process will happen. It's important to correctly configure the OAuth; otherwise, you may miss some of the data (Example: missing Instagram Business data or missing Facebook Pages in the configuration section).
Below are the basic steps for correctly configuring the OAuth.
- First, choose to "Add account", either from the "Create Instagram Business Connector DataSet" page or from the Accounts view of the Connector. For more information about adding an account, see Managing User Account for Connectors.
- If you've never connected Facebook to Domo before, the first screen in the Facebook OAuth will be one of the two screens below. Enter your Facebook credentials (if needed) and continue.
If you are already logged into your Facebook account, Domo will ask if you wish to use the same account for connection.
3. Now, select the Instagram Business Accounts you want to retrieve data for.
4. Next, select the Facebook Pages that are connected with your Instagram Business accounts.
5. Finally, enable all permissions so Domo has access to retrieve your data.
What version of Facebook/Instagram API does this Connector use?
This Connector uses version 6.0 of the Facebook API (https://graph.facebook.com/v6.0/).
Which endpoint does each report call in this Connector?
| Report Name | Endpoint URL |
|---|---|
| Media Insights | /{instagram_media_id}/insights |
| Other Users | /{instagram_business_account_id}?fields=business_discovery.username({account_name}){user_fields} |
| Other Users' Media | /{instagram_business_account_id}/media |
| User Insights | /{instagram_business_account_id}/insights |
What do I need to power up this Connector?
To start with, you need a Facebook page, a Facebook account that has a role on that page, and an Instagram account. You then need to follow the steps to connect your Instagram account and Facebook page and the steps to enable your Facebook user to have access to the Instagram Business Connector.
What are the steps to connect my Instagram account and my Facebook page?
- To connect your page to Instagram, follow these steps:
- Log into Facebook and go to the page that you want to connect to Instagram.
- Open the page’s Settings.
- On the page’s Settings window, choose the Instagram section and press the Login button.
- This will prompt you to log into Instagram. Enter the username/password for the Instagram account that you want to connect.
- If your Instagram account is not currently a Business account, you can convert it to a Business account at this time.
- When the link is complete, you will see your Instagram profile’s business information in your Facebook page’s settings.
Do I need any specific kind of Instagram account and Facebook page? Do I need the admin role?
You will be connecting the Facebook page to the Instagram account then converting the account to an Instagram Business account. You don't have to be the admin of the page but since you'll be connecting it to an Instagram Business Account, the page and account should be related in some way.
How often can the data be updated?
Most information about pages is updated every 24 hours. Selected "insight" metrics are updated roughly every 15 minutes. We recommend that you configure the datasets to run every 24 hours.
What's the difference between the Instagram Business and Instagram Business Partitions Connectors?
The Instagram Business Partition Connector supports Date partitioning. It also supports backfilling and replace backfilling for the User Insights report and allows to query data for any date range.
Troubleshooting
- Make sure your authentication remains valid.
- Review the configuration to make sure that all required items have been selected.
- Review the Connector history for error messages.
- In rare cases, you may be requesting too much information and reaching API limitations or timeouts. If this is the case, you can review the history of the Connector run to see the error message and duration. If this is the case, you can reduce the number of accounts that are being pulled, choose a smaller number of metrics for the report that you are pulling, or reduce the timeframe that you are trying to pull.
Comments
0 comments
Please sign in to leave a comment.