Google Ad Manager ofrece una API de SOAP para denunciar y manipular las 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 Cómo comenzar.
Informes en la API de Ad Manager
El servicio ReportService de la API de Ad Manager ofrece dos maneras de ejecutar y descargar informes:
- Crear una consulta en la IU y ejecutarla en función de su ID
- Crear una ReportQuery ad hoc
Con cualquiera de las dos opciones, el flujo de trabajo de la API consta de cuatro pasos:
- Llama a runReportJob.
- Sondea el estado del informe con getReportJobStatus.
- Obtenga la URL del informe completo mediante getReportDownloadUrlWithOptions.
- Descarga el informe de la URL que se muestra.
Para obtener más detalles, consulta la guía de informes.
Zonas horarias de los informes
A diferencia de la API de REST para vendedor de Ad Exchange, en los informes de la API de Ad Manager se establece de forma predeterminada la zona horaria de tu red. Para cambiar esto, configura el campo TimeZoneType.
Asignación de métricas y dimensiones de AdX a Ad Manager
Todas las métricas y dimensiones compatibles de la API de REST para vendedor de Ad Exchange ahora están presentes en la API de informes de Ad Manager. Algunos nombres cambiaron y otros dejaron de estar disponibles. Consulta las tablas que aparecen a continuación 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 vistas de Vista activa |
| ACTIVE_VIEW_VIEWABLE_RATIO | (obsoleto) | (obsoleto) |
| ACTIVE_VIEW_VIEWABLE_TIME | AD_EXCHANGE_AVERAGE_VIEWABLE_TIME | Tiempo de visibilidad promedio (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 | Clicks |
| COST_PER_CLICK | AD_EXCHANGE_CPC | CPC |
| DEALS_AD_REQUESTS | AD_EXCHANGE_DEALS_AD_REQUESTS | Solicitudes de anuncios de ofertas |
| 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 ofertas |
| DEALS_MATCHED_REQUESTS | AD_EXCHANGE_DEALS_MATCHED_REQUESTS | Solicitudes coincidentes de acuerdos |
| 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 | eCPM coincidente |
| 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 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 | Brands |
| 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 | ID del acuerdo |
| 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 | Bloques de anuncios de DFP |
| DFP_REQUEST_SOURCE | AD_EXCHANGE_REQUEST_SOURCES | Fuentes de las solicitudes |
| DOMAIN_NAME | AD_EXCHANGE_SITE_NAME | Sites |
| 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 apps |
| 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 | URLs |
| VIDEO_AD_DURATION | AD_EXCHANGE_VIDEO_AD_DURATION | (No disponible) |
| VIDEO_AD_DURATION_RAW | AD_EXCHANGE_VIDEO_AD_DURATION_RAW | Duración 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 |