Verizon Media Group Ads

The Verizon Media Group connector provides automated access to ad impression and revenue reports.

Prerequisites

Both the Analytics Report and the DSP Report require a Client ID and Client Secret but where the credentials come from vary based on the type of report.

Analytics Report

For the Analytics Report, users must have a login for a Publisher product (Video SSP, Ad Server, or SSP) or direct access to the Analytics Reports portal data.

Credentials for Verizon Analytics are sourced from your vendor. Please contact them to obtain your credentials.

DSP

Credentials for Verizon DSP (Client ID and Client Secret) can be generated in the Verizon DSP UI

Follow the steps of the Developer Network Documentation enable API access for your account.

Scheduling

The Verizon Media Group 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.

Analytics Report

Parameters

report_id
REQUIRED To use the Reporting API, the relevant Report ID must be known.
report_parameters
OPTIONAL Each report has a set of parameters that correspond to filters on the Analytics Reports user interface.

For details on how to obtain a report_id or report_parameters refer to the Verizon Media API documentation.

Sample Switchboard Script


import verizon_analytics_raw from {
    type: "vmg:analytics";
    key: "<key_name>";
    report_id: "XXXXXXXXXXXXXXX";
    report_parameters: {"ocOrgId": "XXXXXXXX";};
    timezone: "US/Pacific";
    delay_hours: 4;
    repull_days: 7;
} using { 
    col_1: string;
    col_2: integer;
};

DSP Report

Parameters

dimensions
REQUIRED A dimension may represent an attribute of a consumer, segment, campaign, ad, or line. For example, the MobileOs dimension tracks the operating system (Android, iOS, etc.) of consumer mobile devices.

For a full list of supported dimension types, see the Verizon Media API documentation.

metrics
REQUIRED A metric is quantitative measurement of data: a number (a sum, average, or ratio) that measures the performance of a line or campaign during the reporting period

For a full list of supported metric types, see the Verizon Media API documentation.

timezone
REQUIRED Specifies a string that defines time zone of report data. If no timezone value is specified, the America/New_York attribute is used.

For the full list of available timezones, please see the following Verizon Media API documentation.

Sample Switchboard Script


download verizon_dsp_raw from {
    type: "vmg:dsp";
    key: "<key_name>";
    dimensions: ["Campaign",
                "Line"];
    metrics: ["Impressions",
             "Clicks",
             "CTR",
             "CPC",
            "Advertiser Spending",
            "Moat Measurable Impressions",
            "Moat Viewable Impressions",
            "Moat Viewable Rate"];
    timezone: "America/New_York";
    lookback_days: 30;
} using {
    hour: datetime("MM/dd/YY HH:mm");
    order_id: integer;
    order: string;
    line_id: integer;
    line: string;
    impressions: string;
    clicks: string;
    ctr: string;
    moat_measurable_impressions: string;
    moat_viewable_impressions:  string;
    moat_viewable_rate:  string;
    advertiser_spending:  string;
    cpc:  string;
};