Google Ad Manager propose une API SOAP pour créer des rapports et manipuler des entités de trafficking, comme LineItems.
Les bibliothèques clientes sont disponibles dans plusieurs langages. Comme l'API AdX Seller, l'API Ad Manager utilise OAuth2 pour l'authentification.
Pour commencer à utiliser votre première requête API, consultez Premiers pas.
Création de rapports dans l'API Ad Manager
Le service ReportService de l'API Ad Manager propose deux façons d'exécuter et de télécharger des rapports :
- 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 workflow de l'API se compose de quatre étapes :
- Appelez runReportJob.
- Interrogez l'état du rapport à l'aide de getReportJobStatus.
- Obtenez l'URL du rapport finalisé à l'aide de getReportDownloadUrlWithOptions.
- Téléchargez le rapport à partir de l'URL renvoyée.
Pour en savoir plus, consultez le guide sur les rapports.
Fuseaux horaires des rapports
Contrairement à l'API REST Ad Exchange Seller, les rapports de l'API Ad Manager utilisent par défaut le fuseau horaire de votre réseau. Pour modifier ce paramètre, 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 Seller sont désormais présentes dans l'API de reporting Ad Manager. Certains noms ont changé et d'autres ont été abandonnés. Pour en savoir plus, consultez les tableaux ci-dessous.
Métriques/Colonnes
Ce tableau met en correspondance les métriques AdX avec 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 d'annonces |
| 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 relatif aux accords |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Demandes avec correspondance associées 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 | Amélioration |
| 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'échec 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 | Chaînes |
| DATE | AD_EXCHANGE_DATE | Jours |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | ID des accords |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Nom 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 DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Sources de la demande |
| 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 | Nom 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 |
| SEMAINE | 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 |