Google Ad Manager bietet eine SOAP API für die Berichterstellung und die Bearbeitung von Trafficking-Entitäten wie LineItems.
Clientbibliotheken sind in mehreren Sprachen verfügbar. Wie bei der AdX Seller API wird bei der Ad Manager API OAuth2 für die Authentifizierung verwendet.
Informationen zu den ersten Schritten mit Ihrer ersten API-Anfrage finden Sie unter Erste Schritte.
Berichterstellung in der Ad Manager API
Die Ad Manager API ReportService bietet zwei Möglichkeiten zum Ausführen und Herunterladen von Berichten:
- Eine Abfrage in der Benutzeroberfläche erstellen und anhand ihrer ID ausführen.
- Erstellen einer Ad-hoc-ReportQuery.
Bei beiden Optionen besteht der API-Workflow aus vier Schritten:
- Rufen Sie runReportJob auf.
- Fragen Sie den Berichtsstatus mit getReportJobStatus ab.
- Rufen Sie die URL des fertigen Berichts mit getReportDownloadUrlWithOptions ab.
- Laden Sie den Bericht über die zurückgegebene URL herunter.
Weitere Informationen finden Sie im Berichtsleitfaden.
Zeitzonen für Berichte
Im Gegensatz zur Ad Exchange Seller REST API wird in der Ad Manager API standardmäßig die Zeitzone Ihres Netzwerks verwendet. Legen Sie das Feld TimeZoneType fest, um dies zu ändern.
Zuordnung von AdX-Messwerten und ‑Dimensionen zu Ad Manager
Alle unterstützten Messwerte und Dimensionen der Ad Exchange Seller REST API sind jetzt in der Ad Manager Reporting API verfügbar. Einige Namen haben sich geändert und einige wurden eingestellt. Weitere Informationen finden Sie in den Tabellen unten.
Messwerte / Spalten
In dieser Tabelle werden AdX-Messwerte 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 sichtbare Dauer (in Sekunden) |
| 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 für Deals |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Übereinstimmungsrate von Deals |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Anfragen mit Übereinstimmung von Deals |
| Einnahmen | AD_EXCHANGE_ESTIMATED_REVENUE | Geschätzter Umsatz |
| INDIVIDUAL_AD_IMPRESSIONS | (eingestellt) | (eingestellt) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | Anzeigen-Klickrate |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (neue Empfehlung) AD_EXCHANGE_AD_ECPM | (Neue Empfehlung) Anzeigen-eCPM |
| LIFT_RATE | AD_EXCHANGE_LIFT | Heiter |
| 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 | Erstes Video-Quartil |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Drittes Video-Quartil |
| 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 AdX-Dimensionen 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 | Anzeigenpositionen |
| 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 | Inventargrößen |
| 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 | Brandingtypen |
| 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 der Mobilfunkanbieter |
| 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 |
| MONAT | 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 | Targeting-Typen |
| 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 |
| WOCHE | 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 |