LiveIntent

The Switchboard LiveIntent connector provides automated ingestion of publisher and advertiser reports

Prerequisites
Scheduling
Advertiser Reports
- Parameters
Publisher Reports
- Parameters
- Sample Switchboard Script

Prerequisites

To configure access to the LiveIntent connector, you’ll need:

The Email Address and Password you use to access your LiveIntent account.

Scheduling

The LiveIntent connector can be scheduled to ingest data once per day at a user-defined hour and timezone. By default, the connector will run once at 6am PT. See Daily Scheduling for more information.

Advertiser Reports

Parameters

Parameter	Description	Required/Optional?
`dimensions`	A list of requested reporting dimensions. Allowed values are: Advertiser ID Advertiser Name Budget Type Campaign ID Campaign Name Campaign Budget Campaign Start Date Campaign End Date Campaign Bid Amount Creative ID Creative Name Creative Size Creative URL Click-Through URL Demand Type Guaranteed Line Item ID Line Item Name Line Item Start Date Line Item End Date Line Item Bid Amount Line Item Budget Pacing Publisher ID Status Age Gender Device Type Metro (DMA) Country Region OS Browser	Required
`metrics`	A list of requested reporting metrics. Allowed values are: Impressions Clicks Conversions PVC Advertiser Spent GrossECPM GrossECPC GrossECPA CTR CCR UPA ROAS	Required

Publisher Reports

Parameters

Parameter	Description	Required/Optional?
`dimensions`	A list of requested reporting dimensions. Allowed values are: Advertiser ID Advertiser Name Budget Type Demand Type Mail Type Creative ID Creative Name Publisher ID Publisher Name Template ID Template Name Section ID Section Name Campaign ID Campaign Name Campaign Start Date Campaign End Date Campaign Bid Amount Campaign Budget Line Item Start Date Line Item End Date Line Item Bid Amount Line Item Budget Line Item ID Line Item Name Creative ID Creative Name Creative Size Creative URL Click-Through URL Bidder ID Bidder Seat Bidder Campaign ID Deal ID Status Pacing Guaranteed Advertiser Domain Age Browser Country Device Type Device Maker Email Domain Gender ISP Metro List OS Placement ID Region	Required
`metrics`	A list of requested reporting metrics. Allowed values are: Ad Serving Cost Ad Serving Fee Adjusted CTR Adjusted Impressions Adjusted NetECPM Apple MPP Billable Impressions Booked CPM CCR Clicks Conversions CTR Fill Rate First Impressions First Impressions CTR Impressions NetECPM NoAds Publisher Revenue PVC Reopens UPA	Required

Sample Switchboard Script

import liveintent_publisher from {
    type: "live_intent_ng";
    key: "live_intent_key";
    report_type: "publisher";
    dimensions: [
        "Advertiser ID",
        "Advertiser Name",
        "Creative ID",
        "Creative Name",
        "Demand Type",
        "Line Item ID",
        "Line Item Name",
        "Publisher ID",
        "Publisher Name",
        "Section ID",
        "Section Name",
        "Template ID",
        "Template Name"
    ];
    metrics: [
        "First Impressions",
        "Impressions",
        "Clicks",
        "Conversions",
        "Publisher Revenue",
        "NetECPM",
        "CTR",
        "CCR"
    ];
 } using {
    timestamp: datetime;
    event: {
        "Advertiser": string;
        "Advertiser ID": string;
        "CCR": float;
        "CTR": float;
        "Clicks": integer;
        "Conversions": integer;
        "Creative": string;
        "Creative ID": string;
        "Demand Type": string;
        "First Impressions": integer;
        "Impressions": integer;
        "Line Item": string;
        "Line Item ID": string;
        "Net Revenue": float;
        "NetECPM": float;
        "Publisher": string;
        "Publisher ID": string;
        "Publisher Revenue": float;
        "Section": string;
        "Section ID": string;
        "Template": string;
        "Template ID": string;
    };
 };