Pluggzy문서

광고

9개 플랫폼의 광고 계정을 어떤 AI 앱에서든 다뤄요. 광고 성과가 어땠는지, 어떤 캠페인이 돈만 쓰고 있는지 물어보거나 게시물 홍보를 맡겨 보세요. AI 앱이 작업을 찾고, 수치를 읽고, 변경까지 해요. 돈이 드는 작업은 모두 내가 승인해야 실행돼요.

9광고 플랫폼 · 플랫폼마다 따로 로그인
3모든 플랫폼에서 같은 도구
336캠페인부터 인사이트까지 지원하는 작업
내 승인돈이 들거나 접근 권한을 주는 모든 작업 전에

광고 계정

광고 계정도 다른 계정과 똑같이 연결해요. 광고용이라는 점만 달라요.

무엇인가요Pluggzy에 연결한 플랫폼의 광고 계정이에요. Meta Ads는 Facebook과 Instagram 광고를 모두 다뤄요. AI 앱이 캠페인과 수치를 읽고, 요청하면 바꿔요.
요금다른 계정과 똑같이 연결 계정 1개로 계산해요. Meta Ads 로그인 한 번으로 여러 광고 계정에 접근해도 1개로 계산해요.
광고비각 플랫폼이 내 광고 계정으로 직접 청구해요. Pluggzy가 광고비를 내지 않아요.
전용 키광고 계정마다 그 계정 전용 액세스 키가 따로 나와요.
광고 전용메시지나 DM은 없어요. 광고 계정은 광고만 운영해요. 채팅은 메시지 채널에서 해요.

연결

Pluggzy 대시보드에서 플랫폼 계정으로 로그인해 연결해요. ChatGPT Ads만 API 키를 써요.

플랫폼로그인 방법구조
Meta AdsFacebook·Instagram 광고로그인Facebook Login for Business구조캠페인 › 광고 세트 › 광고
Google Ads로그인Google 로그인구조캠페인 › 광고 그룹 › 광고
LinkedIn Ads로그인LinkedIn 로그인구조캠페인 그룹 › 캠페인 › 광고 소재
TikTok Ads로그인TikTok 로그인구조캠페인 › 광고 그룹 › 광고
Pinterest Ads로그인Pinterest 로그인구조캠페인 › 광고 그룹 › 프로모션 핀
X Ads로그인로그인 두 번: X 계정, 그다음 광고 계정구조캠페인 › 라인 아이템 › 프로모션 트윗
Reddit Ads로그인Reddit 로그인구조캠페인 › 광고 그룹 › 광고
Microsoft Ads검색 캠페인로그인Microsoft 로그인구조캠페인 › 광고 그룹 › 광고
ChatGPT Ads로그인ChatGPT Ads Manager(Settings)에서 만든 API 키, Pluggzy 연결 페이지에 붙여 넣기구조캠페인 › 광고 그룹 › 채팅 카드
  • ChatGPT Ads 키는 채팅이 아니라 Pluggzy 연결 페이지에 붙여 넣으세요.
  • X Ads는 승인을 두 번 받아요. 먼저 X 계정, 그다음 광고 접근 권한이에요.

도구 3개

모든 플랫폼에서 같은 도구 3개를 써요. AI 앱이 알맞은 도구를 고르니, 그냥 물어보세요.

ads_operations읽기먼저 할 수 있는 작업을 찾아요. 캠페인, 광고 세트, 광고, 예산, 홍보, 입찰, 타겟팅, 오디언스, 전환, 소재, 제품 카탈로그, 리드 양식, 규칙, 자동화, 인사이트까지 작업 336개 중에서 찾고, 작업마다 파라미터를 알려 줘요.query: "pause campaign"groupoperation
ads_read읽기확인용이에요. 지출, 성과, 일별 지표, 캠페인 구조, 인기 광고, 알림, 오디언스, 리드, 미리보기, 도달 예상치를 읽어요. 아무것도 바꾸지 않아요.get_ads_timelineget_ad_treelist_ads_alerts
ads_write쓰기변경용이에요. 캠페인·광고 세트·광고 만들기, 게시물 홍보, 일시중지와 재개, 예산, 입찰, 타겟팅, 오디언스, 삭제. 돈이 들거나 접근 권한을 주는 작업은 모두 내 승인을 기다려요.boost_postupdate_ad_campaign_statusupdate_ad_set

돈이 드는 일은 모두 내 승인부터.

도구에 기본으로 들어 있는 규칙이라, 어떤 플랫폼이든 어떤 AI 앱이든 똑같아요.

지출 또는 접근 권한내 승인
돈이 들거나 누군가에게 접근 권한을 주는 작업은 채팅에서 승인한 뒤에만 실행돼요. 그다음 AI 앱이 user_confirmed: true를 보내요.
일시중지언제든
일시중지에는 승인이 필요 없어요. 지출을 멈추는 건 모든 플랫폼에서 항상 허용돼요.
새 광고일시중지 상태
AI 앱은 새 광고를 일시중지 상태로 만들어요. 바로 게재해 달라고 할 때만 바로 시작해요.

승인이 없으면

아무것도 실행되지 않고, 몰래 재시도하지도 않아요. 도구가 AI 앱이 이해하는 코드로 응답해요.

