Saltar al contenido principal
POST
Crea una campaña de búsqueda de Google Ads en una sola solicitud. Ayrshare crea juntos el presupuesto, la campaña, un grupo de anuncios, tus palabras clave, un anuncio de búsqueda responsivo y la segmentación por ubicación. Si Google rechaza cualquier parte, no se crea nada. La solicitud usa la estructura compartida de Campañas publicitarias. Esta página cubre lo que es específico de Google.
  • Los anuncios de Google se activan por cuenta. Contáctanos para habilitarlos.
  • Primero vincula Google Ads desde la página “Social Accounts” (cuentas sociales). accountId es el ID de cliente de Google Ads de 10 dígitos, con o sin guiones (123-456-7890).
  • El usuario de Google que vincules debe tener acceso directo a la cuenta publicitaria. Las cuentas a las que solo accedes a través de una cuenta de administrador no aparecen en la lista y todavía no se pueden usar: agrega ese usuario a la propia cuenta publicitaria. Las cuentas de administrador tampoco aparecen: no pueden contener campañas.
  • Las campañas nuevas comienzan en paused a menos que envíes status: "active".
  • El presupuesto es diario, en la moneda de la cuenta publicitaria. No envíes budget.currency: responde code: 101.
  • El gasto en otra moneda se convierte a USD para la facturación al tipo de cambio de ese día de Open Exchange Rates. Una cuenta en una moneda que no se puede convertir responde code: 101 antes de crear nada.
  • Los anuncios se muestran solo en la Búsqueda de Google, no en los socios de búsqueda ni en la Red de Display.
Seguimiento de conversiones. maximizeConversions solo funciona cuando el seguimiento de conversiones está configurado en tu cuenta de Google Ads. Ayrshare no lo configura por ti. Sin él, usa maximizeClicks o manualCpc.

Parámetros del encabezado

string
requerido
Un valor único nuevo, como un UUID, para cada campaña nueva. Repetir una solicitud con la misma clave devuelve la primera respuesta y no crea nada nuevo. Cuando una creación falla antes de que Ayrshare envíe la campaña a Google, la clave se libera, así que puedes corregir la solicitud y reintentar con la misma clave. Esto cubre un valor que Ayrshare rechaza (como una estrategia de puja no admitida), una cuenta en una moneda que no se puede convertir a USD y cualquier fallo de la comprobación de la cuenta que Ayrshare hace primero, incluido que Google la rechace. Una creación que falla una vez enviada la campaña a Google conserva su respuesta: reinténtala con una clave nueva.

Parámetros del cuerpo

Los campos compartidos funcionan como se describe en Campañas publicitarias. En Google:
string
requerido
search.
string
requerido
maximizeClicks, manualCpc o maximizeConversions. Cualquier otra responde code: 101.
boolean
requerido
Google exige esta declaración en cada campaña. Mientras alguna campaña de una cuenta no esté declarada, Google rechaza cualquier cambio en las campañas de esa cuenta.
object
Google programa días completos en la zona horaria de la cuenta publicitaria. start comienza a las 00:00:00 de su día y end se detiene a las 23:59:59 de su día; la hora que envíes solo determina el día. start puede ser hoy, pero no un día anterior. Para una campaña de un día, envía la misma fecha en start y end. Un end en un día anterior a start responde code: 101.
object
Google asocia los anuncios de búsqueda con las personas según el idioma del texto de tu anuncio, por lo que no hay una configuración de idioma. Enviar targeting.languages responde code: 101.
object
requerido

Errores