Google Ad Manager propose une API SOAP qui permet de générer des rapports et de manipuler les entités de trafficking, comme LineItems.
Des bibliothèques clientes sont disponibles dans plusieurs langages. Tout comme l'API AdX côté vendeur, l'API Ad Manager utilise OAuth2 pour l'authentification.
Pour commencer avec votre première requête API, consultez Premiers pas.
Créer des rapports dans l'API Ad Manager
L'API ReportService de l'API Ad Manager permet de générer et de télécharger des rapports de deux façons:
- Créer une requête dans l'interface utilisateur et l'exécuter en fonction de son ID
- Créer une requête ReportQuery ad hoc
Dans les deux cas, le flux de travail de l'API se compose de quatre étapes:
- Appelez runReportJob.
- Interrogez l'état du rapport à l'aide de getReportJobStatus.
- Obtenez l'URL du rapport terminé en utilisant getReportDownloadUrlWithOptions.
- Téléchargez le rapport à partir de l'URL affichée.
Pour en savoir plus, consultez le guide sur les rapports.
Fuseaux horaires des rapports
Contrairement à l'API REST Ad Exchange pour vendeur, dans les rapports de l'API Ad Manager, le fuseau horaire de votre réseau est utilisé par défaut. Pour modifier cela, définissez le champ TimeZoneType.
Mappage des métriques et dimensions AdX vers Ad Manager
Toutes les métriques et dimensions de l'API REST Ad Exchange pour vendeur compatibles sont désormais présentes dans l'API Reporting d'Ad Manager. Certains noms ont changé et quelques-uns sont obsolètes. Pour en savoir plus, consultez les tableaux ci-dessous.
Métriques / Colonnes
Ce tableau met en correspondance les métriques AdX et les colonnes Ad Manager.
| Métrique AdX | Colonne Ad Manager | Nom de l'éditeur de requêtes Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Impressions Active View activées |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Impressions Active View mesurées |
| ACTIVE_VIEW_MEASURABLE_RATIO | (obsolète) | (obsolète) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Impressions Active View vues |
| ACTIVE_VIEW_VIEWABLE_RATIO | (obsolète) | (obsolète) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Durée de visibilité moyenne (en secondes) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Impressions de l'annonce |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM de l'annonce |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Demandes d'annonces |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Couverture |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR demandes d'annonces |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM demandes d'annonces |
| CLICS | AD_EXCHANGE_CLICKS | Clics |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Demandes d'annonces associées aux accords |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Réponses aux enchères associées aux accords |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Taux de correspondance associé aux accords |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Demandes avec correspondance relatives aux accords |
| REVENUS | AD_EXCHANGE_ESTIMATED_REVENUE | Revenus estimés |
| INDIVIDUAL_AD_IMPRESSIONS | (obsolète) | (obsolète) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR des annonces |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (nouvelle recommandation) AD_EXCHANGE_AD_ECPM | (nouvelle recommandation) eCPM de l'annonce |
| LIFT_RATE | AD_EXCHANGE_LIFT | Développement |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Demandes avec correspondance |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | eCPM avec correspondance |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Taux d'abandon de la vidéo |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Taux d'abandon de la vidéo |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Quart 1 de la vidéo |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Quart 3 de la vidéo |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Taux de désactivation TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Vues TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | Taux d'affichage TrueView |
Dimensions
Ce tableau met en correspondance les dimensions AdX et les dimensions Ad Manager.
| Dimension AdX | Dimension Ad Manager | Nom de l'éditeur de requêtes Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Propriété Web |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Emplacements des annonces |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Tags |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (Non disponible) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Tailles d'inventaire |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Domaines de l'annonceur |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Annonceurs |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Secteurs des annonceurs |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agences |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (Non disponible) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Marques |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (Non disponible) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Types de branding |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (Non disponible) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Réseaux d'acheteurs |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (Non disponible) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Pays |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Tailles des créations |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (Non disponible) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (Non disponible) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Canaux |
| DATE | AD_EXCHANGE_DATE | Jours |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | ID des accords |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Noms des accords |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (Non disponible) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Blocs d'annonces Ad Manager |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Sources des demandes |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Sites |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | DSP |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Types d'annonces extensibles |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Propriété de l'inventaire |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Noms des partenaires du réseau |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Noms d'applications |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Noms des opérateurs |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Appareils |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Types d'inventaire |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Systèmes d'exploitation |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Bande passante |
| MONTH | AD_EXCHANGE_MONTH | Mois |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Catégories d'appareils |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (Non disponible) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Produits |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (Non disponible) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Types de ciblage |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (Non disponible) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Types de transactions |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (Non disponible) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (Non disponible) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Durées des annonces vidéo |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Types d'annonces vidéo |
| WEEK | AD_EXCHANGE_WEEK | Semaines |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (Non disponible) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Règles de tarification |