Xandr (AppNexus)

The Switchboard Xandr also known as AppNexus connector allows for automated reporting for:

  • Network Analytics
  • Network Device Analytics
  • Publisher Analytics
  • Seller Brand Review
  • Seller Fill and Delivery Network
  • Seller Site Domain

Prerequisites

To configure access to the Xandr Connector, you need:

  • Username
  • Password

To obtain the username and password, contact your Xandr Account Manager.

Scheduling

The Xandr 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.

Report Types

The following report types are available:

Network Analytics Report

Switchboard Script Syntax

import appnexus_network_analytics from {
    type: "appnexus_ng";
    key: "appnexus_key";
    report_type: "network_analytics";
    dimensions : [
       "day",
       "buyer_member_name",
       "advertiser_name",
       "deal_name",
       "brand_name"];
    metrics: [
       "imps",
       "clicks",
       "ctr",
       "total_convs",
       "convs_rate",
       "revenue",
       "rpm",
       "total_network_rpm",
       "cost",
       "cpm",
       "profit"];
} using {
    date: datetime;
    buyer_member_name: string;
    advertiser_name: string;
    deal_name: string;
    brand_name: string;
    imps: integer;
    clicks: integer;
    ctr: float;
    total_convs: integer;
    convs_rate: float;
    revenue: float;
    rpm: float;
    total_network_rpm: float;
    cost: float;
    cpm: float;
    profit: float;
};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Xandr Network Analytics Report Documentation.

At least one value is required

metrics

A list of requested metrics.

For the metrics description, see the Xandr Network Analytics Report Documentation.

At least one value is required

Network Device Analytics Report

Switchboard Script Syntax

download t from {
            type: "appnexus_ng";
            key: "appnexus_key";
            report_type: "network_device_analytics";
            dimensions: ["day","connection_type","imp_type"];
            metrics: ["imps","clicks","cost","cpm","booked_revenue","profit"];
} using {*};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Xandr Network Analytics Report Documentation.

At least one value is required

metrics

A list of requested metrics.

For the metrics description, see the Xandr Network Analytics Report Documentation.

At least one value is required

Publisher Analytics Report

Switchboard Script Syntax

download t from {
    type: "appnexus_ng";
    key: "appnexus_key";
    report_type: "publisher_analytics";
    dimensions: ["day","publisher_id"];
    metrics: ["clicks"];
    publisher_id: 2041265;    \\ <-- New parameter for publisher_analytics report
} using {*};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Xandr Network Analytics Report Documentation.

At least one value is required

metrics

A list of requested metrics.

For the metrics description, see the Xandr Network Analytics Report Documentation.

At least one value is required

publisher_id

The identifier of a publisher

required

Seller Brand Review Report

Switchboard Script Syntax

import seller_brand_review from {
    type: "appnexus_ng";
    key: "appnexus_key";
    report_type: "seller_brand_review";
    dimensions: [
        "month",
        "day",
        "buyer_member_id",
        "placement_id",
        "placement_name",
        "publisher_id",
        "geo_country",
        "geo_country_name",
        "imp_type_id",
        "creative_id",
        "site_id",
        "site_name",
        "brand_id",
        "brand_name",
        "payment_type",
        "revenue_type",
        "width",
        "height",
        "publisher_code",
        "site_code",
        "placement_code",
        "buyer_member_name",
        "media_type",
        "media_type_id",
        "publisher_name",
        "deal_id",
        "deal_name",
        "deal_code",
        "brand_offer_category_id",
        "brand_offer_category_name",
        "creative_audit_status_id",
        "creative_audit_status",
        "size"];
    metrics: [
        "imps",
        "clicks",
        "cost",
        "revenue",
        "booked_revenue",
        "reseller_revenue",
        "profit",
        "cpm",
        "total_convs",
        "convs_rate",
        "ctr",
        "rpm",
        "convs_per_mm",
        "imps_viewed",
        "view_measured_imps",
        "view_rate"];
} using {
    month: datetime;
    day: datetime;
    buyer_member_id: integer;
    placement_id: integer;
    placement_name: string;
    publisher_id: integer;
    geo_country: string;
    geo_country_name: string;
    imp_type_id: integer;
    creative_id: integer;
    site_id: integer;
    site_name: string;
    brand_id: integer;
    brand_name: string;
    payment_type: string;
    revenue_type: string;
    width: integer;
    height: integer;
    publisher_code: string;
    site_code: string;
    placement_code: string;
    buyer_member_name: string;
    media_type: string;
    media_type_id: integer;
    publisher_name: string;
    deal_id: integer;
    deal_name: string;
    deal_code: string;
    brand_offer_category_id: integer;
    brand_offer_category_name: string;
    creative_audit_status_id: integer;
    creative_audit_status: string;
    size: string;
    imps: integer;
    clicks: integer;
    cost: float;
    revenue: float;
    booked_revenue: float;
    reseller_revenue: float;
    profit: float;
    cpm: float;
    total_convs: integer;
    convs_rate: float;
    ctr: float;
    rpm: float;
    convs_per_mm: float;
    imps_viewed: integer;
    view_measured_imps: integer;
    view_rate: float;
};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Xandr Seller Brand Review Report Documentation.

