Pluggzy문서

광고 도구

모든 광고 플랫폼에서 쓰는 도구 3개, 작업 찾기·읽기·바꾸기예요. Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads, ChatGPT Ads에서 똑같이 작동하고, Pluggzy 자체 한도는 없어요. 각 플랫폼의 요청 제한만 적용돼요.

도구

AI 앱이 tools/list에서 받는 내용 그대로예요. ads_write는 광고 계정을 바꿔요. 돈이 들거나 접근 권한을 주는 작업은 먼저 사용자의 승인이 필요해요.

도구 3개 · 읽기 2개 · 쓰기 1개
광고3

Finds ads operations for Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads, ChatGPT Ads (campaigns, budgets, boosts, targeting, audiences, conversions, creatives, leads, insights…) by words or group; with operation, its parameters and body.

권한 View profiles
입력파라미터 3개 · 필수 0개
operationstring
querystring
words, e.g. "pause campaign"
groupstring
출력structuredContent
{
  "structuredContent": {
    "operations": [
      {
        "name": "update_ad_campaign_status",
        "summary": "Pause or resume a campaign",
        "kind": "write",
        "needs_user_confirmed": true
      },
      {
        "name": "bulk_update_ad_campaign_status",
        "summary": "Pause or resume many campaigns",
        "kind": "write",
        "needs_user_confirmed": true
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "2 operation(s)."
    }
  ]
}
게이트가 한 일예시09:41:02 → 09:41:02
  1. 수신09:41:02
  2. 응답 완료플랫폼 호출 없음
텍스트 응답 시작 “2 operation(s).” · 거절 코드not_foundinvalid_requestpermission

Runs a read-only ads operation (see ads_operations): campaigns with spend and results, daily metrics, insights, audiences, leads. Money is in the account's currency.

권한 View profiles한도 Pluggzy 자체 한도 없음 · 플랫폼 자체 요청 제한 적용
입력파라미터 4개 · 필수 1개
accountstring
ad account_id (list_accounts), when several
operationstring필수
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
출력structuredContent
{
  "structuredContent": {
    "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e",
    "provider": "metaads",
    "operation": "get_ads_timeline",
    "result": {
      "rows": [
        {
          "date": "2026-11-16",
          "currency": "EUR",
          "spend": 112.4,
          "impressions": 18420,
          "clicks": 391,
          "ctr": 2.12,
          "conversions": 14
        },
        {
          "date": "2026-11-17",
          "currency": "EUR",
          "spend": 118.9,
          "impressions": 19105,
          "clicks": 402,
          "ctr": 2.1,
          "conversions": 16
        }
      ]
    }
  },
  "content": [
    {
      "type": "text",
      "text": "Meta Ads: get_ads_timeline done."
    }
  ]
}
게이트가 한 일예시09:41:02 → 09:41:03
  1. 수신09:41:02
  2. Pluggzy 자체 한도 없음플랫폼 자체 요청 제한만 적용
  3. 전송09:41:03
텍스트 응답 시작 “Meta Ads: get_ads_timeline done.” · 거절 코드not_foundunsupportedinvalid_requestrate_limitedcooldownpermission

Runs an ads operation that changes the account (see ads_operations): create, boost, pause, budgets, targeting, deletions. needs_user_confirmed ones spend money or grant access: tell the user what will run (budget, dates, audience) and set user_confirmed only once they agree. New ads can go live at once: send a paused status to review first.

권한 Send messages & posts한도 Pluggzy 자체 한도 없음 · 플랫폼 자체 요청 제한 적용먼저 사용자 확인 필요
입력파라미터 5개 · 필수 1개
accountstring
ad account_id (list_accounts), when several
operationstring필수
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
user_confirmedboolean
the user approved this change
출력structuredContent
{
  "structuredContent": {
    "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e",
    "provider": "metaads",
    "operation": "update_ad_campaign_status",
    "result": {
      "success": true,
      "campaignId": "120214455667788990",
      "status": "PAUSED"
    }
  },
  "content": [
    {
      "type": "text",
      "text": "Meta Ads: update_ad_campaign_status done."
    }
  ]
}
게이트가 한 일예시09:41:02 → 09:41:03
  1. 수신09:41:02
  2. Pluggzy 자체 한도 없음플랫폼 자체 요청 제한만 적용
  3. 전송09:41:03
텍스트 응답 시작 “Meta Ads: update_ad_campaign_status done.” · 거절 코드confirmation_requirednot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

오류

모든 거절에는 AI 앱이 처리할 수 있는 code와, 무엇을 해야 하는지 알려 주는 메시지가 있어요.

광고 거절 코드

몰래 대기열에 넣거나 재시도하지 않아요. AI 앱이 코드와 메시지를 읽고, 호출을 고치거나 사용자에게 물어봐요.

confirmation_requiredads_write 전용. 돈이 들거나 접근 권한을 주는 작업인데 user_confirmed 값이 true가 아니었어요. 무엇이 실행될지 사용자에게 알리고 다시 호출하세요.
unsupported이 광고 계정의 플랫폼에서는 작동하지 않는 작업이에요(Microsoft Ads와 ChatGPT Ads에는 홍보 기능이 없어요). 메시지에 지원하는 플랫폼이 나와요.
invalid_request플랫폼이 호출을 거절했어요. 메시지는 플랫폼 이름으로 시작하고, fields에 고쳐야 할 값이 나와요.
not_found그런 이름의 작업이 없어요. 메시지에 비슷한 작업이 나와요.
rate_limited플랫폼이 직접 속도를 늦춰 달라고 했어요(플랫폼 자체 요청 제한이에요. Pluggzy는 광고 계정에 자체 한도가 없어요). retry_after_seconds는 플랫폼이 요청한 대기 시간 그대로예요. 그 뒤에 다시 호출하세요.
거절 예시
isError
{
  "error": "Meta Ads refused: the daily budget is below this ad account’s minimum.",
  "req_id": "req_7f3a9c21e4b8",
  "code": "invalid_request",
  "fields": {
    "budgetAmount": "below the ad account’s minimum daily budget"
  }
}
모든 채널 공통 코드cooldown과 permission은 Pluggzy의 다른 곳과 똑같이 작동해요.
오류
pluggzy.com/api/docs에서 생성 · 도구 42개헷갈리는 부분이 있나요? 고객 지원에 문의하기 · 서비스 상태