Skip to content

Connecting Your Data to Aliveo AI

1. Logging In

Once you log in to Aliveo AI, you’ll arrive at your personalized dashboard. From here, all account management actions are just a few clicks away.

If your organization has two-factor authentication enforced, you’ll be guided through TOTP setup the first time you log in. See User Management for details.


2. Accessing “My Account”

  1. In the Navigation Bar at the bottom-left corner, click on your name / organization avatar.
  2. From the dropdown menu, select My Account.

This opens your account management interface where you can manage your lines of business, connected data sources, knowledge documents, context, and team members.


3. Adding Lines of Business

In the left panel, you can add and manage multiple lines of business (LOBs). Each business line can have its own data sources, advertising platforms, and context.

To add a new line of business:

  1. In the Organizations section of the left panel, click the + button (Add organization).
  2. Enter the organization name and website, plus an optional description.
  3. Click Add organization — it appears in the list.

💡 Each business is an independent organization. Account-level and org-level context, dashboards, automation agents, and chats are all scoped to the active organization.


4. Selecting a Business and Choosing Platforms

Once you’ve selected a specific business, open the Platforms tab. The Select a platform dropdown lists every source you can connect.

Supported Platforms

Aliveo AI currently supports direct integration with the following platforms:

Ad platforms

  • Google Ads
  • Meta (Facebook & Instagram) Ads
  • LinkedIn Ads
  • Apple Search Ads (ASA)
  • Amazon Ads
  • Snapchat Ads
  • TikTok Ads (including TikTok Video creative metadata)
  • Moloco Ads

Analytics & web data

  • Google Analytics (GA4) — for first-party site/app data

App-store intelligence

  • Apptweak — connects with an API key; app-store (ASO) and app-market data is coming soon

Mobile measurement partners (MMPs)

  • AppsFlyer
  • Adjust
  • Additional partners are added on request.

Operational data

  • Airtable

Custom & bring-your-own data

  • CSV upload
  • Google Sheets
  • Custom warehouse exports (talk to us about direct API push/pull)

You can mix and match multiple platforms for each business as needed.


5. Connecting Ad Accounts

  1. In Select a platform, choose the platform you want to connect.
  2. Click Connect now.
  3. In the dialog that opens, pick an existing connection or name a new one. On most ad platforms you also choose what Aliveo may do: Ads Read is always on, and Ads Management lets Aliveo make changes for you (actioning). Then click Agree & Proceed.
  4. You’re redirected to the platform’s login page. Follow the prompts to grant Aliveo AI access to your performance and campaign data.
  5. Once authorization is complete, you’re redirected back to Aliveo AI.

Moloco and Apptweak use an API key instead of a login. After Connect now, paste your key into API Key and click Save API key. For Moloco, tick Ads Management too if the key can make changes — see Actioning Moloco Ads.


6. Finalizing the Connection

Back on the Aliveo AI interface:

  1. You’ll see a list of all available ad accounts for the connected platform.
  2. Select the accounts relevant to your chosen business.
  3. Click Connect to finalize.

That’s it — your accounts are now linked!


7. Data Synchronization and Notification

Aliveo AI will automatically start pulling data from your connected accounts. This process may take a few hours, depending on the data size.

Behind the scenes, we also pull change logs, breakdown data (audience, placement, device, geo), and creative assets, so historical context is preserved even after you make changes in the ad platform.

✅ You’ll receive an email notification once the initial data sync is complete.

Reviewing the Data Graph

Once the first sync finishes, the account’s card shows a Review Data Graph button. It walks you through how Aliveo should read the account:

  1. Choose the KPIs that matter for this account.
  2. Define your funnels — the steps from first touch to conversion.
  3. Set up account context — rules for this account, or for it and related accounts.
  4. Define campaign tags — what your campaign tags mean, and which campaigns they cover.

Click Continue to move between steps and Save on the last one. Custom data and Google Analytics have the first three steps only. You can come back to it any time from the card.


8. Adding Custom Data

Aliveo AI also lets you add custom data by uploading a CSV or connecting a Google Sheet. Use it to bring in data from other tools, reports, or internal systems.

Uploading a CSV File

  1. In Select a platform, choose Custom Data and click Connect now.
  2. Pick the CSV file from your computer. Aliveo reads it and shows a preview of your data.
  3. Under Dataset description, add a title, an optional description, and the Frequency — what each date in the data stands for (Daily, Weekly, Monthly, or N/A). Click Next.
  4. Under Select columns, untick any columns you don’t need and pick the Primary Date Column (required). For each column you keep, set:
    • Type — Date, ID, Metric, or Category.
    • Aggregation (metrics only) — Sum or Mean, so Aliveo knows how to roll the numbers up.
    • Description — what the column means, in plain words. Good descriptions improve answer quality.
  5. Click Save dataset.

