Pular para o conteúdo principal
POST
Crie uma campanha de pesquisa do Google Ads em uma única solicitação. A Ayrshare monta o orçamento, a campanha, um grupo de anúncios, suas palavras-chave, um anúncio responsivo de pesquisa e a segmentação por local, tudo de uma vez. Se o Google recusar qualquer parte, nada é criado. A solicitação usa o formato compartilhado de Campanhas de anúncios. Esta página aborda o que é específico do Google.
  • Os anúncios do Google são ativados por conta. Entre em contato conosco para habilitá-los.
  • Primeiro, vincule o Google Ads na página “Social Accounts” (Contas sociais). accountId é o ID de cliente do Google Ads com 10 dígitos, com ou sem hífens (123-456-7890).
  • O usuário do Google que você vincular deve ter acesso direto à conta de anúncios. Contas que você acessa apenas por meio de uma conta de administrador não são listadas e ainda não podem ser usadas: adicione esse usuário à própria conta de anúncios. Contas de administrador também não são listadas: elas não podem conter campanhas.
  • 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. Não envie budget.currency: isso retorna code: 101.
  • 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.
  • Os anúncios são exibidos apenas na Pesquisa Google, não nos parceiros de pesquisa nem na Rede de Display.
Acompanhamento de conversões. maximizeConversions só funciona quando o acompanhamento de conversões está configurado na sua conta do Google Ads. A Ayrshare não faz essa configuração por você. Sem ele, use maximizeClicks ou manualCpc.

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 e não cria nada novo. Quando uma criação falha antes de a Ayrshare enviar a campanha ao Google, a chave é liberada, então você pode corrigir a solicitação e tentar novamente com a mesma chave. Isso inclui um valor que a Ayrshare recusa (como uma estratégia de lances não suportada), uma conta em uma moeda que não pode ser convertida em USD e qualquer falha na verificação de conta que a Ayrshare faz primeiro, inclusive quando o Google a recusa. Uma criação que falha depois que a campanha foi enviada ao Google mantém sua resposta: tente novamente com uma nova chave.

Parâmetros do corpo

Os campos compartilhados funcionam conforme descrito em Campanhas de anúncios. No Google:
string
obrigatório
search.
string
obrigatório
maximizeClicks, manualCpc ou maximizeConversions. Qualquer outro valor retorna code: 101.
boolean
obrigatório
O Google exige essa declaração em todas as campanhas. Enquanto houver alguma campanha não declarada em uma conta, o Google rejeita qualquer alteração nas campanhas dessa conta.
object
O Google programa dias inteiros no fuso horário da conta de anúncios. start começa às 00:00:00 do seu dia e end termina às 23:59:59 do seu dia; um horário enviado serve apenas para escolher o dia. start pode ser hoje, mas não um dia anterior. Para uma campanha de um dia, envie a mesma data em start e end. Um end em um dia anterior a start retorna code: 101.
object
O Google associa os anúncios de pesquisa às pessoas pelo idioma do texto do seu anúncio, por isso não há configuração de idioma. Enviar targeting.languages retorna code: 101.
object
obrigatório

Erros