Los terceros no son usuarios directos de Ad Manager, ya que es posible que no tengan su propia red de Ad Manager. En cambio, crean servicios o integraciones en Ad Manager para sus clientes, que son clientes de Ad Manager. En esta guía, se abordan los conceptos básicos de las integraciones de terceros y se proporcionan prácticas recomendadas, sugerencias y trucos.
En esta guía, se supone que tienes conocimientos prácticos de la API de Ad Manager. Si no conoces la API de Ad Manager, consulta nuestra documentación de introducción.
Primeros pasos como tercero
Si deseas usar la API de Ad Manager para acceder a la red de un cliente de Ad Manager, sigue los lineamientos que se indican a continuación. No se requiere ninguna aprobación adicional de Google. Sin embargo, ten en cuenta que, cuando accedes o usas la API de Ad Manager, aceptas los Términos y Condiciones de la API de Ad Manager.
Cómo probar tu integración de Ad Manager como un tercero
Como tercero, es posible que te preguntes cómo probar tu integración de Ad Manager antes de ejecutarla en las redes de producción de tus clientes. El enfoque recomendado es crear una red de prueba. No es necesario que seas cliente de Ad Manager para hacerlo. Cualquier persona que tenga una Cuenta de Google puede crear una red de prueba.
Sin embargo, ten en cuenta las diferencias entre las redes de prueba y de producción. Las redes de prueba no pueden publicar anuncios. Las redes de prueba tampoco necesariamente contendrán todas las funciones que los clientes pueden tener disponibles en sus redes de producción. Si necesitas realizar pruebas con las funciones de Ad Manager que no están disponibles en tu red de prueba, una opción es comprar acceso a una red que no sea de prueba a través de un revendedor de Ad Manager.
Además, debes ser claro con tus clientes sobre las funciones que deben tener disponibles en su red de producción para que tu aplicación funcione correctamente. Tu aplicación debe manejar casos en los que es posible que las funciones no existan. Para ello, detecta excepciones y falla de manera controlada, o bien mantiene una lista de tus clientes y las funciones que cada una tiene o no. Tu cliente debe ser responsable de trabajar con su contacto de Google para administrar las funciones en su red.
Autenticación: Cómo acceder correctamente a la red de Ad Manager de un cliente
Para que la aplicación acceda a la red de Ad Manager de tu cliente, debes configurar el flujo de trabajo de autenticación de manera segura.
Esto consta de dos pasos:
- Crea una dirección de correo electrónico de Cuenta de Google que usarás para acceder a la red de tu cliente.
- Pídele al cliente que agregue esta cuenta como un usuario a su red de Ad Manager.
En el paso 1, puedes crear una Cuenta de Google independiente para cada cliente o una principal que usarás con todos los clientes. La primera opción es más segura en el caso de que una de tus cuentas se vea comprometida. Esto último significa que solo debes realizar el paso 1 una vez.
Sin importar lo que hagas en el paso 1, en el paso 2 deberás pedirle a cada cliente nuevo que agregue la Cuenta de Google adecuada que creaste como usuario a su red de Ad Manager.
1. Creación de una cuenta de Google
Existen varias formas de crear una Cuenta de Google que se pueden agregar a una red de Ad Manager.
Opción 1: Crea una cuenta de servicio de OAuth2, que genera una dirección de correo electrónico de cuenta de servicio que actúa como una Cuenta de Google. Instrucciones para crear una cuenta de servicio nueva.
Opción 2: Puedes crear una Cuenta de Google normal (cuenta de "Gmail") si regístrate como usuario nuevo. Si ya tienes una Cuenta de Google, completa este registro en una ventana de incógnito o en una nueva sesión del navegador. O, si tu empresa usa Google Workspace, puedes crear una Cuenta de Google en el dominio de tu empresa y usarla. A los efectos de esta guía, nos referiremos a ambas como una Cuenta de Google "normal".
2. Pídele al cliente que agregue tu Cuenta de Google a su red
Después de obtener una Cuenta de Google para acceder a la red de tu cliente, pídele que agregue la cuenta como un usuario nuevo en su red de Ad Manager.
Si les proporcionas una dirección de correo electrónico de una cuenta de servicio de OAuth2, pídele que la agregue a su red.
Si les proporcionas una Cuenta de Google normal, pídeles que agreguen tu cuenta como usuario a su red.
Sin importar la ruta que tomes, asegúrate de consultar con el cliente las funciones y los permisos que debe tener la cuenta para que la aplicación pueda acceder a los datos que necesita en la red del cliente.
Ahora puedes comenzar a realizar llamadas a la API para la red de Ad Manager de tu cliente. Asegúrate de establecer el encabezado SOAP networkCode en el código de red del cliente con el que realizas la llamada a la API. Todas nuestras bibliotecas cliente permiten configurar esto de manera programática. Por ejemplo, en la biblioteca cliente de anuncios para Java, puedes configurar el código de red de manera programática cuando compilas una instancia de DfpSession.
Cómo mantenerse al día con la API
Es importante que te mantengas al tanto de las versiones de API obsoletas o descontinuadas y cuándo se lanzan las nuevas versiones. No querrás que te sorprendan cuando una versión se desactiva y arriesgas a dañar a tus clientes. No siempre podemos comunicarnos con terceros para informar sobre bajas y retiros inminentes como lo hacemos con nuestros clientes. Por lo tanto, es tu responsabilidad suscribirte a uno de nuestros tres canales principales para recibir actualizaciones de la API y ajustar la configuración de notificaciones:
- Nuestro grupo de anuncios de discontinuaciones de la API de Ad Manager.
- Nuestro blog para desarrolladores de anuncios
Además, proporcionamos un programa de baja en nuestro sitio para desarrolladores que deberías supervisar con regularidad.
Obtén asistencia
Si tienes problemas con la integración de Ad Manager, te ofrecemos los siguientes canales de asistencia según el problema. Si tienes una pregunta a nivel del producto, escribe en los foros de productos de Ad Manager. Si tienes una pregunta específica sobre la API, escribe en los foros de la API de Ad Manager. Consulta esta entrada de blog para obtener sugerencias sobre cómo distinguir si algo es una pregunta a nivel de producto o una específica de la API.