At least one value is required

metrics

A list of requested metrics.

For the metrics description, see the Xandr Seller Brand Review Report Documentation.

At least one value is required

Seller Fill and Delivery Network Report

Switchboard Script Syntax

import seller_fill_report from {
    type: "appnexus_ng";
    key: "appnexus_key";
    report_type: "seller_fill_and_delivery_network";
    dimensions: ["call_type",
       "day",
       "deal_id",
       "deal_name",
       "geo_country",
       "geo_country_name",
       "hour",
       "mobile_application_id",
       "month",
       "placement_id",
       "placement_name",
       "publisher_id",
       "publisher_name",
       "seller_member_id",
       "seller_member_name",
       "site_id",
       "site_name",
       "site_domain",
       "supply_type"];
    metrics: [
        "bid_sent_no_responses",
        "defaults",
        "default_no_responses",
        "filtered_requests",
        "imps_kept",
        "imps_resold",
        "psas_or_blanks",
        "seller_revenue",
        "total_ad_requests",
        "total_ad_responses",
        "video_default_errors",
        "video_player_errors"];
} using {
    call_type: string;
    day: datetime;
    deal_id: integer;
    deal_name: string;
    geo_country: string;
    geo_country_name: string;
    hour: datetime;
    mobile_application_id: string;
    month: datetime;
    placement_id: integer;
    placement_name: string;
    publisher_id: integer;
    publisher_name: string;
    seller_member_id: integer;
    seller_member_name: string;
    site_id: integer;
    site_name: string;
    site_domain: string;
    supply_type: string;
    bid_sent_no_responses: integer;
    defaults: integer;
    default_no_responses: integer;
    filtered_requests: integer;
    imps_kept: integer;
    imps_resold: integer;
    psas_or_blanks: integer;
    seller_revenue: float;
    total_ad_requests: integer;
    total_ad_responses: integer;
    video_default_errors: integer;
    video_player_errors: integer;
};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Xandr Seller Fill and Delivery Network Report Documentation.

At least one value is required

metrics

A list of requested metrics.

For the metrics description, see the Xandr Seller Fill and Delivery Network Report Documentation.

At least one value is required

Seller Site Domain Report

Switchboard Script Syntax

import seller_site_domain from {
    type: "appnexus_ng";
    key: "appnexus_key";
    report_type: "seller_site_domain";
    dimensions: [
        "month",
        "day",
        "seller_member_id",
        "seller_member_name",
        "content_category_id",
        "content_category_name",
        "site_id",
        "site_name",
        "site_domain",
        "placement_id",
        "placement_name",
        "publisher_id",
        "publisher_name",
        "imp_type_id",
        "imp_type_name",
        "audit_type_id",
        "audit_type_name",
        "exposed_for_resale_id",
        "exposed_for_resale",
        "domains_exposed_id",
        "domains_exposed",
        "operating_system_id",
        "operating_system_name",
        "supply_type",
        "mobile_application_id",
        "mobile_application_name",
        "fold_position_id",
        "fold_position",
        "age_bucket",
        "age_bucket_id",
        "gender",
        "is_remarketing"];
    metrics: [
        "imps",
        "clicks",
        "network_revenue",
        "imps_viewed",
        "view_measured_imps",
        "view_rate",
        "view_measurement_rate"];
} using {
    month: datetime;
    day: datetime;
    seller_member_id: integer;
    seller_member_name: string;
    content_category_id: integer;
    content_category_name: string;
    site_id: integer;
    site_name: string;
    site_domain: string;
    placement_id: integer;
    placement_name: string;
    publisher_id: integer;
    publisher_name: string;
    imp_type_id: integer;
    imp_type_name: string;
    audit_type_id: integer;
    audit_type_name: string;
    exposed_for_resale_id: integer;
    exposed_for_resale: string;
    domains_exposed_id: integer;
    domains_exposed: string;
    operating_system_id: integer;
    operating_system_name: string;
    supply_type: string;
    mobile_application_id: string;
    mobile_application_name: string;
    fold_position_id: integer;
    fold_position: string;
    age_bucket: string;
    age_bucket_id: string;
    gender: string;
    is_remarketing: boolean;
    imps: integer;
    clicks: integer;
    network_revenue: float;
    imps_viewed: integer;
    view_measured_imps: integer;
    view_rate: float;
    view_measurement_rate: float;
};

Parameters

Parameter

Description

Required/Optional?

dimensions

A list of requested dimensions.

For the dimension’s description, see the Xandr Seller Site Domain Documentation.

Required

metrics

A list of requested metrics.

For the metrics description, see the Xandr Seller Site Domain Documentation.

Required