Search API Integration for Feed Statistics
Integrations enable the automatic update of your feed stats through API, ensuring seamless display within Swaarm's reports and dashboards.
An alternative to API integration for retrieving stats from your provider is the Provider Import Stats approach, which involves importing statistics via CSV.
How to Integrate with a Provider's API
Go to the Provider Details page
Click Edit in the top right corner
Click the Integrations tab
Choose the Partner (API) for integration
Fill out the required fields
Different integrations may require alternate information (e.g. API key, URL, Client, etc.)
Click Save
💡 Import Period
The system is set to import data from the preceding 7 days. For historical data import beyond this period, check out the Historical Import section below.
API Field Mapping for Data Synchronization
To ensure that API performance statistics are accurately attributed to the correct feeds, it's crucial to map the Feed > Provider Feed Id field correctly. This field may also be referred to as Segment, SubID, or similar terms. Documentation for your selected integration will be displayed to the right listing the supported API field mappings. This will ensure an accurate mapping of data with the corresponding feed in Swaarm when importing stats via API.
Historical Import
Importing historical data or reimporting corrected stats with API integrations is possible in Swaarm. After configuring your API Integration, a Historical Import button will appear. By clicking this button, you can specify the date range for importing historical data or reimporting any data requiring corrections.
💡Max Date Range
You have the option to choose a date range extending back up to six months.
Postback Details from API Imports
For full transparency and traceability in your API data imports, our platform includes the source API details directly within the Modification Description field of every postback. This feature provides you with clear visibility on the origin of your stats, whether they are recently imported or corrected.
For example, if stats are imported or synced from an API integration, then you will see entries such as: Imported from Swaarm on 2023-12-26 or Synced the latest update from Swaarm on 2023-12-30 in the modification description. This makes your data management process easier by displaying the source details of each postback easily.