Chartboost

This guide explains how to set up the Chartboost UA data grabber in the Magify analytics system.

The grabber enables automated import of user acquisition data such as campaign spend, impressions, clicks, installs, and other key performance metrics directly from your Chartboost platform into your analytics pipeline.

Getting Started

1. Navigate to Configurations > Integrations > UA Grabbers in the Magify interface.
2. Find Chartboost in the list and click Add Grabber to create a new data source.
3. A configuration form will open.

This form is used to connect Magify to your Chartboost account by providing the required credentials (Client ID, Client Secret, Grabbers) and a custom integration name.

General Settings

Form Overview

• Top Section – General connection parameters: integration name, organization, and API credentials.

This section is used to configure access for both grabbers:

• Chartboost UA Country Grabber – retrieves User Acquisition campaign data from the Chartboost API with metrics grouped by country. Used for geo-level performance analysis and cost tracking.
• Chartboost UA Creative Grabber – retrieves User Acquisition campaign data from the Chartboost API with metrics grouped by creative assets. Used for analyzing the performance of individual ad creatives.

Name

A descriptive name for the grabber configuration. Helps identify the data source among other integrations.

Recommended format: Chartboost Grabber [CompanyName]

Optional field – recommended to fill in for easier navigation.

Organization

Select your organization from the dropdown list.

Client ID and Client Secret

Client ID and Client Secret are authentication credentials used to securely connect to the Chartboost Reporting API. They are required to generate access tokens that allow authorized data retrieval from your Chartboost account. These credentials are essential for enabling automated data collection in systems like Magify.

How to obtain them:

1. Log in to your Chartboost dashboard.
2. Click on your profile icon in the upper-right corner.
3. Select Company Info & Settings from the dropdown.
4. In the left-hand menu, click Access Management.
5. Scroll to the API v5 section.
6. Click Refresh API v5 Credentials to generate your new credentials.

• Client ID will be displayed in the input field.
• Client Secret will appear only once. Make sure to copy it.

The screenshot below shows an example where only the Client ID is visible.

UA Country Grabber and UA Creative Grabber

This section includes two grabbers responsible for fetching User Acquisition data from Chartboost:

• Chartboost UA Country Grabber – collects UA campaign metrics grouped by country (e.g., installs, spend, CPI, etc.) for geo-level performance analysis.
• Chartboost UA Creative Grabber – collects UA campaign metrics grouped by creative assets for analyzing the performance of individual ads.

Each grabber form contains the following fields:

• Name – an internal name for the grabber configuration, used for reference in the system. Optional field – recommended to fill in for easier navigation. Example: MyCompanyName – Chartboost UA Creative
• Is enabled – a toggle to activate or deactivate the grabber. Enable this option to start collecting data immediately. If left unchecked, the configuration is saved but inactive.

Saving the Configuration

Once all required fields are filled in, click Save to complete the setup. The enabled grabber will then begin collecting data from Chartboost according to the configured schedule.

By default, each grabber is set to load data for one day upon creation.

If you need to collect data for a longer period (e.g., for initial setup or data recovery), please contact us. We can manually adjust this value for you.