Celtra

The Switchboard Celtra Connector provides automated reporting of revenue and impression metrics.

Prerequisites

To configure access to the Switchboard Celtra Connector, you need:

  • App ID 
  • Secret Key

To obtain these credentials, contact your Celtra Account Manager.

Scheduling

Celtra Connector can be scheduled to run multiple times a day at a user-defined hour and timezone.

  • To configure this schedule, use the delay_hours parameter.
  • By default, the connector will run once at 6am PT.

Switchboard Script Syntax

import celtra_raw from {
    type: "celtra:async";
    key: "celtra_key";
    dimensions: [
        "utcDate",
        "campaignId",
        "campaignName",
        "placementName",
        "placementId",
        "creativeName",
        "creativeId"];
    metrics: [
        "sessions",
        "creativeLoads",
        "sessionsWithInteraction",
        "sessionsWithClick",
        "inlineVideoUniqueStarts",
        "inlineVideoFirstQuarterUniqueViews",
        "inlineVideoSecondQuarterUniqueViews",
        "inlineVideoThirdQuarterUniqueViews",
        "inlineVideoUniqueFinishes"];
    filters: ["accountId=XXXX"];
} using {
    utcDate: datetime;
    campaignId: string;
    campaignName: string;
    placementName: string;
    placementId: string;
    creativeName: string;
    creativeId: string;
    sessions: integer;
    creativeLoads: integer;
    sessionsWithInteraction: integer;
    sessionsWithClick: integer;
    inlineVideoUniqueStarts: integer;
    inlineVideoFirstQuarterUniqueViews: integer;
    inlineVideoSecondQuarterUniqueViews: integer;
    inlineVideoThirdQuarterUniqueViews: integer;
    inlineVideoUniqueFinishes: integer;
};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Celtra Documentation.

Required

metrics

A list of requested metrics.

For the metrics description, see the Celtra Documentation.

Required

filters

A list of dimensions to filter results:

  • accountId=xxxx
  • campaignId=xxxxxx

Also, you can filter using specific fields:

  • platformAdvIdRequestedRate.gt=1

At least one value is required