confirmation_required돈이 들거나 접근 권한을 주는 작업이에요. AI 앱이 무엇이 실행될지 알려 주고, 동의하면 다시 호출해요.
unsupported이 플랫폼에는 없는 작업이에요. Microsoft Ads의 게시물 홍보가 그 예예요.
invalid_request플랫폼이 값을 거절했어요. fields에 어떤 값인지 나와요.
rate_limited플랫폼이 직접 속도를 늦춰 달라고 했어요. retry_after_seconds는 플랫폼이 요청한 대기 시간 그대로예요.
거절 예시
isError
{
  "error": "boost_post can spend money or grant access. Tell the user exactly what it will do, then call again with user_confirmed: true once they agree.",
  "code": "confirmation_required"
}

한도

Pluggzy는 광고 계정에 자체 한도를 두지 않아요. 일일 한도도, 분당 한도도, 간격도 없어요. AI 앱이 요청하면 바로 반영돼요. 각 플랫폼의 자체 요청 제한만 적용돼요.

동작Pluggzy 자체 한도도구
읽기지출, 성과, 인사이트, 리드없음플랫폼 자체 요청 제한 적용ads_read
지출 변경새 광고, 홍보, 예산, 입찰, 재개없음플랫폼 자체 요청 제한 적용ads_write
기타 변경일시중지, 오디언스, 소재, 키워드, 전환없음플랫폼 자체 요청 제한 적용ads_write
삭제캠페인, 광고 세트, 광고, 오디언스없음플랫폼 자체 요청 제한 적용ads_write
읽기없음
지출, 성과, 인사이트, 리드
플랫폼 자체 요청 제한 적용
ads_read
지출 변경없음
새 광고, 홍보, 예산, 입찰, 재개
플랫폼 자체 요청 제한 적용
ads_write
기타 변경없음
일시중지, 오디언스, 소재, 키워드, 전환
플랫폼 자체 요청 제한 적용
ads_write
삭제없음
캠페인, 광고 세트, 광고, 오디언스
플랫폼 자체 요청 제한 적용
ads_write
  • 플랫폼이 속도를 늦추라고 하면 Pluggzy는 요청한 시간만큼 초 단위까지 정확히 기다리고, retry_after_seconds와 함께 rate_limited 코드로 응답해요. AI 앱은 그 시간이 지난 뒤 다시 호출해요. 몰래 대기열에 넣는 일은 없어요.
  • 그래도 승인이 먼저예요. 돈이 들거나 접근 권한을 주는 작업은 채팅에서 승인을 기다려요.
  • 일시중지는 지출이 아니라 변경으로 쳐요. 승인 없이 바로 실행돼요.

금액과 수치

AI 앱이 읽는 숫자가 무엇이고 어디서 오는지 정리했어요.

광고 계정의 통화로.

지출, 예산, 결과당 비용, 구매 금액은 광고 계정의 통화로 표시돼요.

플랫폼에서 직접.

수치는 각 플랫폼이 제공하는 그대로예요. 지출, 노출, 도달, 클릭, 전환 등이요.

연결 시 Meta 90일치.

Meta Ads는 계정을 연결하면 최근 90일치를 먼저 가져와요. 그 이전 기록은 나중에 채워져요.

잘리면 알려 줘요.

응답이 너무 길면 truncated: true와 함께 잘려서 와요. 날짜, 개수 제한, 캠페인 하나로 범위를 좁혀 보세요.

AI에게 이렇게 물어보세요

작업 이름을 말할 필요는 없어요. 동료에게 묻듯 물어보면 AI 앱이 알아서 호출로 바꿔요.

“이번 주 Meta 광고 성과, 지난주랑 비교해 줘.”ads_read({ operation: "get_ads_timeline", params: { compare: true } })
이번 주 일별 지출과 성과를 지난주와 나란히, 계정 통화로 보여 줘요.
“Google Ads에서 전환당 비용 제일 높은 캠페인 찾아서 일시중지해 줘.”ads_write({ operation: "update_ad_campaign_status", body: { status: "paused" } })
캠페인을 먼저 읽고, 전환당 비용이 가장 높은 캠페인을 일시중지해요. 일시중지에는 승인이 필요 없어요.
“마지막 Instagram 게시물, 프랑스 25~40세 대상으로 하루 €10씩 5일 동안 홍보해 줘.”ads_write({ operation: "boost_post", …, user_confirmed: true })
AI 앱이 예산, 기간, 오디언스를 알려 주고 승인을 기다린 다음, 말한 대로 일시중지 상태나 바로 게재 상태로 만들어요.
“가장 잘되는 TikTok 광고 그룹 예산 20% 올려 줘.”ads_write({ operation: "update_ad_set", …, user_confirmed: true })
예산을 올리면 지출이 늘 수 있어서 먼저 물어봐요.
“이번 달 LinkedIn 리드 양식으로 들어온 리드 보여 줘.”ads_read({ operation: "list_leads", … })
양식으로 수집된 리드를 읽기 전용으로 보여 줘요.
“알림 떴거나 거절된 광고 있어?”ads_read({ operation: "list_ads_alerts" })
계정 전체에서 확인이 필요한 광고를 보여 줘요.
모든 입력과 출력ads_operations, ads_read, ads_write와 각 거절 코드는 레퍼런스에 있어요.
광고 도구
pluggzy.com/api/docs에서 생성 · 도구 42개헷갈리는 부분이 있나요? 고객 지원에 문의하기 · 서비스 상태