Saltar al contenido principal

Domo University Videos

Domo

Instagram Business Connector

Important: When referencing this page outside of Knowledge Base, use this link: https://knowledge.domo.com?cid=instagrambusiness

Intro

The Instagram Business Connector allows you to access Instagram Business Accounts so you can view comments and metadata and get insights and metrics about them. 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 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.

Prerequisites

To use the Instagram Business 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 that will be linked to the Instagram account. Each Facebook page can be connected to ONE Instagram Business account.

  • A Facebook administrator account 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 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 DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Connecting Instagram to Facebook

To connect your Facebook page to Instagram, follow these instructions:

  1. Log into Facebook and navigate to the page you want to connect to Instagram.

  2. Click on Settings in the top right corner.

    instagram_biz_1.png

  3. In the Settings screen, select Instagram in the list on the left, then click Log In in the Manage Instagram on Facebook pane.

    instagram_biz_2.png
  4. 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:

    instagram_biz_4.png
     

  5. (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.

instagram_biz_6.png

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 your Domo representative or 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:

    instagram_biz_7.png

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

Select the Instagram Business report you want to run. The following reports are available:

Media Comments

Read comments for a particular media object.

Media Insights

Get insights data for an individual media object.

User

Get metadata for the current user.

User Insights

Get insights for your Instagram Business account.

User Media

Get media objects for an Instagram Business account.

User Stories

Get user stories for an Instagram Business account.

Instagram Business Account Page

Select the Facebook page your Instagram Business account is linked to.

Reporting Timeframe

Select the timeframe for each day in the report.

User Metrics

Select the metrics you want to include in your report.

Media Type

Select the media type you want to retrieve data for. When selecting Story, keep in mind that media data for stories can usually be retrieved for only 24 hours after the story's creation.

Media Metrics

Select the metrics you want to include in your report.

Media Items

Select whether you want to pull data for a single media item, for a range of items, or for all media items ("User Media" report only). 

Media

Select the media item you want to retrieve data for. 

Date From

Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in Date To.

Select Specific Date From

Select the first date in your date range.

Date To

Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in Date From.

Select Specific Date To

Select the last date in your date range.

Date From Offset

Enter the number of the farthest day back that should be represented in the report. Combine with Date To Offset to create a range of represented days.

For example, if you entered 10 for Date From Offset and 5 for Date To Offset, the report would contain data for 10 days ago up until 5 days ago.

Date To Offset

Enter the number of the most recent day that should be represented in the report. Combine with Date From Offset to create a range of represented days.

For example, if you entered 10 for Date From Offset and 5 for Date To Offset, the report would contain data for 10 days ago up until 5 days ago.

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.