Instagram Ads data source

Learn how to set up an Instagram Ads data source and then move your data to one of the data destinations supported by Coupler.io. 

Two steps to complete the setup

1. Set up your data source
2. Set up your data destination
3. Additional settings for the Reports and Insights report type.

1. Set up your data source

1.1. Connect your Facebook Account.

• In the Data Sources section, select Connect New.
• There, find and select Instagram Ads.
• From there, complete the necessary sign-in steps and grant Coupler.io the permission it needs.

1.2. Select Instagram Ad Account

Specify one or several Ad accounts from which you want to extract data.

1.3. Select your Report Type

Select a report type to import from the following:

• Reports and Insights,
• List of Ad sets,
• List of Campaigns,
• List of Ads

2. Set up your data destination

Continue the integration setup depending on the destination you want to import data to. Select your tool from the list of supported data destinations and follow the relevant setup guide.

3. Additional settings for the Reports and Insights report type.

When importing Insights, the Advanced settings field appears where you can further customize your import.

Start/End dates

Choose the start and end date for your analytics period. You can either insert a particular date in the YYYY-MM-DD format (e.g., 2022-01-20) or a macro (e.g., {{yesterday}}). Learn more about macros.

Split the data by periods.

You can break down the data into specific periods of time from the following:

• Daily
• Weekly 
• Monthly
• Totals only

Metrics and dimensions

You can also adjust the list of columns to be imported. By default, the following are pre-selected:

• Account name
• Campaign id
• Campaign name
• Amount spend
• Reach
• Frequency
• Impressions
• Clicks
• CPC
• CPM
• CTR

When you click on a space in the Columns field, a drop-down list will appear. From here, you will be able to add more columns or remove some. The already added fields have a checkmark next to them.

Breakdowns

You can also use the Columns field to further break down Insights data - e.g., by age, gender, etc. Add or remove them the same way as you did with the columns above.

Breakdown usage limitations

Off-Facebook action metrics (e.g., Conversions: Registrations Completed) will behave differently when breakdowns are used:

• They will return ‘0’ for all breakdown values (e.g., for all countries in a report), or
• They will return the correct metric value (e.g., 123 registrations), but the respective breakdown values (e.g., country names) will be returned as “unknown” or “uncategorized”.

Not all breakdowns can be selected together  - here are the allowed combinations:

• Age and Gender
• Country and Region
• Impression device and Publisher platform

Filters

You can filter the data to be imported using Graph API syntax - [filter_1, filter_2, ..., filter_N]. 

For single filtering, you can use a single filter ([filter_1]) - the structure, in this case, is as follows:

[
   {
      "field":"adset.name",
      "operator":"CONTAIN",
      "value":"Blog"
   }
]

• field - means the field name that you want to apply the filter to
• operator - a condition that you want to use in the filter. Facebook Ads API allows using of one of the following values: EQUAL, NOT_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL, IN_RANGE, NOT_IN_RANGE, CONTAIN, NOT_CONTAIN, IN, NOT_IN, STARTS_WITH, ENDS_WITH, ANY, ALL, AFTER, BEFORE, ON_OR_AFTER, ON_OR_BEFORE, NONE, TOP
• value - value to compare a field against: it can be a number (without quotes), a string  (with quotes), or an array of values (numbers or strings)

A single filter looks like this:

Some popular examples of a single filter (ready for copy-paste):

1. Filter by Ad name containing some value:

[
   {
      "field":"ad.name",
      "operator":"CONTAIN",
      "value":"Blog"
   }
]

2. Filter by Ad set name equal to value:

[
   {
      "field":"adset.name",
      "operator":"EQUAL",
      "value":"Blog"
   }
]

3. Filter by Amount Spend:

[
   {
      "field":"spend",
      "operator":"GREATER_THAN",
      "value":10.0
   }
]

4. Filter for either item on a list of actions (for example, action_type must be link_click orlanding_page_view):

[
   {
      "field":"action_type",
      "operator":"IN",
      "value":[
         "link_click",
         "landing_page_view"
      ]
   }
]

5. Several filters are used in a single data flow: [filter_1, filter_2]

[
   {
      "field":"action_type",
      "operator":"IN",
      "value":[
         "link_click",
         "landing_page_view"
      ]
   },
   {
      "field":"adset.name",
      "operator":"CONTAIN",
      "value":"Blog"
   }
]