Saltar al contenido principal
POST
Configura primero el seguimiento de conversiones. Performance Max usa tus conversiones para decidir dónde mostrar los anuncios y cuánto pujar. Ayrshare no bloquea una campaña sin él, pero Google puede limitar su gasto hasta que el seguimiento de conversiones esté configurado en tu cuenta de Google Ads. Ayrshare no lo configura por ti. Cuando la cuenta no lo tiene, la respuesta de creación incluye una entrada en warnings que lo indica.
Crea una campaña Performance Max de Google Ads en una sola solicitud. Envías textos y URLs de imágenes; Google los combina en anuncios en Search, YouTube, Display, Discover, Gmail y Maps. Ayrshare crea juntos el presupuesto, la campaña, un grupo de recursos y todos sus recursos. Si Google rechaza cualquier parte, no se crea nada. La solicitud usa la estructura compartida de Campañas publicitarias. Consultar y modificar una campaña, las estadísticas y los errores funcionan como en Campañas de búsqueda de Google. Esta página cubre lo que es diferente.
  • Los anuncios de Google se activan por cuenta. Contáctanos para habilitarlos.
  • 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, y nunca se comparte con otras campañas.
  • 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.
  • No se admite video. Google puede crear videos a partir de tus imágenes.

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. Cuando una creación falla antes de que Ayrshare envíe la campaña a Google (por ejemplo, una imagen con un tamaño incorrecto), la clave se libera, así que puedes corregir la solicitud y reintentar con la misma clave.

Parámetros del cuerpo

string
requerido
performanceMax.
object
requerido
Performance Max solo acepta estas estrategias. Cualquier otra responde code: 101.
  • maximizeConversions: obtener el mayor número de conversiones con el presupuesto.
  • targetCpa con targetCpa: lo mismo, apuntando a ese coste por conversión.
  • maximizeConversionValue: obtener el mayor valor de conversión con el presupuesto.
  • targetRoas con targetRoas: lo mismo, apuntando a ese retorno de la inversión publicitaria, por ejemplo 3.5 para un 350%.
boolean
requerido
Google exige esta declaración en cada campaña.
string[]
IDs de ubicación de Google, por ejemplo 2840 para Estados Unidos. Omítelo para segmentar todas las ubicaciones.
object
requerido

Imágenes

Ayrshare descarga cada imagen desde su URL y la comprueba antes de enviar nada a Google:
  • GIF, JPG o PNG, de hasta 5120 KB cada una.
  • Al menos el tamaño mínimo indicado arriba, con la relación de aspecto de su campo (con un margen del 1%).
  • Todas las imágenes juntas, hasta 45 MB.
  • La URL debe ser pública. Las direcciones privadas se rechazan.
Una imagen que no pasa la comprobación responde code: 101 indicándola, por ejemplo platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.