Google Ad Manager bietet eine SOAP API für die Berichterstellung und die Bearbeitung von Trafficking-Elementen, z. B. LineItems.
Clientbibliotheken sind in verschiedenen Sprachen verfügbar. Wie bei der AdX Seller API wird auch bei der Ad Manager API OAuth2 zur Authentifizierung genutzt.
Informationen zum Einstieg in Ihre erste API-Anfrage finden Sie unter Erste Schritte.
Berichterstellung in der Ad Manager API
Der ReportService der Ad Manager API bietet zwei Möglichkeiten zum Erstellen und Herunterladen von Berichten:
- Abfrage in der Benutzeroberfläche erstellen und basierend auf ihrer ID ausführen
- Eine Ad-hoc-ReportQuery erstellen.
Bei beiden Optionen besteht der API-Workflow aus vier Schritten:
- Rufen Sie runReportJob auf.
- Fragen Sie den Berichtsstatus mit getReportJobStatus ab.
- Rufen Sie mit getReportDownloadUrlWithOptions die URL zum fertigen Bericht ab.
- Laden Sie den Bericht von der zurückgegebenen URL herunter.
Weitere Informationen finden Sie im Leitfaden zu Berichten.
Zeitzonen für Berichte
Im Gegensatz zur Ad Exchange-REST-API für Verkäufer wird in den Berichten der Ad Manager API standardmäßig die Zeitzone Ihres Netzwerks verwendet. Sie können dies über das Feld TimeZoneType ändern.
Zuordnung von Messwerten und Dimensionen von AdX zu Ad Manager
In der Ad Manager Reporting API sind jetzt alle unterstützten Messwerte und Dimensionen für die Ad Exchange Seller REST API verfügbar. Einige Namen haben sich geändert, andere sind veraltet. Weitere Informationen finden Sie in den folgenden Tabellen.
Messwerte / Spalten
In dieser Tabelle werden AdX-Messwerte den Ad Manager-Spalten zugeordnet.
| AdX-Messwert | Ad Manager-Spalte | Name des Ad Manager-Abfragetools |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Für Active View aktivierte Impressionen |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Gemessene Active View-Impressionen |
| ACTIVE_VIEW_MEASURABLE_RATIO | (eingestellt) | (eingestellt) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Gesehene Active View-Impressionen |
| ACTIVE_VIEW_VIEWABLE_RATIO | (eingestellt) | (eingestellt) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Durchschnittliche Sichtbarkeitsdauer (Sek.) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Anzeigenimpressionen |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | Anzeigen- eCPM |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Anzeigenanfragen |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Abdeckung |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | Anzeigenanfragen-CTR |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | Anzeigenanfragen-eCPM |
| KLICKS | AD_EXCHANGE_CLICKS | Klicks |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Anzeigenanfragen von Deals |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Gebotsantworten von Deals |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Übereinstimmungsrate von Deals |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Anfragen mit Übereinstimmung des Deals |
| Einnahmen | AD_EXCHANGE_ESTIMATED_REVENUE | Geschätzter Umsatz |
| INDIVIDUAL_AD_IMPRESSIONS | (eingestellt) | (eingestellt) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | Anzeigenklickrate |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (neue Empfehlung) AD_EXCHANGE_AD_ECPM | (neue Empfehlung) Anzeigen-eCPM |
| LIFT_RATE | AD_EXCHANGE_LIFT | Anhebung |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Anfragen mit Übereinstimmung |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | Übereinstimmender eCPM |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Videoausstiegsrate |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Videoabbruchrate |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | 1. Videoquartil |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | 3. Videoquartil |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | TrueView-Überspringungsrate |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | TrueView-Aufrufe |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | TrueView-VTR |
Abmessungen
In dieser Tabelle werden die AdX-Dimensionen den Ad Manager-Dimensionen zugeordnet.
| AdX-Dimension | Ad Manager-Dimension | Name des Ad Manager-Abfragetools |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Web-Property |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Anzeigenplatzierungen |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Tags |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (nicht verfügbar) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Anzeigeninventare |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Werbetreibendendomains |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Werbetreibende |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Branchen des Werbetreibenden |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agenturen |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (nicht verfügbar) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Marken |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (nicht verfügbar) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Branding-Typen |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (nicht verfügbar) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Käufernetzwerke |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (nicht verfügbar) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Länder |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Creative-Größen |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (nicht verfügbar) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (nicht verfügbar) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Kanäle |
| DATUM | AD_EXCHANGE_DATE | Tage |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | Deal-IDs |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Dealnamen |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (nicht verfügbar) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | DFP-Anzeigenblöcke |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Anfragequellen |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Websites |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | Plattformen der Nachfrageseite |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Expandable-Typen |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Eigentumsrechte am Inventar |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Namen der Werbenetzwerkpartner |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | App-Namen |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Namen von Mobilfunkanbietern |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Geräte |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Inventartypen |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Betriebssysteme |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Bandbreite |
| MONTH | AD_EXCHANGE_MONTH | Monate |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Gerätekategorien |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (nicht verfügbar) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Produkte |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (nicht verfügbar) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Ausrichtungstypen |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (nicht verfügbar) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Transaktionstypen |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (nicht verfügbar) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URLs |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (nicht verfügbar) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Dauer von Videoanzeigen |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Videoanzeigentypen |
| WEEK | AD_EXCHANGE_WEEK | Wochen |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (nicht verfügbar) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Preismodellregeln |