Google AdMob

The Switchboard Google AdMob connector provides automated ingestion of both Network and Mediation reports.

Prerequisites

To configure access to the Switchboard AdMob connector, you need:

  • Google Service Account credential or a Google User credential
  • Publisher ID

Scheduling

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

AdMob Network Reports

To import AdMob Network reports, use the admob:network import type.

Sample Switchboard Script

download admob_network_report from {
    type: "admob:network";
    key: "admob_key";
    publisher_id: 123;
    dimensions:["DATE", "AD_UNIT"];
    metrics: ["AD_REQUESTS"];
} using {
   date: datetime;
   ad_unit: string;
   ad_requests: integer;
}; 

Parameters

Parameter Description Required/Optional?
publisher_id The numeric id of your publisher network Required
dimensions A string list containing one or
more of the following options:

DATE
MONTH
WEEK
AD_UNIT
APP
AD_TYPE
COUNTRY
FORMAT
PLATFORM
Required
metrics A string list containing one or
more of the following options:

AD_REQUESTS
CLICKS
ESTIMATED_EARNINGS
IMPRESSIONS
IMPRESSION_CTR
IMPRESSION_RPM
MATCHED_REQUESTS
MATCH_RATE
SHOW_RATE
Required

AdMob Mediation Reports

To import AdMob Mediation reports, use the admob:mediation import type.

Sample Switchboard Script

download admob_mediation_report from {
    type: "admob:mediation";
    key: "admob_key";
    publisher_id: 123;
    dimensions:["DATE", "AD_SOURCE"];
    metrics: ["AD_REQUESTS"];
} using {
   date: datetime;
   ad_source: string;
   ad_requests: integer;
}; 

Parameters

Parameter Description Required/Optional?
publisher_id The numeric id of your publisher network Required
dimensions A string list containing one or
more of the following options:

DATE
MONTH
WEEK
AD_SOURCE
AD_SOURCE_INSTANCE
AD_UNIT
APP
MEDIATION_GROUP
COUNTRY
FORMAT
PLATFORM
Required
metrics A string list containing one or
more of the following options:

AD_REQUESTS
CLICKS
ESTIMATED_EARNINGS
IMPRESSIONS
IMPRESSION_CTR
MATCHED_REQUESTS
MATCH_RATE
OBSERVED_ECPM
Required