Introducción

Este documento va dirigido a los programadores que quieran usar la API de administración de AdSense para obtener información sobre su cuenta de AdSense. En este documento se supone que estás familiarizado con los conceptos de programación web y los formatos de datos web.

Contenido

Antes de empezar

Cómo obtener una cuenta de AdSense

Necesitas una cuenta de AdSense para realizar pruebas. Si ya tienes una cuenta de prueba, es todo lo que necesitas; puedes acceder a la interfaz de usuario de AdSense para configurar, modificar o ver tus datos de prueba.

Iniciación en AdSense

Si no estás familiarizado con los conceptos de AdSense, consulta la información de introducción sobre AdSense y experimenta con la interfaz de usuario antes de empezar a codificar.

Cómo elegir la biblioteca de cliente

En la página Bibliotecas de cliente y ejemplos encontrarás información sobre las bibliotecas y los ejemplos disponibles. Haz clic en la pestaña del lenguaje que has elegido y sigue los enlaces para descargar el código fuente. Las bibliotecas de cliente se ocupan de lo siguiente de forma automática:

  • autenticación,
  • descubrimiento de servicios,
  • creación de las solicitudes para la API,
  • análisis de respuestas.

Consulta las instrucciones para instalar y configurar la biblioteca de cliente elegida, que normalmente se encuentran en el archivo README del directorio raíz del repositorio.

Si tu implementación tiene necesidades especiales, como un lenguaje incompatible, puedes hacer solicitudes directas a la API en vez de usar una biblioteca de cliente.

Cómo registrar la aplicación

Para usar la API de administración de AdSense, debes registrar la aplicación que estás desarrollando con Google:

  1. Ve a la consola de las API.
  2. Inicia sesión en tu cuenta de Google o crea una cuenta.
  3. Crea un nuevo proyecto.
  4. En el proyecto recién creado, haz clic en el botón "Activate" (Activar) debajo de la API de administración de AdSense.
  5. Ve a la sección "API Access" (Acceso a la API).
  6. Crea un ID de cliente:
    1. Aplicación web, si tu implementación se encuentra en un servidor web.
    2. Aplicación instalada, para los demás casos.

    Nota: No se admiten las cuentas de servicio ya que acceden a datos protegidos.

  7. Modifica los archivos de configuración de tu proyecto de biblioteca de cliente con las nuevas credenciales que acabas de crear. Consulta la documentación de la biblioteca de cliente para obtener más información.

Nota: La cuenta de Google empleada para el registro debe ser tu cuenta de programador, es decir, la cuenta que quieres que los usuarios de tu aplicación vean como el programador de la aplicación. No es necesario que esta cuenta esté vinculada a datos de acceso de AdSense, ya que a los usuarios se les concederá acceso a sus propias cuentas mientras usan la aplicación.

Tutorial de inicio rápido

Sigue estos pasos para hacer las primeras solicitudes. Ten en cuenta que estos pasos pueden variar ligeramente según la biblioteca o el lenguaje que uses.

  1. Utiliza la muestra adecuada para recuperar una lista de clientes publicitarios de una cuenta de AdSense. Esta solicitud inicia un proceso único en el que el usuario de AdSense autentica y autoriza tu proceso.

    Los clientes publicitarios representan una asociación entre una cuenta de AdSense y un producto de AdSense, como los anuncios de la Red de Display o los de la Red de Búsqueda. Una cuenta de AdSense puede tener uno o varios clientes publicitarios.

    1. En el caso de las aplicaciones web, a los usuarios se les redireccionará a un sitio donde puedan optar por conceder acceso. Tras la autorización, se les redireccionará a la URL de devolución de llamada definida en la consola de las API.
    2. Las aplicaciones instaladas tienen un funcionamiento similar. La biblioteca de cliente intentará abrir una ventana de navegador y usar un código de autorización. En las aplicaciones para Android, Chrome e iOS este método es específico de la plataforma.
  2. Utiliza el explorador de las API en reports.generate para solicitar el siguiente informe:
    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS

    Los informes ofrecen información sobre los ingresos que obtienes, así como lo que afecta a dichos ingresos. Se pueden ejecutar en una cuenta completa o en un subconjunto de bloques de anuncios, a través del uso de canales.

  3. Prueba a solicitar el mismo informe desde la aplicación.
  4. Puedes filtrar los informes por bloques de anuncios. Recupera la lista de bloques de anuncios con adunits.list. Ten en cuenta que se necesita un ID de cliente publicitario (obtenido en el paso 1). Después de elegir un bloque de anuncios, utiliza su ID en el parámetro filter para reports.generate:

    Los bloques de anuncios son marcadores de posición configurados por el usuario para anuncios que definen algunas propiedades de los anuncios que se muestran (como el tamaño y la forma).

    • startDate: today-1m
    • endDate: today
    • dimensions: DATE
    • metrics: EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Prueba a filtrar por canales personalizados o de URL, o bien a combinar varios filtros.

    Los canales son herramientas que permiten realizar el seguimiento del rendimiento de un subconjunto de los bloques de anuncios. Existen dos tipos de canales: URL y personalizados. El primero permite realizar el seguimiento del rendimiento en una determinada página o dominio, mientras que el segundo sirve de ayuda para realizarlo de determinados grupos de bloques de anuncios seleccionados por el usuario.

  6. También te puedes unir al grupo de anuncios de la API de AdSense.

Ya puedes empezar tu implementación explorando el resto de las llamadas y los recursos disponibles en la documentación de referencia.

Enviar comentarios sobre…

AdSense Management API
AdSense Management API