{
  "id": "43f3045e-ee9f-4357-b7ce-d7468de497ed",
  "slug": "ref/web/air-gmp-ai/광고주-수-advertiser-count-air-mcp",
  "doc_type": "ref",
  "title": "광고주 수 / Advertiser Count — AIR MCP",
  "title_en": null,
  "one_liner": "광고주 수 / Advertiser Count 매체별로 최근 30일간 실제 집행한 활성 광고주 수를 반환한다. 개별 광고주는 식별되지 않고 distinct 카운트만 집계된다. get_advertiser_count_by_media 30일 cardinality 애드온 · 시장 집계 데",
  "summary_bullets": [
    "AIR MCP의 get_advertiser_count_by_media 도구는 매체별 최근 30일간 실제 집행한 활성 광고주 수를 distinct 카운트로 반환한다.",
    "개별 광고주 계정 데이터가 아닌 AIR 매체 통합 시장 집계 데이터를 기반으로 하며, 개인 식별 정보는 포함되지 않는다.",
    "verbosity 파라미터(compact/full)로 응답 상세도를 조절할 수 있으며, full 선택 시 program_count 필드가 추가된다.",
    "응답에는 매체 코드·이름·광고주 수·순위와 함께 집계 기간, 인용 정보, 방법론(client 단위 집계, CR-09 격리) 정보가 포함된다.",
    "데이터는 CC-BY 4.0 라이선스로 출처 표기 시 자유롭게 인용·재사용할 수 있다."
  ],
  "body_md": "## 광고주 수 / Advertiser Count\n\n매체별로 최근 30일간 실제 집행한 활성 광고주 수를 반환한다. 개별 광고주는 식별되지 않고 distinct 카운트만 집계된다.\nget_advertiser_count_by_media\n30일 cardinality\n애드온 · 시장 집계 데이터\n광고주 개별 계정에서 나오는 AIR 매체 데이터가 아니라\nAIR 매체 통합 데이터\ndaas.gmp.ai\n\n### 1. 파라미터\n\n파라미터\n값\n설명\nverbosity\ncompact\nfull\nfull\n\n### 2. 호출\n\nhttps://mcp.gmp.ai/air\ncurl -X POST https://mcp.gmp.ai/air \\\n  -H \"Authorization: Bearer YOUR_CLIENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"tool\": \"get_advertiser_count_by_media\",\n    \"verbosity\": \"full\"\n  }'\n\n### 3. 응답 schema\n\n{\n  \"data\": {\n    \"period\": { \"start\": \"YYYY-MM-DD\", \"end\": \"YYYY-MM-DD\", \"days\": 30 },\n    \"media\": [\n      {\n        \"code\": \"naver_sa\",\n        \"name\": \"NAVER SA\",\n        \"distinct_clients\": <integer>,\n        \"rank\": <integer>,\n        \"program_count\": <integer>   // verbosity: \"full\" 에서만\n      }\n    ]\n  },\n  \"_citation\": {\n    \"suggested_citation_ko\": \"비즈스프링 AIR (2026). 매체별 활성 광고주 수. https://air.gmp.ai\",\n    \"license\": \"CC-BY 4.0\",\n    \"data_authority\": \"Bizspring\"\n  },\n  \"_methodology\": {\n    \"aggregation\": \"client 단위 집계 (CR-09 격리)\",\n    \"cardinality_method\": \"30일 구간 distinct client 카운트\",\n    \"anonymization\": \"개별 광고주 식별 정보 미포함\"\n  },\n  \"_metadata\": {\n    \"tool\": \"get_advertiser_count_by_media\",\n    \"version\": \"v0.7\"\n  }\n}\n\n### 4. 응답 필드\n\n필드\n타입\n설명\ncode\nstring\n매체 코드\nname\nstring\n매체 표시명\ndistinct_clients\ninteger\n30일 내 집행한 광고주 수 (중복 제거)\nrank\ninteger\n광고주 수 기준 순위\nprogram_count\ninteger\nfull\n\n### 5. 인용\n\nCC-BY 4.0 — 출처 표기 시 자유롭게 인용·재사용할 수 있다.\n비즈스프링 AIR (2026). 매체별 활성 광고주 수. https://air.gmp.ai\nBizspring AIR (2026). Active Advertiser Count by Media. https://air.gmp.ai\n\n### 6. 다음 단계\n\n전체 API 문서\ndaas.gmp.ai 에서 더 보기 →\n매체 점유율\n시즌 추이\nAPI key 발급 문의\n\n출처: https://air.gmp.ai/advertisers",
  "related_slugs": [],
  "faq": [
    {
      "a": "아니요, 개별 광고주는 식별되지 않고 매체별 distinct 카운트만 집계되어 제공됩니다. 응답에도 개별 광고주 식별 정보는 포함되지 않습니다.",
      "q": "이 도구로 개별 광고주를 식별할 수 있나요?"
    },
    {
      "a": "최근 30일간 실제 집행한 활성 광고주 수를 기준으로 집계합니다. 응답의 period 필드에서 구체적인 시작일과 종료일을 확인할 수 있습니다.",
      "q": "집계 기간은 어떻게 되나요?"
    },
    {
      "a": "compact와 full 두 가지 값이 있으며, full로 설정하면 program_count 필드가 추가로 응답에 포함됩니다.",
      "q": "verbosity 파라미터는 무엇이 다른가요?"
    },
    {
      "a": "광고주 개별 계정에서 나오는 AIR 매체 데이터가 아니라, AIR 매체 통합 데이터를 기반으로 한 시장 집계 데이터입니다.",
      "q": "이 데이터는 어디서 나온 데이터인가요?"
    },
    {
      "a": "네, CC-BY 4.0 라이선스로 제공되어 출처를 표기하면 자유롭게 인용·재사용할 수 있습니다. 제안된 인용 표기 문구는 응답의 _citation 필드에 포함되어 있습니다.",
      "q": "이 데이터를 외부에 인용해도 되나요?"
    }
  ],
  "jsonld": null,
  "keywords": [],
  "source_id": "https://air.gmp.ai/advertisers",
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "image_url": null,
  "caption": null,
  "solution_slug": null,
  "captured_at": null,
  "width": null,
  "height": null,
  "created_at": "2026-09-06T11:30:51.102164+00:00",
  "updated_at": "2026-09-06T11:30:51.102164+00:00",
  "visibility": "public",
  "source_stage": "1",
  "anonymized": true,
  "source_key": "web-air",
  "origin": "ingest",
  "locked": false,
  "locked_by": null,
  "locked_at": null,
  "gate_state": {
    "g1": {
      "hits": [],
      "pass": true
    },
    "g2": {
      "pass": true,
      "total": 39,
      "issues": [
        "숫자·규격 같은 검증 가능한 구체가 부족합니다",
        "다른 문서와 겹치는 말이 대부분입니다"
      ],
      "applies": true
    },
    "g3": {
      "pass": true,
      "required": false
    },
    "stage": "1",
    "decided_at": "2026-09-06T11:49:12.429Z"
  },
  "raw_id": "994d802e-6184-4972-9be5-cd07338fcaf1",
  "search_text": "광고주 수 / Advertiser Count — AIR MCP  광고주 수 / Advertiser Count 매체별로 최근 30일간 실제 집행한 활성 광고주 수를 반환한다. 개별 광고주는 식별되지 않고 distinct 카운트만 집계된다. get_advertiser_count_by_media 30일 cardinality 애드온 · 시장 집계 데  ## 광고주 수 / Advertiser Count\n\n매체별로 최근 30일간 실제 집행한 활성 광고주 수를 반환한다. 개별 광고주는 식별되지 않고 distinct 카운트만 집계된다.\nget_advertiser_count_by_media\n30일 cardinality\n애드온 · 시장 집계 데이터\n광고주 개별 계정에서 나오는 AIR 매체 데이터가 아니라\nAIR 매체 통합 데이터\ndaas.gmp.ai\n\n### 1. 파라미터\n\n파라미터\n값\n설명\nverbosity\ncompact\nfull\nfull\n\n### 2. 호출\n\nhttps://mcp.gmp.ai/air\ncurl -X POST https://mcp.gmp.ai/air \\\n  -H \"Authorization: Bearer YOUR_CLIENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"tool\": \"get_advertiser_count_by_media\",\n    \"verbosity\": \"full\"\n  }'\n\n### 3. 응답 schema\n\n{\n  \"data\": {\n    \"period\": { \"start\": \"YYYY-MM-DD\", \"end\": \"YYYY-MM-DD\", \"days\": 30 },\n    \"media\": [\n      {\n        \"code\": \"naver_sa\",\n        \"name\": \"NAVER SA\",\n        \"distinct_clients\": <integer>,\n        \"rank\": <integer>,\n        \"program_count\": <integer>   // verbosity: \"full\" 에서만\n      }\n    ]\n  },\n  \"_citation\": {\n    \"suggested_citation_ko\": \"비즈스프링 AIR (2026). 매체별 활성 광고주 수. https://air.gmp.ai\",\n    \"license\": \"CC-BY 4.0\",\n    \"data_authority\": \"Bizspring\"\n  },\n  \"_methodology\": {\n    \"aggregation\": \"client 단위 집계 (CR-09 격리)\",\n    \"cardinality_method\": \"30일 구간 distinct client 카운트\",\n    \"anonymization\": \"개별 광고주 식별 정보 미포함\"\n  },\n  \"_metadata\": {\n    \"tool\": \"get_advertiser_count_by_media\",\n    \"version\": \"v0.7\"\n  }\n}\n\n### 4. 응답 필드\n\n필드\n타입\n설명\ncode\nstring\n매체 코드\nname\nstring\n매체 표시명\ndistinct_clients\ninteger\n30일 내 집행한 광고주 수 (중복 제거)\nrank\ninteger\n광고주 수 기준 순위\nprogram_count\ninteger\nfull\n\n### 5. 인용\n\nCC-BY 4.0 — 출처 표기 시 자유롭게 인용·재사용할 수 있다.\n비즈스프링 AIR (2026). 매체별 활성 광고주 수. https://air.gmp.ai\nBizspring AIR (2026). Active Advertiser Count by Media. https://air.gmp.ai\n\n### 6. 다음 단계\n\n전체 API 문서\ndaas.gmp.ai 에서 더 보기 →\n매체 점유율\n시즌 추이\nAPI key 발급 문의\n\n출처: https://air.gmp.ai/advertisers",
  "embedding": null,
  "embedded_at": null,
  "embedding_hash": null,
  "map_x": null,
  "map_y": null,
  "backlinks": [
    "screenshot/air-gmp-ai"
  ],
  "html_url": "https://bizspring.ai/kb/ref/web/air-gmp-ai/광고주-수-advertiser-count-air-mcp",
  "markdown_url": "https://bizspring.ai/kb/ref/web/air-gmp-ai/광고주-수-advertiser-count-air-mcp.md"
}