---
schema_version: "1"
id: 7dff61b4b46704b628e64867639827a402e3cb594d993aaa742b0d662c2c3e6c
title: Create an X 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_twitter_ads_create.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.dato_data_streams_api_connect_twitter_ads_create.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 29da4f48d983904572bbb993f21e7fc5e49a33b338caaabf0741698ea47b5e0f
description: Create an X Ads data stream to pull ads data from your X accounts.
products:
  - Marketing
  - Marketing Cloud Intelligence
release: "264"
---
# Create an X Ads Data Stream in Marketing Cloud Intelligence

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

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

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

To create an X Social Engagement connector, you need:

- A valid username and password for the X account you want to pull data for.
- To use the X Social Engagement connector, 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.

a valid username and password for the X account that you want to pull data from.

1. On the **Connect and Mix** tab, expand **Data Streams**.
2. Click **Add New**.
3. Select the **X Ads 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 Ads credentials.
5. Select your profile.
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.
    
    <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
            <colgroup>
              <col style="width:100%">
            </colgroup>
            <tbody>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">To retrieve data in base 10 encoding as they appear in the UI, select <strong class="uicontrol">Get
                    Ids with base 10 encoding</strong>. 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 Marketing Cloud Intelligence.</td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">To retrieve URL clicks and Billed Engagement measurements into the Ads data stream,
                  select <strong class="uicontrol">Get Granular Engagement Data</strong>. </td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">To add a conversions report that is mapped to the Conversions Tag data stream, select
                  <strong class="uicontrol">Get Conversions Data</strong>.
                </td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">To retrieve Ad Tweet level data, select <strong class="uicontrol">Get Tweet Level Data</strong>.
                  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.</td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">To retrieve card data, select <strong class="uicontrol">Get Cards Data</strong>. Cards data is
                  retrieved with card dimensions, including ID, Name, URL, and Image. </td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">
                  <p>To add more breakdowns, select <strong class="uicontrol">Additional Segmentation</strong>. More
                    breakdowns provide a higher level of granularity. You can select these segmentations:</p>
                  <ul>
                    <li><strong class="uicontrol">Country</strong></li>
                    <li><strong class="uicontrol">Device</strong></li>
                  </ul>
                </td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">
                  <p>To select a specific campaign that you want to pull data for, select an option from
                    the Channel dropdown: </p>
                  <ul>
                    <li><strong class="uicontrol">On X</strong> — Pulls data from campaigns that are advertised on X on
                      user timelines. </li>
                    <li><strong class="uicontrol">On all Channels</strong> — Pulls data combined from the X and X Audience
                      Platform Channels. </li>
                    <li><strong class="uicontrol">On X Audience Platform</strong> — 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.</li>
                  </ul>
                </td>

              </tr>
              <tr class="">
                <td class="slds-cell-wrap" style="vertical-align:top;">To get the full Tweet text, select <strong class="uicontrol">Get Tweet Full
                    Text.</strong>.</td>

              </tr>
            </tbody>
          </table>
8. To change the mapping, click **Mapping**. You can access the 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**.
10. Click **Create**.
11. 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.