이 일의 형태는 언제나 같습니다. 먼저 읽고, 다음에 제안하고, 무언가 일어나기 전에 누군가 살펴보게 합니다. 읽는 것은 앞의 레시피이고, 이것은 두 번째 단계입니다.
제안하기
curl -sX POST https://top-rated.team/google-ads/v1/accounts/1234567890/changes \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "Content-Type: application/json" \
-d '{
"summary": "Pause the Brand campaign: CTR under 1% for three weeks",
"operations": [
{
"campaignOperation": {
"update": {
"resourceName": "customers/1234567890/campaigns/987654321",
"status": "PAUSED"
},
"updateMask": "status"
}
}
]
}'
응답으로 change_id가 돌아옵니다. 그 시점에 Google이 모든 작업을 검증했으므로, 돌아온 제안은 실행될 제안입니다. 다만 계정은 전과 완전히 같습니다. summary는 사람이 결정하기 전에 읽는 한 줄이므로, 로그가 아니라 그 사람을 위해 쓰세요.
그다음에 일어나는 일
- 프로젝트 룸에서는 제안이 카드로 나타납니다. 무엇을 어떻게 바꾸는지가 전부 보이고, 그 옆에 적용과 건너뛰기가 있습니다.
- API에서는 POST /google-ads/v1/changes/{change_id}/apply에 {"apply": true}를 보내면 실제로 적용되고, false이면 폐기됩니다.
- 전문가가 맡은 계정이면 룸에는 버튼 없는 카드가 보입니다. 제안은 전문가의 대기열로 가고, 전문가가 적용합니다.
- task_id로 제안이 답하는 프로젝트 룸 작업을 지정하면, 변경을 적용할 때 그 작업이 닫힙니다.
되도록 일시중지를 고르세요. 삭제한 것은 되돌릴 수 없지만 일시중지는 되돌릴 수 있고, 둘은 대개 같은 효과를 냅니다.
자주 묻는 질문
제안의 작업 하나가 잘못되었다면요?
제안 전체가 거부되고, 어느 부분에 이의가 있는지에 대한 Google 자신의 말이 붙습니다. 일부만 기록되는 일은 없으므로, 대기 중인 변경은 언제나 전부 실행될 변경입니다.
변경 여러 개를 한 번에 제안할 수 있나요?
네, 제안 하나에 작업을 최대 50개까지 담을 수 있고, 함께 적용되거나 전혀 적용되지 않습니다. 그래도 제안 하나는 결정 하나로 유지하세요. 사람이 한 문장으로 설명할 수 있는 것을 승인하게 하는 것이 summary의 목적입니다.
제안은 얼마나 기다리나요?
필요한 만큼입니다. 만료시키는 것도 없고, 대신 적용해 주는 것도 없습니다. 사람이 적용하거나 건너뛸 때까지 계정의 기록에 대기 중으로 남습니다.