Pular para o conteúdo principal
POST
Configure primeiro o acompanhamento de conversões. O Performance Max usa suas conversões para decidir onde exibir os anúncios e quanto dar de lance. A Ayrshare não bloqueia uma campanha sem ele, mas o Google pode limitar o gasto dela até que o acompanhamento de conversões seja configurado na sua conta do Google Ads. A Ayrshare não faz essa configuração por você. Quando a conta não tem nenhum, a resposta da criação inclui uma entrada em warnings informando isso.
Crie uma campanha Performance Max do Google Ads em uma única solicitação. Você envia textos e URLs de imagens; o Google os combina em anúncios na Pesquisa, no YouTube, na Rede de Display, no Discover, no Gmail e no Maps. A Ayrshare monta o orçamento, a campanha, um grupo de recursos e todos os seus recursos de uma vez. Se o Google recusar qualquer parte, nada é criado. A solicitação usa o formato compartilhado de Campanhas de anúncios. Ler e alterar uma campanha, os insights e os erros funcionam como em Campanhas de pesquisa do Google. Esta página aborda o que é diferente.
  • Os anúncios do Google são ativados por conta. Entre em contato conosco para habilitá-los.
  • Novas campanhas começam como paused, a menos que você envie status: "active".
  • O orçamento é diário, na moeda da conta de anúncios, e nunca é compartilhado com outras campanhas.
  • Gastos em outra moeda são convertidos em USD para cobrança pela taxa de câmbio do dia da Open Exchange Rates. Uma conta em uma moeda que não pode ser convertida retorna code: 101 antes que qualquer coisa seja criada.
  • Vídeos não são suportados. O Google pode criar vídeos a partir das suas imagens.

Parâmetros de cabeçalho

string
obrigatório
Um valor novo e único, como um UUID, para cada nova campanha. Repetir uma solicitação com a mesma chave retorna a primeira resposta. Quando uma criação falha antes de a Ayrshare enviar a campanha ao Google (por exemplo, uma imagem com o tamanho errado), a chave é liberada, então você pode corrigir a solicitação e tentar novamente com a mesma chave.

Parâmetros do corpo

string
obrigatório
performanceMax.
object
obrigatório
O Performance Max aceita apenas estas estratégias. Qualquer outra retorna code: 101.
  • maximizeConversions: obtém o máximo de conversões para o orçamento.
  • targetCpa com targetCpa: o mesmo, buscando esse custo por conversão.
  • maximizeConversionValue: obtém o máximo de valor de conversão para o orçamento.
  • targetRoas com targetRoas: o mesmo, buscando esse retorno sobre o investimento em anúncios, por exemplo 3.5 para 350%.
boolean
obrigatório
O Google exige essa declaração em todas as campanhas.
string[]
IDs de local do Google, por exemplo 2840 para os Estados Unidos. Omita para segmentar todos os locais.
object
obrigatório

Imagens

A Ayrshare baixa cada imagem a partir da URL e a verifica antes de enviar qualquer coisa ao Google:
  • GIF, JPG ou PNG, com até 5120 KB cada.
  • Pelo menos o tamanho mínimo indicado acima, com a proporção do seu campo (com tolerância de 1%).
  • Todas as imagens somadas com até 45 MB.
  • A URL deve ser pública. Endereços privados são recusados.
Uma imagem reprovada retorna code: 101 indicando qual é, por exemplo platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.