Pular para o conteúdo
Anúncios

Diagnóstico por público de uma campanha

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

Qual público gasta bem ou mal: o custo por resultado por idade, gênero, região, dispositivo ou plataforma, com o segmento mais caro e o mais eficiente de cada dimensão. Sem campaign, analisa a campanha de maior gasto (escopo: auto).

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
  • dimensionstringopcional

    idade, genero, regiao, dispositivo ou plataforma. Omitido = idade, gênero e plataforma.

    • um de"idade""genero""regiao""dispositivo""plataforma"
  • 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

O diagnóstico por público (ou o status de negócio).

V1AdsSegments

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

      Cada item da lista

      • dimensaostring
        • um de"idade""genero""regiao""dispositivo""plataforma"
        • valorstring
          • tamanho máx. 24
        • gastonumber
        • conversoesnumber
        • custoPorConversaonumber | null
        • participacaoGastoPctnumber
        • valorstring
          • tamanho máx. 24
        • gastonumber
        • conversoesnumber
        • custoPorConversaonumber | null
        • participacaoGastoPctnumber
    • status"sem_dados_segmento"
      • sempre "sem_dados_segmento"
      • 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