Los terceros no son usuarios directos de Ad Manager, ya que es posible que no tengan su propia red de Ad Manager. En su lugar, crean servicios o integraciones con 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 sobre la API de Ad Manager. Si no conoces la API de Ad Manager, consulta nuestra documentación para comenzar.
Cómo comenzar a trabajar como tercero
Para usar la API de Ad Manager y 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, aunque ten en cuenta que, cuando accedes a la API de Ad Manager o la usas, aceptas sus condiciones.
Cómo probar tu integración de Ad Manager como 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 con 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. Además, las redes de prueba no necesariamente contendrán todas las funciones que tus clientes puedan tener disponibles en sus redes de producción. Si necesitas realizar pruebas con 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 dejar en claro a tus clientes qué funciones deben tener disponibles en su red de producción para que tu aplicación funcione correctamente. Tu aplicación debe controlar los casos en los que es posible que no existan funciones. Para ello, debe detectar excepciones y fallar con facilidad, o bien mantener una lista de tus clientes y las funciones que cada uno tiene o no tiene. Debe ser responsabilidad de tu cliente 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 tu aplicación acceda a la red de Ad Manager de tu cliente, debes configurar tu flujo de trabajo de autenticación de forma 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 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 para todos los clientes. La primera opción es más segura en caso de que se hackee una de tus cuentas. 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 para él como usuario a su red de Ad Manager.
1. Cómo crear una Cuenta de Google
Existen varias formas de crear una Cuenta de Google que se puede agregar a una red de Ad Manager.
Opción 1: Crea una cuenta de servicio de OAuth2, que generará una dirección de correo electrónico de cuenta de servicio para ti que actuará 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") registrándote 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 bien, si tu empresa usa Google Workspace, puedes crear una Cuenta de Google en el dominio de tu empresa y usarla en su lugar. 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 cuenta de servicio de OAuth2, pídeles que la agreguen a su red.
Si le proporcionas una Cuenta de Google normal, pídele que agregue tu cuenta como usuario a su red.
Sin importar la ruta que elijas, asegúrate de analizar con tu cliente qué roles y permisos debe tener tu cuenta para que tu aplicación pueda acceder a los datos que necesita en la red de tu cliente.
Ahora puedes comenzar a realizar llamadas a la API de 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 este parámetro de forma programática. Por ejemplo, en la biblioteca cliente de Java de Google Ads, puedes establecer el código de red de forma programática cuando compilas una instancia de DfpSession.
Mantente al día con la API
Es importante que te mantengas al tanto de qué versiones de la API dejaron de estar disponibles o se descontinuaron, y cuándo se lanzan versiones nuevas. No quieres que te tome por sorpresa el retiro de una versión y correr el riesgo de que se interrumpan tus clientes. No siempre podemos comunicarnos con terceros sobre las bajas y las descontinuaciones 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 la baja de las APIs de Ad Manager
- Nuestro Blog para desarrolladores de Google Ads
También proporcionamos un programa de baja en nuestro sitio para desarrolladores que debes supervisar periódicamente.