A Your dataset is ready message confirms it’s integrated. You can ask about it in chat or add it to an agent right away.

Connecting Google Sheets

  1. In Select a platform, choose Google Sheets and click Connect now.
  2. Share the sheet with the email address shown in the dialog (viewer or editor access).
  3. Paste the sheet’s URL and click Submit.
  4. In Select your Tab, pick the tab to bring in and click Upload. Each tab becomes its own dataset, and only flat, static tabs are supported.
  5. Describe the dataset and its columns as for a CSV, then click Save dataset.

Joining Custom Data with Ad Platform Data

If your custom data shares a key column with your ad platform data (e.g. campaign_id, campaign_name, country), you can join the two so they show up as a single dataset in Chats and Automation Agents. Only datasets with a Daily frequency can be joined; others stay available on their own.

  1. On the custom data card, click the Data Join Configuration icon. The Setup Joining Config page opens.
  2. Choose the ad accounts to join with — individual accounts, or a whole platform such as All Google ads.
  3. Click Generate to map the columns automatically, or set them yourself under Column Mapping.
  4. Click Save.

💡 Custom data joins are how customers blend conversion-lag adjustments, offline conversions, brand-tracker scores, or first-party CRM signals into the same conversation as their paid-media metrics.

Refreshing custom data

To update a dataset, use the refresh icon on its card: Refresh from Google Sheets pulls the latest data from the sheet, and Refresh Custom Data Source replaces a CSV with a new file. The columns must stay the same as when you first connected it.


9. Attaching Supporting Documents

Beyond raw rows-and-columns data, you can attach knowledge documents—Google Docs, Google Sheets, CSVs, or custom inline text—to give Aliveo AI critical business context (campaign-naming conventions, KPI definitions, brand voice, etc.).

Documents can be scoped:

  • Per integration (e.g. only your Google Ads account)
  • Per business
  • Globally across the whole organization

To use a document, @-mention it in your context, a chat question or an agent's instructions.

See Knowledge Documents for the full setup.


10. Setting Your Business Context

After connecting your data, take a few minutes to set up Context—the natural-language rules that tell Aliveo how to read your data.

  • Define KPIs and acronyms used across the company at the Global level.
  • Override or extend those defaults at the Org and Account levels.
  • See The Context System for the full guide.

A few minutes spent on context pays for itself the first time you ask a question that needed a definition Aliveo didn’t know.


11. Connecting AI Clients (AI Integrations)

You can use Aliveo from MCP-compatible AI clients such as Codex, Claude, and others. A primary user first turns on AI client access (MCP) in User Management. After that, every team member sees AI Integrations in the My Account menu.

The AI Integrations page shows:

  • Connection URL — the Aliveo server address to add to your AI client.
  • Set up your client — ready-to-copy commands for Codex CLI and Claude Code. For any other MCP client, add the URL as a remote (Streamable HTTP) server.
  • Connected clients — every client you’ve connected, with when it connected and was last active. You can revoke any of them here.

When you connect, your client opens a browser window where you sign in to Aliveo and approve access. You never paste passwords or API keys into the client. If a connection stops working, re-run your client’s login command.


12. Deleting Your Data

Data Deletion in the My Account menu lets you remove a connected platform and everything Aliveo holds for it.

  1. Open My Account → Data Deletion.
  2. Under Platforms, click the trash icon next to the platform.
  3. Confirm with Continue.

This permanently deletes the platform connection, its tokens, and all associated data, and can’t be undone. If an option you need isn’t there, contact support@aliveo.ai. Read-only users don’t see this page.


13. Summary

Section Action Description
1 Log in Access the dashboard (with 2FA if enforced)
2 Go to “My Account” Manage businesses and integrations
3 Add an organization Set up each line of business
4–6 Choose and connect platforms Authorize the platform and pick your accounts
7 Sync and review Wait for the sync email, then click Review Data Graph
8 Add custom data Upload a CSV or connect a Google Sheet, and optionally join it with ad data
9 Attach documents Bring in business context as documents
10 Set context Write down KPIs, conventions and exclusions
11 Connect AI clients (optional) Use Aliveo from Codex, Claude and other MCP clients
12 Delete data Remove a platform and its data

🔒 Security Note

Aliveo AI uses industry-standard OAuth authentication and secure data handling protocols. Aliveo never sees your ad platform password. It stores only the access tokens or API keys it needs to sync your data, and encrypts them. See Security and Privacy for details on encryption, isolation, and access controls.