미국 시장에서 구글 쇼핑 광고는 이제 선택이 아닌 필수입니다. 하지만 어느 날 갑자기 광고가 멈추고, 개발팀은 “API 오류 같다”는 모호한 답변만 돌아온다면? 매출은 실시간으로 줄어드는데, 정확히 무엇을 어떤 순서로 확인해야 할지 막막한 순간이 옵니다.
특히 Google Merchant Center(GMC)가 기존 Content API에서 새로운 Merchant API로 전환하면서, 에러 구조와 복구 프로세스가 완전히 달라졌습니다. API 연동 오류 한 건이 전체 쇼핑 캠페인 중단으로 이어지는 사례가 급증하고 있죠. 이 글에서는 마케터 관점에서 반드시 알아야 할 실전형 복구 체크리스트를 단계별로 정리해드립니다.
왜 지금, API 오류 대응이 더 중요해졌나
Google은 최근 1년간 GMC 생태계를 대대적으로 재편했습니다. 기존 Content API for Shopping에서 Merchant API로의 점진적 전환이 진행 중이며, 새 API는 AIP-193 표준 에러 구조를 도입해 에러 원인을 기계적으로 파싱할 수 있게 만들었습니다.
더 주목할 점은 MerchantSupport 서비스의 등장입니다. 이제 써드파티 앱(Shopify, 카페24 등)이 자체 대시보드 안에 GMC 진단 정보를 직접 표시할 수 있게 되었죠. 즉, 마케터가 직접 개발 콘솔에 들어가지 않고도 실시간으로 문제를 파악하고 대응할 수 있는 환경이 만들어진 겁니다.
하지만 이 모든 기능을 제대로 활용하지 못하면? 계정 정지, 상품 대량 비승인, 피드 재검수 지연이 반복되며 귀중한 광고 예산만 낭비하게 됩니다.
1단계: 광고 중단 범위와 원인 유형 빠르게 분류하기
광고가 멈췄을 때 가장 먼저 해야 할 일은 “정책/계정 문제”인지, “데이터/API 문제”인지를 구분하는 것입니다.
GMC 진단 탭 우선 체크
- GMC 계정에 로그인 → [제품] → 진단 탭으로 이동
- “계정 문제”, “피드 문제”, “상품 문제” 중 어디에 경고가 있는지 확인
- 계정 정지/경고인지, 피드 처리 실패인지, 상품 비승인인지 명확히 분류
Google Ads와 크로스체크
- 캠페인/광고그룹 상태가 ‘자격 없음’, ‘제한됨’으로 표시되는지 확인
- 이를 GMC 진단과 매칭해 문제의 본질을 파악합니다
전략 포인트: 정책 문제라면 Google 지원팀과 커뮤니케이션을 준비하고, API/피드 문제라면 즉시 개발팀과 로그·코드를 검토해야 합니다. 이 분기점을 명확히 하는 것만으로도 복구 시간을 절반으로 줄일 수 있습니다.
2단계: API 에러 로그와 REASON 코드로 기술 진단
API 문제로 좁혀졌다면, 이제 개발자에게 정확한 정보를 요구할 차례입니다.
개발팀에 요청해야 할 핵심 데이터
- 오류가 발생한 엔드포인트 (예: products.insert, inventory.custombatch)
- HTTP 상태 코드 (4xx/5xx)와 error.message 전문
- 특히 error.details[].metadata.REASON 필드 값
주요 REASON 코드와 의미
- INVALID_ARGUMENT, INVALID_NAME_PART_NOT_NUMBER: 리소스 이름이나 파라미터 형식 오류. 보통 merchantId나 productId 포맷 문제
- PERMISSION_DENIED: 잘못된 계정 권한, OAuth 스코프 부족, 또는 다른 계정의 merchantId를 사용한 경우
- RESOURCE_EXHAUSTED: API 할당량 초과. 짧은 시간 내 대량 업로드가 원인일 가능성
마케터가 던져야 할 질문
- 최근 Merchant ID, GMC 계정 구조, 국가 타겟 설정에 변경이 있었나요?
- 새로운 피드 앱이나 API 클라이언트로 교체했나요?
- 최근 며칠간 상품/가격 대량 업데이트를 진행했나요?
전략 포인트: REASON 코드 기반의 에러 대시보드를 내부에 구축하면, 어떤 유형의 에러가 반복되는지 한눈에 파악할 수 있습니다. 예를 들어 PERMISSION_DENIED가 반복된다면 OAuth 설정을, INVALID_ARGUMENT가 많다면 스키마 검증 로직을 우선 개선해야 합니다.
3단계: 피드·데이터 불일치와 스키마 문제 점검
DataFeedWatch의 분석에 따르면, 전체 GMC 에러의 상당 부분이 스키마 불일치와 필수 필드 누락에서 발생합니다.
톱 에러 유형별 체크 포인트
- 필수 속성 누락: 제목, 설명, 링크, 이미지, 가격, 재고, 브랜드/GTIN 등이 누락되거나 형식이 잘못된 경우
- identifier_exists 모순: false로 설정했는데 브랜드/GTIN을 함께 보낸 경우 → 즉각 에러
- 배송/세금 설정 오류: shipping 속성에서 price와 country를 모두 지정하지 않으면 에러 발생. 국가별 필수 속성(세금, 배송비) 누락 여부 확인 필요
- 자동 업데이트 경고: “Automatic item updates active [price/availability]” 메시지가 뜨면, 사이트와 피드 간 불일치를 Google이 자동 보정 중이라는 신호. 이 상태가 오래 지속되면 품질 문제로 확대될 수 있습니다
전략 포인트: 마케터는 “어떤 속성이 왜 필요한지”를 정확히 이해해야, 상품팀과 운영팀에 올바른 데이터 입력 규칙을 요구할 수 있습니다. 특히 글로벌 타겟 시 국가별 세금·배송 규칙이 다르므로, 프로모션이나 무료배송 캠페인 변경 시 피드도 함께 업데이트해야 에러를 예방할 수 있습니다.
4단계: URL/트래킹·솔루션 연동 문제 점검
Shopify 커뮤니티에서는 API 연동으로 GMC에 전송된 상품이 엉뚱한 URL로 연결되는 사례가 보고되고 있습니다. 원인은 잘못된 variant 매핑, 링크 생성 로직 버그, 캐시된 URL 구조 변경 등입니다.
URL 관련 체크리스트
- 최근 사이트 리뉴얼(카테고리/URL 구조 변경) 후 API 연동 코드를 수정했나요?
- UTM 파라미터나 전환 추적 스크립트 때문에 URL이 과도하게 길어지거나 리다이렉트가 여러 번 발생하나요?
- Shopify, Magento 등 플랫폼 앱 업데이트 이후 상품 링크 매핑 문제가 보고된 적이 있나요?
전략 포인트: GMC 진단에서 “URL 관련 에러” 항목을 주기적으로 모니터링하고, 오류 URL 리스트를 다운로드해 개발팀에 패턴 분석(특정 카테고리/템플릿/기기별 문제인지)을 요청하세요. 공식 앱이라도 버그가 있을 수 있으니, 커뮤니티와 릴리즈 노트를 항상 확인하는 습관이 중요합니다.
5단계: 자동 복구와 사전 예방 전략 구축
가장 효율적인 대응은 ‘문제가 생기기 전’에 막는 것입니다.
MerchantSupport 기반 인앱 진단 구축
Google은 써드파티 솔루션이나 자체 Admin에 GMC 이슈를 실시간으로 표시하는 대시보드를 구현할 수 있도록 MerchantSupport API를 제공합니다. 이를 활용하면:
- 계정/피드/상품 레벨 이슈 리스트 자동 표시
- 각 이슈에 대한 권장 조치 링크 또는 인앱 폼 제공
- 조치 후 재요청으로 해결 여부 즉시 갱신
에러 유형별 자동 알림과 롤백
- REASON 코드별로 Slack/이메일 알림 설정
- 특정 임계치 이상 에러 발생 시 신규 피드 배포 일시 중단
- 이전 정상 버전으로 자동 롤백하는 시스템 구축
사전 스키마 검증 파이프라인
실제 Merchant API 호출 전에, 내부에서 GMC 스키마와 비즈니스 규칙을 반영한 검증 단계를 하나 더 두는 것이 권장됩니다. GTIN 형식, identifier_exists와 브랜드/MPN 조합, 필수 속성 완전성을 사전에 체크하면 에러를 원천 차단할 수 있습니다.
전략 포인트: 마케터는 개발팀과 협의해 “광고에 치명적인 에러 리스트”를 사전 정의해야 합니다. 예를 들어 새 피드 배포 시 PERMISSION_DENIED, INVALID_ARGUMENT, 상품 30% 이상 비승인 등이 감지되면 자동으로 캠페인 예산 축소, 피드 롤백, 알림 발송이 이뤄지도록 설계하세요. 야간·주말에도 손실을 최소화할 수 있습니다.
전문가의 조언: API 문제를 마케팅 KPI 이슈로 번역하라
업계에서는 쇼핑 광고 성과 저하의 상당 부분이 정책 위반이나 입찰 전략이 아닌, 데이터 품질과 API 연동 문제에서 출발한다는 인식이 확산되고 있습니다. 전문 피드 관리 업체들은 “데이터 품질 = ROAS 레버”라고 강조하며, 에러와 경고를 줄이는 것이 곧 CPC 효율, 전환율 개선과 직결된다고 봅니다.
월간 리포트에 “데이터 품질 지표(상품 승인율, 경고 수, 자동 업데이트 비율)”를 포함시키고, 이를 ROAS/매출 변화와 함께 추적하면 조직 내에서 API/피드 개선의 중요성을 훨씬 쉽게 설득할 수 있습니다.
마무리하며
GMC API 오류는 더 이상 “개발팀의 문제”가 아닙니다. 마케터가 에러의 유형과 복구 프로세스를 이해하고 주도적으로 대응해야만, 광고 중단으로 인한 매출 손실을 최소화할 수 있습니다.
하지만 이 모든 것을 혼자서 완벽히 해내기는 쉽지 않습니다. 미국 현지의 GMC 정책 변화, API 업데이트 동향, 그리고 실제 복구 사례를 가장 빠르고 정확하게 파악하고 있는 파트너와 함께한다면 훨씬 안전하고 효율적인 진출이 가능합니다.
캘리와이어(Calywire)는 미국 현지에서 20년 이상 축적된 노하우로, 한국 기업의 쇼핑 광고 운영과 GMC 연동 최적화를 전문적으로 지원합니다. API 오류 대응부터 데이터 품질 관리, 사전 예방 시스템 구축까지 — 복잡한 기술 이슈를 마케팅 성과로 바꾸는 것이 우리의 강점입니다. 미국 시장에서 안정적이고 지속 가능한 성장을 원하신다면, 지금 캘리와이어와 함께 시작하세요.
