---
schema_version: "1"
id: 5fa1b3cbd2d7c82005962c8b3be7bc24b34b3775b68a32229788ccfdd246f2cb
title: Create a Facebook Ads Data Stream in Marketing Cloud Intelligence
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/dato_data_streams_api_connect_fb_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.dato_data_streams_api_connect_fb_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: a49e760df0efbadeedd97e6d40ab09a8826f73cca39bd1e67ff5b4febceb34ac
description: To pull data and create reports for Facebook ads, create a Facebook Ads data stream.
products:
  - Marketing
  - Marketing Cloud Intelligence
release: "264"
---
# Create a Facebook Ads Data Stream in Marketing Cloud Intelligence

To pull data and create reports for Facebook ads, create a Facebook Ads data stream.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d36112e38">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d36112e38 ">To create an API data stream:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d36112e38 ">Admin</td>

          </tr>
        </tbody>
      </table>

To create a Facebook Ads API data stream, you need:

- A valid Facebook user with View or Manage permissions
- Access to the Ads account

1. On the **Connect and Mix** tab, expand **Data Streams**.
2. Click **Add New**.
3. Select **Facebook Ads** connector.
4. In the General section, select the account that you want to pull data for.
5. To add a new data source authentication, click **Add New** and enter your Facebook Ads credentials.
6. Set the time period for the initial data fetch. You can process data up to the past 180 days.
7. In the Extended Properties section, you can set these properties:
    1. To retrieve conversion and revenue data in addition to the default delivery data, select **Get Conversions**. These fields are added and mapped to the Conversion Tag data stream type:
        
        <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><tbody><tr class=""><td class="slds-cell-wrap">Post Impression Revenue</td></tr><tr class=""><td class="slds-cell-wrap">Post Click Revenue</td></tr><tr class=""><td class="slds-cell-wrap">Revenue</td></tr></tbody></table>
    2. To show conversions and revenue based on their conversion date and not the impression or click date, select **Report Conversions on Conversion Date**.
    3. To retrieve all archived entities in Facebook Ads, select **Get Archived Entities**.
    4. To add a higher level of granularity to your data report, select a breakdown from the dropdown. (You can select only one breakdown per Facebook Ads API data stream.)
        
        <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
                <colgroup>
                  <col style="width:33.557046979865774%">
                  <col style="width:66.44295302013423%">
                </colgroup>
                <tbody>
                  <tr class="">
                    <td class="slds-cell-wrap" style="vertical-align:top;">
                      <strong class="uicontrol">Country</strong>
                    </td>

                    <td class="slds-cell-wrap" style="vertical-align:top;">Adds the Country dimension to the dataset. </td>

                  </tr>
                  <tr class="">
                    <td class="slds-cell-wrap" style="vertical-align:top;">
                      <strong class="uicontrol">Age and Gender</strong>
                    </td>

                    <td class="slds-cell-wrap" style="vertical-align:top;">Adds ‘Age’ and ‘Gender’ to the report. (These dimensions aren’t mapped
                      automatically.)</td>

                  </tr>
                  <tr class="">
                    <td class="slds-cell-wrap" style="vertical-align:top;">
                      <strong class="uicontrol">Placement</strong>
                    </td>

                    <td class="slds-cell-wrap" style="vertical-align:top;">Breaks down the data according to ad placement for example, Facebook Desktop News
                      Feed or Instagram Mobile News Feed. Selecting placement adds ‘Strategy Key’ and
                      ‘Strategy Name’ to your report. </td>

                  </tr>
                  <tr class="">
                    <td class="slds-cell-wrap" style="vertical-align:top;">
                      <strong class="uicontrol">Placement &amp; Impression Device</strong>
                    </td>

                    <td class="slds-cell-wrap" style="vertical-align:top;">
                      <p>Adds these dimensions to the dataset: </p>
                      <ul>
                        <li>Device Category </li>
                        <li>Strategy Key </li>
                        <li>Strategy Name </li>
                      </ul>
                    </td>

                  </tr>
                </tbody>
              </table>
    5. To determine how Revenue and Total Conversion are calculated, select an attribution setting from the dropdown. The default is **7-day click**.
8. To change the mapping, click **Mapping**. You can also access mapping by clicking **Map to Model** at the bottom of the Create New Stream page.
9. To define advanced settings, at the bottom of the screen, click **Advanced Settings**.
    
    <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small "><tbody><tr class=""><td class="slds-cell-wrap"><strong class="uicontrol">Retrieve Data Hourly</strong></td><td class="slds-cell-wrap">pulls data from the Facebook Ads API every hour.</td></tr><tr class=""><td class="slds-cell-wrap"><strong class="uicontrol">Include Today's Data in Retrieval</strong></td><td class="slds-cell-wrap">pulls the most recent data available by Facebook Ads, retrieving data with 0 lag days. (The time of day can affect the data being pulled, resulting in an incomplete dataset for today’s date. )</td></tr></tbody></table>
10. Click **Create**.
11. Quality check your data:
    
    1. Create a report in Facebook Ads platform for the selected date range.
    2. Process the relevant data stream in Marketing Cloud Intelligence filtered to the same date range.
    3. Create an identical report or pivot table in Marketing Cloud Intelligence with the same date range, dimensions, and measurements.
    4. Compare and make sure that the measurement totals are aligned.
    5. Now compare the conversions data. Go to **Ads Manager**.
    6. Click **Reports** and select **Export table data**.
    7. Select the format of the exported file, and click **Export**.
    8. Compare the Facebook Ads conversions to Marketing Cloud Intelligence conversions.
    
    Conversion metrics in Marketing Cloud Intelligence are transposed. For example, in Facebook Ads platform, each conversion type has a measurement: Lead, Purchase, View Content. In Marketing Cloud Intelligence, to align with the data model and other platforms, the type of the conversion is returned as a value of a Conversion Tag Category dimension, while the metric values of all conversions are available in the Total Conversions metric.