분석 · 광고
Google Ads
워크스페이스에 구글 애즈 계정 하나를 연결해 에이전트가 보고서를 읽고 일시정지 캠페인을 만들게 합니다. 도구와 각 도구가 쓰는 작업 수, 하루 예산 상한, 오류 코드의 뜻을 적었습니다.
구글 애즈를 연결하면 무엇이 되나요?
에이전트가 계정의 보고서와 캠페인 구조를 읽고, 검색 캠페인을 만들고, 캠페인 · 광고 그룹 · 광고를 켜고 끄고, 캠페인 하루 예산을 바꿀 수 있습니다. 광고비는 구글이 사용자의 구글 애즈 계정에 청구합니다.
광고비가 실수로 나가지 않게 무엇이 막나요?
새 캠페인은 언제나 일시정지입니다. 켜진 채로 만드는 도구도, 지우는 도구도 없습니다.
켜기와 예산 올리기에는 하루 예산 상한이 필요하고, 상한은 연결 화면에서 정합니다. 상한이 없으면 둘 다 거절합니다. 상한은 대시보드에 로그인한 사람만 정할 수 있고, 쓰기 API 키와 동의한 에이전트는 그 안에서 광고를 켤 수 있습니다.
상한은 켜진 캠페인의 하루 예산 합에 걸립니다. 구글이 그날 실제로 쓰는 금액의 상한이 아닙니다. 한 번에 올릴 수 있는 예산은 지금의 두 배까지입니다. 끄기는 이 검사를 모두 지나칩니다.
구글 애즈 계정은 어떻게 연결하나요?
패스키를 먼저 만듭니다
연결할 때 구글이 패스키를 요구하고, 새로 만든 패스키는 쓸 수 있을 때까지 최대 7일이 걸립니다. g.co/passkeys 에서 만드세요.
워크스페이스에서 연결 화면을 엽니다
워크스페이스를 먼저 고릅니다. 계정은 그 워크스페이스에 붙습니다.
「Google Ads 연결」 을 누릅니다
채널 아래 「분석 · 광고」 묶음에 있습니다. 구글 화면에서 접근을 허용합니다.
계정을 고릅니다
광고를 집행하는 계정이 하나면 바로 연결됩니다. 관리자 계정은 목록에 없고 그 아래 계정은 있습니다.
하루 예산 상한을 정합니다
카드에 그 계정의 통화로 넣습니다. 정하기 전까지 에이전트는 읽기와 일시정지 캠페인 만들기만 하고 아무것도 켜지 못합니다.
에이전트가 어떤 도구를 쓰나요?
구글은 uplika가 하루에 쓸 수 있는 작업 수를 정해 두었고, uplika를 쓰는 모두가 나눠 씁니다. 마지막 칸이 한 번 부를 때 쓰는 작업 수입니다. 이 기능 전에 연결한 에이전트는 쓰기 도구를 쓰려면 uplika를 다시 승인해야 합니다.
| 도구 | 하는 일 | 권한 | 작업 수 |
|---|---|---|---|
| get_ad_account | 연결된 계정, 통화, 정해 둔 상한, 오늘 남은 작업 수 | posts:read | 0 |
| get_ad_insights | 계정 · 캠페인 · 광고 그룹 · 광고 · 키워드별 노출 · 클릭 · 비용 · 전환 등을 기간으로 | posts:read | 1 |
| list_ads | 캠페인 · 광고 그룹 · 광고의 상태와 하루 예산. uplika가 만든 것만 볼 수도 있습니다 | posts:read | 2 |
| create_ad_campaign | 검색 캠페인 하나를 언제나 일시정지로. validateOnly 는 만들지 않고 검사만 합니다 | ads:write | 4 + 키워드 수 + 지역 수 |
| set_ad_status | 캠페인 · 광고 그룹 · 광고 켜고 끄기 | ads:write | 끄기 1, 켜기 2 |
| update_ad_budget | 캠페인 하루 예산 바꾸기 | ads:write | 2 |
오류는 무슨 뜻인가요?
| 코드 | HTTP | 뜻과 할 일 |
|---|---|---|
| integration_not_connected | 404 | 이 워크스페이스에 구글 애즈 연결이 없습니다. 연결 화면에서 연결하세요. |
| integration_reconnect_required | 409 | 구글이 이 연결을 끊었습니다. 연결 화면에서 다시 연결하세요. |
| ad_budget_cap_unset | 409 | 하루 예산 상한이 없습니다. 연결 화면에서 정한 뒤 다시 시도하세요. |
| ad_budget_cap_exceeded | 422 | 켜진 캠페인의 합이 상한을 넘게 됩니다. 응답에 상한과 합계가 있습니다. 상한을 직접 올리거나 예산을 낮추세요. |
| ad_budget_increase_too_large | 422 | 예산은 한 번에 두 배까지만 올릴 수 있습니다. 나눠서 올리세요. |
| ad_budget_unreadable | 422 | 이 계정의 캠페인 중 구글이 하루 예산을 주지 않은 것이 있어 상한을 확인할 수 없습니다. 이 변경은 Google Ads 에서 하세요. |
| ad_status_superseded | 409 | 켜기가 줄을 기다리는 동안 같은 광고의 끄기가 와서 꺼진 채로 둡니다. 그래도 켜려면 다시 보내세요. |
| ads_no_access | 403 | 이 구글 계정으로 그 구글 애즈 계정을 더 열 수 없습니다. 접근을 되찾거나 다른 계정으로 다시 연결하세요. |
| ads_quota_exhausted | 429 | 이 워크스페이스나 uplika 전체의 오늘 구글 애즈 작업을 다 썼습니다. retryAfter 의 시각 뒤에 다시 시도하세요. 우리 장부는 id 로 광고를 끄는 것을 막지 않고, list_ads 는 id 를 찾을 작은 몫을 남겨 둡니다. 구글이 자기 한도로 거절할 수는 있습니다. 그때는 Google Ads 에서 끄세요. |
| ads_access_level_insufficient | 403 | uplika의 API 접근 등급이 아직 이 계정에 닿지 않아 구글이 거절했습니다. support@uplika.com 으로 알려 주세요. |
| ads_two_step_required | 403 | 이 계정 위의 관리자 계정이 2단계 인증을 요구합니다. 그 구글 계정에 2단계 인증을 켠 뒤 다시 시도하세요. |
| ads_upstream_rejected | 422 | 구글이 요청을 거절했습니다. 광고 정책이나 검증 때문인 경우가 많습니다. 응답의 googleErrors 에 구글이 준 이유가 있습니다. 그대로 다시 보내지 말고 요청을 고치세요. |
| ads_upstream_unavailable | 503 | 구글이 제때 답하지 않았거나 속도를 줄이라는 응답이 이어졌습니다. 다시 보내기 전에 list_ads 로 변경이 이미 됐는지 보세요. |
연결이 왜 실패했나요?
| 보이는 문장 | 할 일 |
|---|---|
| 구글 화면에서 취소했습니다. 연결된 것은 없습니다. | 다시 시작해 구글 화면에서 접근을 허용하세요. |
| 구글 애즈 캠페인을 관리할 권한이 필요합니다. 그 칸을 켠 채로 진행해 주세요. | 다시 시작해 Google Ads 칸을 켠 채로 진행하세요. |
| 이 구글 계정으로 열 수 있는, 광고를 집행하는 구글 애즈 계정이 없습니다. | 광고를 집행하는 구글 애즈 계정을 열 수 있는 구글 계정을 쓰세요. 아래에 계정이 없는 관리자 계정만으로는 안 됩니다. |
| 이 계정 위의 관리자 계정이 2단계 인증을 요구합니다. 이 구글 계정에 2단계 인증을 켠 뒤 다시 연결해 주세요. | 이 구글 계정에 2단계 인증을 켠 뒤 다시 시작하세요. |
| 구글이 지속 접근을 주지 않았습니다. 구글 계정에서 uplika 를 지운 뒤 다시 연결해 주세요. | 구글 계정 권한에서 uplika를 지운 뒤 다시 연결하세요. |
| 연결 링크가 만료됐습니다. 다시 시작해 주세요. | 링크는 최대 1시간 유효합니다. 연결 화면에서 다시 시작하세요. |
| 이 연결을 시작한 uplika 계정으로 로그인돼 있지 않습니다. 로그인한 뒤 연결 화면에서 다시 시작해 주세요. | 연결을 시작한 브라우저에서, 같은 uplika 계정으로 로그인한 채 끝내야 합니다. 다른 사람이 보낸 연결 링크는 쓰지 마세요. |
| 구글 로그인이 끝나지 않았습니다. 다시 시도해 주세요. | 연결 화면에서 다시 시작하세요. |
uplika는 무엇을 보관하나요?
연결을 유지하려고 암호화한 토큰, 계정의 식별자와 이름, 통화와 시간대, 시험 계정 여부, 거쳐 가는 관리자 계정, 상한, 구글 계정 식별자를 보관합니다.
uplika가 만들거나 바꾼 기록도 보관합니다. 대상의 이름 · 상태 · 하루 예산과, 변경마다 전후 값입니다. 지표는 데이터베이스에 쓰지 않습니다.
연결을 해제하면 어떻게 되나요?
광고는 멈추지 않습니다. 켜진 광고는 구글에서 계속 나가니 먼저 에이전트나 구글 애즈 화면에서 끄세요. uplika는 보관하던 토큰을 지우고 구글에 접근 종료를 요청합니다. 같은 구글 계정이 uplika의 다른 곳에 아직 연결돼 있으면 요청하지 않습니다. 만들고 바꾼 기록은 워크스페이스나 계정을 지울 때까지 남습니다.
자주 묻는 질문
에이전트가 혼자서 광고를 켤 수 있나요?
연결 화면에서 정한 하루 예산 상한 안에서만 됩니다. 상한이 없으면 읽기와 일시정지 캠페인 만들기만 합니다.
연결을 해제하면 광고가 멈추나요?
아닙니다. 켜진 광고는 에이전트나 구글 애즈 화면에서 끌 때까지 구글에서 계속 나갑니다.
계정을 여러 개 연결할 수 있나요?
워크스페이스마다 하나입니다. 다른 계정을 다루려면 다른 워크스페이스에 연결하세요.