{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","partial","img","faq","faq-item"]},"type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"One or more features exclusive to select subscription plans or add-ons"},"seo":{"title":"Integrate X (Twitter) Ads with Databox","description":"Connect X (Twitter) Ads to Databox to monitor campaign performance, track spend, and report on paid social results alongside your other ad channels.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"],"excludeFiles":[]},{"title":"AI","includeFiles":["docs/ai/*.md"],"excludeFiles":[]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"],"excludeFiles":[]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"],"excludeFiles":[]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"],"excludeFiles":[]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"],"excludeFiles":[]},{"title":"Forecasts","includeFiles":["docs/forecasts/*.md"],"excludeFiles":[]},{"title":"Goals","includeFiles":["docs/goals/*.md"],"excludeFiles":[]},{"title":"Reports","includeFiles":["docs/reports/*.md"],"excludeFiles":[]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"],"excludeFiles":[]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"],"excludeFiles":[]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"],"excludeFiles":[]},{"title":"Support","includeFiles":["docs/support/*.md"],"excludeFiles":[]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"],"excludeFiles":[]}],"hide":false,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"integrate-x-twitter-ads-with-databox","__idx":0},"children":["Integrate X (Twitter) Ads with Databox"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"partial"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["X Ads (formerly Twitter Ads) is the paid advertising platform on X, enabling businesses to promote content across the X feed to targeted audiences based on interests, keywords, follower lookalikes, and demographics. Campaigns span awareness, engagement, and conversion objectives, with performance tracked at the campaign, ad group, and creative level. Connecting X Ads to Databox lets you pull that performance data into dashboards and reports alongside your other paid channels, so you can monitor spend efficiency, compare channel results, and share insights with stakeholders without logging into the platform."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connection","__idx":1},"children":["Connection"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"before-you-begin","__idx":2},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"IntegrationPermissions","attributes":{"integrationKey":"twitter-ads"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-authorize-databox","__idx":3},"children":["Step 1: Authorize Databox"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To connect X Ads to your Databox account for the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-connection"},"children":["first time"]},", you'll be redirected to X to authorize access."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've already established a connection, you can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-data-source"},"children":["reuse"]}," it to add new accounts, as long as those accounts are accessible with the existing connection's credentials."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the authorization screen, review the requested permissions and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign In"]}," to grant Databox access to your X Ads data."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/integrate-x-twitter-ads-with-databox_1.3ba4124329d335a472050361b4f6eb9e8793c1b18136244fdf811898eacab959.4783b0ec.png","alt":"x-twitter-ads-oauth-authorization","withLightbox":true,"className":"ss-img","style":"margin-top: 10px;"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-select-the-account","__idx":4},"children":["Step 2: Select the account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the X Ads account you want to report on. If you manage multiple ad accounts, you'll be prompted to select the specific account you want to connect to Databox."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"datasets","__idx":5},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg","alt":"lock"},"children":[]}," Datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ","X (Twitter) Ads"," integration supports the creation of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["datasets"]},", which allow you to structure and format your ","X (Twitter) Ads"," data for more flexible reporting in Databox. By organizing your data into a tabular format, datasets make it easier to filter, segment, and visualize key metrics across projects, clients, and team members."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The entity relationship diagram (ERD) below illustrates how data is organized within the ","X (Twitter) Ads"," integration, displaying the available ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["views"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["columns"]},", as well as the relationships between them (primary and foreign keys). This diagram represents the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["schema"]},", or structure, of the data and helps you understand the underlying data model. With this context, you can create datasets using the relevant views and columns to build custom metrics tailored to your reporting needs."]},{"$$mdtype":"Tag","name":"SchemaExplorer","attributes":{"integrationKey":"Shopify"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":6},"children":["Resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below."]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"IntegrationResources","attributes":{"integrationKey":"twitter-ads"},"children":[]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"What data does Databox access when I authorize X Ads?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Databox requests read-only access to your advertising data, including campaigns, audiences, ad account information, and creatives. No changes are made to your campaigns or account settings, and you can revoke access at any time from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apps and sessions"]}," section of your X account settings."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Integrate X (Twitter) Ads with Databox","id":"integrate-x-twitter-ads-with-databox","depth":1},{"value":"Connection","id":"connection","depth":2},{"value":"Before you begin","id":"before-you-begin","depth":3},{"value":"Step 1: Authorize Databox","id":"step-1-authorize-databox","depth":3},{"value":"Step 2: Select the account","id":"step-2-select-the-account","depth":3},{"value":"Datasets","id":"datasets","depth":2},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"slug":"integrate-x-twitter-ads-with-databox","seo":{"title":"Integrate X (Twitter) Ads with Databox","description":"Connect X (Twitter) Ads to Databox to monitor campaign performance, track spend, and report on paid social results alongside your other ad channels."},"keywords":{"includes":["X Ads","Twitter Ads","X Twitter Ads integration","connect Twitter Ads","Twitter Ads data source","Twitter Ads campaigns","X Ads performance"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"One or more features exclusive to select subscription plans or add-ons"}},"lastModified":"2026-06-05T09:50:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/integrate-x-twitter-ads-with-databox","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}