Table Of Contents

Terminus Plugin

Introduction

The Mitto plugin terminus provides an access to the Terminus resources via Terminus Platform API. Plugin retrieves the latest export jobs from the Terminus API and stores them as CSV files in the Mitto files directory so they will be shown in the Files menu and could be processed by other Mitto jobs. Mitto plugin Terminus downloads two types of reports available in Terminus API:

  • TACTIC_PERFORMANCE - An export of Clicks, Impressions, and Spend per day for the last 30 days for all tactics

  • DISPLAY_TACTIC_ACCOUNT_PERFORMANCE- An export of clicks, impressions, and spend per account per tactic for the last 30 days. More info about the report schema could be found here

Authentication

Authentication with the Terminus Platform API is established with the API key. To request Terminus Platform API access, a user must submit a support request. When creating a terminus job a user should provide an API key directly in the wizard screen or select the one from named credentials. When creating generic terminus credentials the format is the following: {"api_key": "<My terminus API key>"}

Terminus configuration

Terminus can be configured to create daily exports of two types of reports on a daily/weekly schedule. After this reports would be available through its API and could be downloaded by the Mitto job. More info about schedule configuration could be found here

Mitto plugin terminus workflow

  1. The wizard consists of the one screen where the user should select existing Terminus API credentials or provide an exact API Key. At this stage, no credentials validation is performed.

  2. After finishing the wizard Mitto create a new Sequence with two child jobs (One per each report type). After this, the user could set up a sequence schedule to download reports.