Google Ad Manager ofrece una API de SOAP para generar informes y manipular entidades de coordinación de anuncios, como LineItems.
Las bibliotecas cliente están disponibles en varios lenguajes. Al igual que la API de AdX Seller, la API de Ad Manager usa OAuth2 para la autenticación.
Para comenzar con tu primera solicitud a la API, consulta Comienza a usar la API.
Informes en la API de Ad Manager
La API de Ad Manager ReportService ofrece dos formas de ejecutar y descargar informes:
- Crear una consulta en la IU y ejecutarla según su ID
- Construcción de un ReportQuery ad hoc
Con cualquiera de las opciones, el flujo de trabajo de la API consta de cuatro pasos:
- Llama a runReportJob.
- Sondea el estado del informe con getReportJobStatus.
- Obtén la URL del informe completado con getReportDownloadUrlWithOptions.
- Descarga el informe desde la URL que se devolvió.
Para obtener más detalles, consulta la guía de informes.
Zonas horarias de los informes
A diferencia de la API de Ad Exchange Seller REST, en la API de Ad Manager, los informes se establecen de forma predeterminada en la zona horaria de tu red. Para cambiarlo, establece el campo TimeZoneType.
Asignación de métricas y dimensiones de AdX a Ad Manager
Todas las métricas y dimensiones admitidas de la API de REST de Ad Exchange Seller ahora están presentes en la API de informes de Ad Manager. Algunos nombres cambiaron y otros dejaron de estar disponibles. Consulta las siguientes tablas para obtener más detalles.
Métricas / columnas
En esta tabla, se asignan las métricas de AdX a las columnas de Ad Manager.
| Métrica de AdX | Columna de Ad Manager | Nombre de la herramienta de consultas de Ad Manager |
|---|---|---|
| ACTIVE_VIEW_ELIGIBLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_ENABLED_IMPRESSIONS | Impresiones habilitadas de Vista activa |
| ACTIVE_VIEW_MEASURABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_MEASURED_IMPRESSIONS | Impresiones medidas de Vista activa |
| ACTIVE_VIEW_MEASURABLE_RATIO | (obsoleto) | (obsoleto) |
| ACTIVE_VIEW_VIEWABLE_COUNT | AD_EXCHANGE_ACTIVE_VIEW_VIEWED_IMPRESSIONS | Impresiones visibles de Vista activa |
| ACTIVE_VIEW_VIEWABLE_RATIO | (obsoleto) | (obsoleto) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Tiempo promedio de visibilidad (segundos) |
| AD_IMPRESSIONS | AD_EXCHANGE_IMPRESSIONS | Impresiones de anuncios |
| AD_IMPRESSIONS_RPM | AD_EXCHANGE_AD_ECPM | eCPM del anuncio |
| AD_REQUESTS | AD_EXCHANGE_AD_REQUESTS | Solicitudes de anuncios |
| AD_REQUESTS_COVERAGE | AD_EXCHANGE_COVERAGE | Cobertura |
| AD_REQUESTS_CTR | AD_EXCHANGE_AD_REQUEST_CTR | CTR de solicitud de anuncio |
| AD_REQUESTS_RPM | AD_EXCHANGE_AD_REQUEST_ECPM | eCPM de solicitud de anuncio |
| CLICS | AD_EXCHANGE_CLICKS | Clics |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Solicitudes de anuncios asociadas a un acuerdo |
| DEALS_BID_RESPONSES | AD_EXCHANGE_DEALS_BID_RESPONSES | Respuestas de ofertas de acuerdos |
| DEALS_MATCH_RATE | AD_EXCHANGE_DEALS_MATCH_RATE | Porcentaje de coincidencias de acuerdos |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Solicitudes coincidentes asociadas a un acuerdo |
| INGRESOS | AD_EXCHANGE_ESTIMATED_REVENUE | Ingresos estimados |
| INDIVIDUAL_AD_IMPRESSIONS | (obsoleto) | (obsoleto) |
| INDIVIDUAL_AD_IMPRESSIONS_CTR | AD_EXCHANGE_AD_CTR | CTR del anuncio |
| INDIVIDUAL_AD_IMPRESSIONS_RPM | (nueva recomendación) AD_EXCHANGE_AD_ECPM | (Nueva recomendación) eCPM del anuncio |
| LIFT_RATE | AD_EXCHANGE_LIFT | Realce |
| MATCHED_AD_REQUESTS | AD_EXCHANGE_MATCHED_REQUESTS | Solicitudes coincidentes |
| MATCHED_AD_REQUESTS_CTR | AD_EXCHANGE_CTR | CTR |
| MATCHED_AD_REQUESTS_RPM | AD_EXCHANGE_MATCHED_ECPM | Matched eCPM |
| VIDEO_AD_ABANDONMENT_RATIO | AD_EXCHANGE_VIDEO_ABANDONMENT_RATE | Porcentaje de abandono del video |
| VIDEO_AD_DROPOFF_RATIO | AD_EXCHANGE_VIDEO_DROPOFF_RATE | Porcentaje de abandono del video |
| VIDEO_AD_QUARTILE_ONE | AD_EXCHANGE_VIDEO_QUARTILE_1 | Cuartil 1 del video |
| VIDEO_AD_QUARTILE_THREE | AD_EXCHANGE_VIDEO_QUARTILE_3 | Cuartil 3 del video |
| VIDEO_AD_SKIPPABLE_SKIP_RATIO | AD_EXCHANGE_VIDEO_TRUEVIEW_SKIP_RATE | Porcentaje de omisiones de TrueView |
| VIDEO_AD_SKIPPABLE_VIEWS | AD_EXCHANGE_VIDEO_TRUEVIEW_VIEWS | Vistas de TrueView |
| VIDEO_AD_SKIPPABLE_VTR | AD_EXCHANGE_VIDEO_TRUEVIEW_VTR | VTR de TrueView |
Dimensiones
En esta tabla, se asignan las dimensiones de AdX a las dimensiones de Ad Manager.
| Dimensión de AdX | Dimensión de Ad Manager | Nombre de la herramienta de consultas de Ad Manager |
|---|---|---|
| AD_CLIENT_ID | AD_EXCHANGE_WEB_PROPERTY_CODE | Propiedad web |
| AD_LOCATION | AD_EXCHANGE_AD_LOCATION | Ubicaciones de los anuncios |
| AD_TAG_NAME | AD_EXCHANGE_TAG_NAME | Etiquetas |
| AD_UNIT_SIZE_CODE | AD_EXCHANGE_INVENTORY_SIZE_CODE | (No disponible) |
| AD_UNIT_SIZE_NAME | AD_EXCHANGE_INVENTORY_SIZE | Tamaños de inventario |
| ADVERTISER_DOMAIN | AD_EXCHANGE_ADVERTISER_DOMAIN | Dominios de anunciantes |
| ADVERTISER_NAME | AD_EXCHANGE_ADVERTISER_NAME | Anunciantes |
| ADVERTISER_VERTICAL | AD_EXCHANGE_ADVERTISER_VERTICAL | Verticales del anunciante |
| AGENCY_NAME | AD_EXCHANGE_AGENCY | Agencias |
| BID_TYPE_CODE | AD_EXCHANGE_BID_TYPE_CODE | (No disponible) |
| BRAND_NAME | AD_EXCHANGE_BRAND_NAME | Marcas |
| BRANDING_TYPE_CODE | AD_EXCHANGE_BRANDING_TYPE_CODE | (No disponible) |
| BRANDING_TYPE_NAME | AD_EXCHANGE_BRANDING_TYPE | Tipos de desarrollo de la marca |
| BUYER_NETWORK_ID | AD_EXCHANGE_BUYER_NETWORK_ID | (No disponible) |
| BUYER_NETWORK_NAME | AD_EXCHANGE_BUYER_NETWORK_NAME | Redes de compradores |
| COUNTRY_CODE | AD_EXCHANGE_COUNTRY_CODE | (No disponible) |
| COUNTRY_NAME | AD_EXCHANGE_COUNTRY_NAME | Países |
| CREATIVE_SIZE | AD_EXCHANGE_CREATIVE_SIZES | Tamaños de creatividades |
| CUSTOM_CHANNEL_CODE | AD_EXCHANGE_CUSTOM_CHANNEL_CODE | (No disponible) |
| CUSTOM_CHANNEL_ID | AD_EXCHANGE_CUSTOM_CHANNEL_ID | (No disponible) |
| CUSTOM_CHANNEL_NAME | AD_EXCHANGE_CHANNEL_NAME | Canales |
| FECHA | AD_EXCHANGE_DATE | Días |
| DEAL_ID | AD_EXCHANGE_DEAL_ID | IDs de acuerdos |
| DEAL_NAME | AD_EXCHANGE_DEAL_NAME | Nombres de acuerdos |
| DFP_AD_UNIT_ID | AD_EXCHANGE_DFP_AD_UNIT_ID | (No disponible) |
| DFP_AD_UNITS | AD_EXCHANGE_DFP_AD_UNIT | Unidades de anuncios de DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Fuentes de las solicitudes |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Sitios |
| DSP_NAME | AD_EXCHANGE_DSP_BUYER_NETWORK_NAME | Plataformas orientadas a la demanda |
| EXPANSION_TYPE_NAME | AD_EXCHANGE_EXPANSION_TYPE | Tipos expandibles |
| INVENTORY_OWNERSHIP | AD_EXCHANGE_INVENTORY_OWNERSHIP | Propiedad del inventario |
| INVENTORY_PARTNER_NAME | AD_EXCHANGE_NETWORK_PARTNER_NAME | Nombres de los socios de red |
| MOBILE_APP_NAME | AD_EXCHANGE_MOBILE_APP_NAME | Nombres de aplicaciones |
| MOBILE_CARRIER_NAME | AD_EXCHANGE_MOBILE_CARRIER_NAME | Nombres de operadores |
| MOBILE_DEVICE_NAME | AD_EXCHANGE_MOBILE_DEVICE_NAME | Dispositivos |
| MOBILE_INVENTORY_TYPE | AD_EXCHANGE_MOBILE_INVENTORY_TYPE | Tipos de inventario |
| MOBILE_OS_VERSION | AD_EXCHANGE_OPERATING_SYSTEM | Sistemas operativos |
| MOBILE_USER_BANDWIDTH | AD_EXCHANGE_USER_BANDWIDTH_NAME | Ancho de banda |
| MES | AD_EXCHANGE_MONTH | Meses |
| PLATFORM_TYPE_NAME | AD_EXCHANGE_DEVICE_CATEGORY | Categorías de dispositivos |
| PRODUCT_CODE | AD_EXCHANGE_PRODUCT_CODE | (No disponible) |
| PRODUCT_NAME | AD_EXCHANGE_PRODUCT_NAME | Productos |
| TARGETING_TYPE_CODE | AD_EXCHANGE_TARGETING_TYPE_CODE | (No disponible) |
| TARGETING_TYPE_NAME | AD_EXCHANGE_TARGETING_TYPE | Tipos de segmentación |
| TRANSACTION_TYPE_CODE | AD_EXCHANGE_TRANSACTION_TYPE_CODE | (No disponible) |
| TRANSACTION_TYPE_NAME | AD_EXCHANGE_TRANSACTION_TYPE | Tipos de transacciones |
| URL_CHANNEL_ID | AD_EXCHANGE_URL_ID | (No disponible) |
| URL_CHANNEL_NAME | AD_EXCHANGE_URL | URL |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (No disponible) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Duraciones de los anuncios de video |
| VIDEO_AD_FORMAT | AD_EXCHANGE_VIDEO_AD_TYPE | Tipos de anuncios de video |
| SEMANA | AD_EXCHANGE_WEEK | Semanas |
| WINNING_BID_RULE_ID | AD_EXCHANGE_PRICING_RULE_ID | (No disponible) |
| WINNING_BID_RULE_NAME | AD_EXCHANGE_PRICING_RULE_NAME | Reglas de fijación de precios |