---
schema_version: "1"
id: 4249f7ff20a19d420066910df16b6f825f8dafec74d7715cf9c0d2df325a82d7
title: Create an X Social Engagement 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_twit_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.dato_data_streams_api_connect_twit_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 7f4d66d577a38ab24f61b371641ad437ea0db56c169587380a69020486bfc8df
description: Create an X Social Engagement data stream to pull organic data from your X accounts.
products:
  - Marketing
  - Marketing Cloud Intelligence
release: "264"
---
# Create an X Social Engagement Data Stream in Marketing Cloud Intelligence

Create an X Social Engagement data stream to pull organic data from your X accounts.

### 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="d78709e38">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d78709e38 ">To create an API data stream:</td>

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

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

To create an X Social Engagement connector, you need:

- A valid X ads account.
- A valid X username and password for the account you want to pull data for.
- The authenticated user must be the owner of the tweets. This API allows you to pull historical data for private metrics only for tweets that the authenticated user owns.

1. On the **Connect and Mix** tab, expand **Data Streams**.
2. Click **Add New**.
3. Select the **X Social Engagement** connector.
4. In the General section, select the account that you want to pull data for. To add a new data source authentication, click **Add New** and enter your X Social Engagement credentials.
5. Set the time period for the initial data fetch. You can process data up to the past 180 days.
6. In the **Extended Properties** section, you can set these properties.
    
    - - To retrieve data in base 10 encoding as they appear in the UI, select **Get Ids with base 10 encoding**.This checkbox makes sure that your line item IDs, such as Media Buy Key and Campaign, are retrieved as they appear in the UI and not as they’re retrieved by default in Datorama.
        - To retrieve URL clicks and Billed Engagement measurements into the Ads data stream, type select **Get Granular Engagement Data**.
        - To add a conversions report that is mapped to the Conversions Tag data stream, type select **Get Conversions Data**.
        - To retrieve Ad Tweet level data, select **Get Tweet Level Data**. If you have a variety of campaign objective levels, consider creating two different data streams to avoid discrepancies: one data stream with the Get Tweet Level Data selected and the other data stream without it. Setting appropriate data load rules ensures that each data stream pulls the correct dataset. Conversion data isn’t retrieved when Tweet Level data is pulled.
        - To retrieve card data, select **Get Cards Data**. Cards data is retrieved with card dimensions, including ID, Name, URL, and Image.
        - To add more breakdowns, select **Additional Segmentation**. More breakdowns provide a higher level of granularity. You can select these segmentations.
            
            1. Country
            2. Device
        - To select a specific campaign that you want to pull data for, select an option from the **Channel** dropdown.
            
            1. **On X** — Pulls data from campaigns that are advertised on X on user timelines.
            2. **On all Channels** — Pulls data combined from the X and X Audience Platform Channels.
            3. **On X Audience Platform** — Pulls data for campaigns that have ‘Expand your reach on the X Audience Platform’ selected. Can be applied in website clicks and conversions, or mobile app promotion campaigns.
7. 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.
8. To define advanced settings, at the bottom of the screen, click **Advanced Settings**.
9. Click **Create**.
10. Check your data.
    
    - Create a report in X Analytics for the selected date range.
    - Process the relevant data stream in Marketing Cloud Intelligence for the same date range.
    - Create an identical report or pivot table in Marketing Cloud Intelligence with the same date range, dimensions, and measurements.
    - Compare and make sure that the measurement totals are aligned.