Relatório diário de grupos de anúncios
Uma linha por grupo de anúncios por dia: investimento, impressões, cliques, conversões, resultados e visualizações de vídeo.
dateFrom e dateTo filtram por stat_time_day (dias inclusivos, YYYY-MM-DD).
As linhas são ordenadas por stat_time_day, adgroup_id, integration_id, inserted_at e paginadas com page/limit; meta.hasNextPage diz se existe outra página.
As respostas ficam em cache por 30 minutos.
ClientIdAuthClientSecretAuthx-client-id<token>Client ID
x-client-secret<token>Client secret
organizationId*stringOrganização dona das contas conectadas.
uuidintegrationId?stringUma conta conectada desta integração (o integration_id das linhas). Omita para ler todas as contas da organização.
length <= 255dateFrom?stringPrimeiro dia (inclusivo) de stat_time_day, YYYY-MM-DD.
datedateTo?stringÚltimo dia (inclusivo) de stat_time_day, YYYY-MM-DD. Não pode ser anterior a dateFrom.
datepage?integerNúmero da página, a partir de 1.
1 <= value <= 10000001limit?integerLinhas por página (máximo 5000).
1 <= value <= 5000500Uma página de linhas
application/json- response
data*array<>meta*curl -X GET "https://example.com/v1/tiktok-ads/ad-groups-daily-report?organizationId=3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b&dateFrom=2026-10-01&dateTo=2026-10-31"{ "data": [ { "organization_id": "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b", "integration_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "user_id": "123456", "document_id": "123456", "integration_name": "example", "adgroup_id": "123456", "stat_time_day": "2026-10-01", "spend": "125.50", "billed_cost": "125.50", "impressions": "1250", "gross_impressions": "1250", "clicks": "1250", "conversion": "1250", "real_time_conversion": "1250", "result": "1250", "real_time_result": "1250", "secondary_goal_result": "1250", "video_play_actions": "1250", "video_watched_2s": "1250", "video_watched_6s": "1250", "engaged_view": "1250", "engaged_view_15s": "1250", "video_views_p25": "1250", "video_views_p50": "1250", "video_views_p75": "1250", "video_views_p100": "1250", "inserted_at": "2026-10-01T12:00:00.000Z" } ], "meta": { "page": 1, "limit": 500, "hasNextPage": false, "hasPreviousPage": false }}