Pular para o conteúdo
Anúncios

Anúncios de uma campanha por eficiência

v1.0.0
GEThttps://api.growthaisystem.com/api/v1/ads/creatives
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposads.read

Os anúncios (criativos) de UMA campanha ordenados por eficiência: os 3 melhores e o pior, com tipo (imagem, vídeo, carrossel), gasto, resultados e custo por resultado. Sem campaign, a campanha de maior gasto.

Sempre 200: status diz o resultado de negócio (ok, not_connected, reconnect_needed, sync_pending, sync_failed, no_campaigns, not_found, ambiguous, not_configured, provider_error). Cada chamada lê o Meta na hora.

Parâmetros de consulta

Vão na querystring, depois do ?.

  • campaignstringopcional

    Id da campanha no Meta ou parte do nome (sem diferenciar acento). Omitido = a campanha de maior gasto.

    • tamanho 1–120
  • periodstringopcional

    Janela de análise: 7d, 14d, 30d ou 90d (padrão 7d).

    • padrão "7d"
    • um de"7d""14d""30d""90d"

Respostas

6 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

Os anúncios por eficiência (ou o status de negócio).

V1AdsCreatives

    • status"ok"
      • sempre "ok"
      • idstring
      • nomestring
        • tamanho máx. 41
    • escopostring
      • um de"citada""auto"
      • destring
      • atestring
    • moedastring
      • itens máx. 4

      Cada item da lista

      • nomestring
        • tamanho máx. 41
      • tipostring
        • um de"imagem""video""carrossel""desconhecido"
      • statusstring
        • um de"ativa""pausada""em_analise""rejeitada""concluida""com_problema"
      • gastonumber
      • conversoesnumber
      • custoPorConversaonumber | null
    • totalAnunciosnumber
    • status"sem_anuncios"
      • sempre "sem_anuncios"
      • idstring
      • nomestring
        • tamanho máx. 41
    • status"not_found"
      • sempre "not_found"
    • buscastring
      • tamanho máx. 120
    • status"ambiguous"
      • sempre "ambiguous"
    • buscastring
      • tamanho máx. 120
    • opcoesstring[]
      • itens máx. 5
    • status"no_campaigns"
      • sempre "no_campaigns"
      • destring
      • atestring
    • status"not_connected"
      • sempre "not_connected"
    • status"reconnect_needed"
      • sempre "reconnect_needed"
    • motivostring
      • um de"token_revoked""scope_insufficient""caiu"
    • status"sync_pending"
      • sempre "sync_pending"
    • status"sync_failed"
      • sempre "sync_failed"
    • motivostring
      • um de"no_ad_accounts""discovery_failed""sem_resposta""unknown"
    • status"not_configured"
      • sempre "not_configured"
    • status"provider_error"
      • sempre "provider_error"
    • detalhestring
      • tamanho máx. 200