이 가이드에서는 앱의 효율성과 성능을 최적화하기 위해 구현할 수 있는 몇 가지 권장사항을 설명합니다.
지속적인 유지관리
앱이 중단 없이 실행되도록 하려면 다음 안내를 따르세요.
API 센터의 개발자 연락처 이메일을 최신 상태로 유지하세요. 이 별칭은 Google에서 연락을 드릴 때 사용하는 별칭입니다. Google에서 API 이용약관 준수와 관련하여 연락을 드릴 수 없는 경우 API 액세스 권한이 사전 예고 없이 취소될 수 있습니다. 개인 계정 또는 모니터링되지 않는 계정에 연결된 개인 이메일 주소는 사용하지 마세요.
제품 변경, 유지보수 다운타임, 지원 중단 날짜 등의 문제에 대한 알림을 받으려면
Google Ads API팀은 이 포럼을 정기적으로 모니터링하므로 API 관련 질문을 올리기에 가장 적합한 곳입니다.
- 앱이 Google Ads API 이용약관 (T&C)을 준수하도록 합니다. 필요한 경우 토큰 검토 및 규정 준수팀에서 연락처 이메일을 사용하여 연락합니다. 이용약관에 관한 질문이나 우려사항이 있는 경우 개발자 토큰 신청을 검토할 때 보낸 이메일에 답장하여 검토팀에 연락하면 됩니다.
최적화
일괄 작업
API에 요청을 하려면 왕복 네트워크 지연 시간, 직렬화 및 역직렬화 처리, 백엔드 시스템 호출과 같은 고정 비용이 많이 수반됩니다. 이러한 고정 비용의 영향을 줄이고 전반적인 성능을 향상시키기 위해 API에 있는 대부분의 Variant 메서드는 일련의 작업을 허용하도록 설계되었습니다. 여러 작업을 각 요청에 일괄 처리하면 요청 횟수 및 관련 고정 비용을 줄일 수 있습니다. 가능하면 한 번의 작업으로 요청하지 않는 것이 좋습니다.
예를 들어 여러 광고그룹의 캠페인 하나에 50,000개의 키워드를 추가한다고 가정해 보겠습니다. 키워드 1개로 요청을 50,000번 하는 대신 각각 500개의 키워드로 요청을 100번 하거나 키워드 5,000개를 이용해 요청을 10번 해도 됩니다. 요청에서 허용되는 작업 수에 제한이 있으므로 최적의 성능을 얻으려면 배치 크기를 조정해야 할 수 있습니다.
희소 객체 보내기
객체가 API로 전송될 때 필드를 역직렬화하고 확인하고 데이터베이스에 저장해야 합니다. 필드 몇 개만 업데이트하려는 경우 전체 객체를 전달하면 처리 시간이 길어지고 성능이 저하될 수 있습니다.
이 문제를 완화하기 위해 Google Ads API는 스파스 업데이트를 지원하므로, 변경해야 하거나 변경이 필요한 객체의 필드만 채울 수 있습니다. 희소 업데이트는 더 빠르게 처리되며 오류가 발생할 가능성이 작습니다.
update_mask에 없는 필드 (FieldMask라고도 함)는 변경되지 않습니다.
예를 들어 키워드 수준 입찰가를 업데이트하는 앱은 희소 업데이트를 사용하여 광고 그룹 ID, 기준 ID, 입찰 필드만 채워야 하는 이점을 얻을 수 있습니다.
오류 처리 및 관리
개발 중에 오류가 발생하기 쉽습니다. 이 섹션에서는 앱에 오류 관리를 빌드하기 위한 고려사항과 전략을 설명합니다. 오류 관리에 관한 자세한 내용은 이 섹션 외에도 문제 해결 가이드를 참고하세요.
요청 소스 구분
일부 앱은 주로 대화형이며 UI에서 사용자가 시작한 작업에 대한 응답으로 직접 API를 호출합니다. 어떤 API는 주기적인 백엔드 프로세스의 일부로 API 호출을 실행하여 주로 오프라인으로 작동합니다. 많은 앱이 이 둘을 결합합니다. 오류 관리를 고려할 때는 이러한 다양한 유형의 요청을 구분하는 것이 유용할 수 있습니다.
사용자가 시작한 요청의 경우 사용자에게 우수한 환경을 제공하는 것이 주된 관심사입니다. 발생한 특정 오류를 사용하여 사용자에게 UI에서 가능한 한 많은 컨텍스트를 제공합니다. 오류를 해결하기 위해 취할 수 있는 간단한 단계를 제공하세요 (아래 제안사항 확인).
백엔드에서 시작된 요청의 경우 앱에 발생할 수 있는 다양한 유형의 오류에 관한 핸들러를 구현합니다. 항상 기본 핸들러를 포함하여 드물게 발생하거나 이전에 발견되지 않은 오류를 해결합니다. 기본 핸들러의 좋은 방법은 실패한 작업과 오류를 큐에 추가하여 실제 작업자가 검토하고 적절한 해결 방법을 결정할 수 있도록 하는 것입니다.
오류 유형 구분
Google Ads API의 오류 유형 간 차이를 이해하는 것은 강력한 오류 처리를 구축하는 데 중요합니다. 가장 일반적인 오류 유형은 다음과 같습니다.
자세한 내용은 오류 유형 및 일반적인 오류를 참조하세요.
백엔드 동기화
앱 사용자에게 Google Ads 계정에 대한 수동 액세스 권한이 있는 경우 앱에서 인식하지 못하는 변경사항을 적용하여 앱의 로컬 데이터베이스가 동기화되지 않을 수 있습니다. 오류 유형 가이드에 설명된 대로 동기화 관련 오류가 발생하면 사후에 해결할 수 있지만 사전에 이러한 오류를 방지할 수도 있습니다. 한 가지 사전 예방적 전략은 모든 계정에서 야간 동기화 작업을 실행하여 계정에서 Google Ads 객체를 검색하고 로컬 데이터베이스와 비교하는 것입니다.
로그 오류
디버깅과 모니터링을 용이하게 하기 위해 모든 오류를 로깅해야 합니다. 최소한 요청 ID, 오류를 유발한 작업, 오류 자체는 로깅합니다. 로깅할 기타 정보로는 고객 ID, API 서비스, 왕복 요청 지연 시간, 재시도 횟수, 원시 요청 및 응답이 있습니다.
추세 모니터링
앱 문제를 감지하고 해결할 수 있도록 API 오류의 추세를 모니터링해야 합니다. 자체 솔루션을 빌드하거나 로그를 사용하여 대화형 대시보드를 생성하고 자동 알림을 보낼 수 있는 여러 상용 도구 중 하나를 사용하는 것이 좋습니다.
개발
테스트 계정 사용
테스트 계정은 실제로 광고를 게재하지 않는 Google Ads 계정입니다. 테스트 계정을 사용하여 Google Ads API를 실험하고 앱의 연결, 캠페인 관리 로직 또는 기타 처리가 예상대로 작동하는지 테스트할 수 있습니다. 개발자 토큰을 테스트 계정에서 사용하도록 승인할 필요가 없으므로 개발자 토큰을 요청한 직후, 앱이 검토되기 전이라도 Google Ads API로 개발을 시작할 수 있습니다.