Daasity Knowledge Base
Ask or search…
K

Integration Specifications

API Endpoints

The Daasity Emplifi extractor is built based on this Emplifi (Social Bakers) API Documentation. The following endpoints are used by Daasity to replicate data from Emplifi:

Entity Relationship Diagram (ERD)

This link diagram houses the ERD for the Daasity Emplifi integration illustrating the different out-of-box tables and keys used to join across tables. Hover over the embedded diagram to reveal controls to zoom and scroll.

Emplifi Schema

The Daasity Emplifi extractor creates these tables using the endpoints and replication methods listed. The data is mapped from source API endpoint to the table based on the mapping logic outlined in each table.
  • Custom Reports (Metrics)
  • Profiles
  • Posts
  • Aggregated Metrics
Note: The default tables in the Emplifi schema use the Posts API. The Profile Metrics and Aggregated Post Metrics API generate custom tables within the Daasity platform

Custom Reports (Metrics Endpoint)

This endpoint is a custom endpoint that must be configured within the Daasity App - review this article on how to setup custom reports
The integration runs on a daily basis with a primary and secondary extract:
  1. 1.
    Primary Extract: the integration extracts all the Profiles that are available within each platform
  2. 2.
    Secondary Extract: the integration extracts the dimensions and metrics as specified in the integration setup for each profile within each platform
The Emplifi integration has certain limitations as outlined here:
  • Can only extract 12 months of history at one time
  • Limited to 25 metrics per report
CAUTION: The Daasity integration with Emplifi only extracts data from the six (6) supported platforms in the Profile Metrics section of the Data API
All custom tables generated by the Emplifi integration will be created in the [emplifi] schema within the database.
  • Update Method: UPSERT
The table name and definition is based on the selections made when setting up each report within the Daasity app. Every report will have at a minimum the following fields:
Emplifi Field
Database Column
date.day
date_day
profile
profile
Additional metrics and dimensions can be selected based on the platform selected:
NOTE: When selecting additional metrics and dimensions, you can only select one dimension noted with a * and you can only select metrics with dimensions that are listed in the Social Bakers documentation above

Profiles Table

The [profiles] table is generated by requesting a list of all the profiles connected in Emplifi for each platform by using the List of Connected Profiles endpoint
This is the first extract run on a daily basis to determine if any new profiles have been added to Emplifi
  • Update method: UPSERT
  • Table Name: emplifi.profiles
Emplifi Field
Database Column
id
profile_id
N/A - determined based on the {network} passed into the API call
social_platform
name
name
timezone
timezone
insights_enabled
insights_enabled

Posts Table

Posts, Post Labels and Post Attachment tables are generated for 4 of the 6 supported platforms as two of the platforms do not provide any meaningful data.
The [social_platform_posts], [social_platform_post_label] and [social_platform_attachments] tables are generated by using these four endpoints:

Posts

  • Update method: INSERT
  • Table Name: emplifi.social_platform_posts
NOTE: Post Metrics are captured daily and use an insert so trends on how a post has performed over time can be measured. Thus to capture the current performance of a post you must select the most recent row from the table.
To see performance over time make sure to include the __sync_date in your reporting which identifies when the data was captured
Post Labels
  • Update method: UPSERT
  • Table Name: emplifi.social_platform_post_labels

Post Attachments

  • Update method: UPSERT
  • Table Name: emplifi.social_platform_posts_attachments

Aggregated Metrics

Aggregated metrics extracts are created dynamically through a support request to the Daasity team - please contact [email protected] to setup your aggregated metrics. The tables are generated by extracting data from the Aggregated Post Metrics API which must be configured for the specific metric and level of detail desired.
Each metric will be stored in its own table and can at one of two levels of detail, either at the profile level or at the profile / post label level
Profile
Tables names as [metric_profile] are at the profile level of detail and will have daily results across all platforms for that metric and profile
  • Update method: UPSERT
  • Table Name: emplifi.metric_profiles

Profile Post Labels

Extracts at the profile / post label level of detail will generate two tables for each metric.
[metric_profile_post_label] for daily results across all platforms for that metric at the profile and post-label level of detail
  • Update method: UPSERT
[metric_post_label] which contains the post labels for each profile
  • Update method: UPSERT
Last modified 28d ago