# GenderAPI 앱으로 Shopify 고객 레코드 보강하기

> Shopify 앱을 설정하고 고객 태그와 custom.gender 메타필드를 이해하며, 누락된 이름 보완을 검토하고, 앱 자체의 요금제와 잔액으로 알 수 없는 결과를 관리하세요.

Canonical HTML: https://www.genderapi.io/ko/blog/how-to-determine-gender-in-shop-ify-using-gender-api

Last reviewed: 2026-09-30

## 고객 데이터 보강에는 Shopify 전용 앱 사용하기

GenderAPI Shopify 앱은 기존 고객과 신규 고객을 처리하고, 추정된 성별 신호를 추가하며, 누락된 이름(first name)을 이메일 주소에서 도출할 수 있습니다. 사용할 Shopify 스토어에서 시작하고, 업데이트하려는 고객 필드에 맞는 앱 설정을 선택하세요.

이 앱은 자체 처리 설정과 요금제 설정을 갖춘 Shopify 전용 앱입니다. 2026년 9월 27일에 검토한 구현은 공개 V2 추정 엔드포인트를 호출하지 않습니다. API 키 잔액, V2 AI 옵션, V2 응답 필드가 이 앱에 적용된다고 가정하지 마세요.

- [Shopify App Store 공식 등록 정보](https://apps.shopify.com/gender-api)

## 스토어를 준비하고 변경할 내용 정하기

- Shopify App Store에서 "Gender API - Determine gender"를 여세요. 설치하기 전에 Ozan Soft의 등록 정보인지, 그리고 대상 스토어, 현재 권한, 요금제를 확인하세요.
- 앱의 잔액과 고객 처리 설정을 검토하세요. 기존 레코드를 처리할지, 신규 고객 자동 처리를 켤지, 또는 둘 다 할지 결정하세요.
- 이름이 입력된 고객, 이름이 누락된 고객, 모호한 입력이 있는 고객 등 소수의 고객 레코드를 확인하세요. 결과를 검토하는 동안 기존 이름과 태그가 보이도록 해 두세요.
- 이메일 주소에서 도출한 후보를 고객의 이름 필드에 기록하려는 경우에만 누락된 이름 보완을 켜세요. 성별 추정과 이름 수정은 별개의 결정입니다.
- 세그먼트에 사용하기 전에 생성된 태그와 고객 메타필드를 확인하세요. 관련 없는 고객 정보가 그대로 유지되는지 확인하세요.

## 앱이 사용하는 고객 필드 이해하기

아래 매핑은 검토한 앱 소스 코드를 기준으로 합니다. 후속 워크플로를 연결하기 전에 설치된 앱과 통제된 표본으로 확인하세요.

| 고객 필드 또는 설정 | 방향 | 동작 |
| --- | --- | --- |
| 이름(first name) | 입력 | 값이 있으면 우선 사용되는 이름 입력입니다. |
| 이메일 주소 | 입력 | 이름이 누락된 경우 후보 이름을 도출하는 데 사용됩니다. 쓸 만한 이름이 없는 주소는 판정되지 않은 상태로 남을 수 있습니다. |
| 주소의 국가 | 선택적 컨텍스트 | 처리 과정에서 고객 주소의 국가가 있으면 이름 조회의 컨텍스트로 사용할 수 있습니다. |
| 고객 태그 | 출력 | 검토한 구현은 male, female 또는 gender_null을 사용하며, 관련 없는 태그는 그대로 유지합니다. |
| custom.gender | 출력 | 추정된 레이블을 한 줄 텍스트 값으로 담는 고객 메타필드입니다. |
| 이름 업데이트 | 선택적 출력 | 이 기능을 켜면 이메일 주소에서 도출한 후보로 누락된 이름을 채울 수 있습니다. 구현은 first_name_found_from_email을 추가합니다. |
| 자동 보강 | 앱 설정 | 신규 고객 이벤트 처리를 제어합니다. 이용 가능 여부는 앱 요금제와 설정에 따라 다릅니다. |

## 태그, 알 수 없는 결과, 기존 분류 확인하기

처리된 고객을 Shopify에서 열고 태그, custom.gender, 이름을 원래 레코드와 비교하세요. 세그먼트에는 API의 JSON 경로를 사용할 수 있다고 가정하지 말고, 실제로 기록된 필드와 레이블을 사용하세요.

검토한 처리 작업은 이미 male, female 또는 gender_null 태그가 있는 고객을 건너뜁니다. 따라서 변경되지 않은 레코드는 새 조회가 아니라 기존 분류를 나타낼 수 있습니다. 다시 실행하기 전에 이전 분류를 어떻게 검토할지 정하세요.

gender_null은 판정되지 않은 결과로 유지하세요. 이 앱의 매핑은 V2 신뢰도 점수, 출처 필드, 요청별 usage 레코드를 제공하지 않습니다. 스프레드시트로 내보낸 데이터에 이러한 값을 지어내거나, 알 수 없는 결과를 이분법적 분류로 바꾸지 마세요.

| 결과 | 권장 다음 단계 |
| --- | --- |
| 예상한 태그와 메타필드 | 원본 고객 ID를 확인하고, 의도한 세그먼트나 후속 업데이트만 허용하세요. |
| gender_null | 판정되지 않은 결과로 유지하고, identified 결과가 필요한 규칙에서 제외하세요. |
| 기존 성별 태그 | 다시 처리하기로 결정하기 전에 앱이 해당 고객을 건너뛰었는지 확인하세요. |
| 업데이트 누락 또는 불일치 | 그룹 전체를 다시 실행하기 전에 앱의 작업 상태를 확인하세요. |

## 앱 요금제와 데이터 접근 권한 검토하기

고객 처리 한도는 Shopify 앱의 현재 요금제 화면과 잔액에서 확인하세요. 검토한 앱은 스토어별 크레딧 잔액과 Shopify 구매 흐름을 사용하며, 공개 GenderAPI API 키로 설정하는 방식이 아닙니다. V2 크레딧 요금을 적용하지 말고 앱 등록 정보에서 현재 가격을 확인하세요.

이 앱은 고객 데이터에 접근해야 하며 고객 레코드를 수정할 수 있습니다. 처리 과정에 앱 측 대기열이 포함되므로, 이메일 조회 보존에 관한 설명을 이 워크플로 중에 고객 데이터가 어디에도 남지 않는다는 약속으로 읽어서는 안 됩니다. 스토어에 대한 앱 권한과 공개된 정책을 검토하세요.

추정된 레이블은 불확실성을 내포한 데이터 신호입니다. 본인이 밝힌 정보와 구분하고, 자격, 접근, 가격 책정 또는 그 밖의 중대한 결정에 이 레이블만을 근거로 사용하지 마세요.

- [현재 Shopify 요금제와 권한](https://apps.shopify.com/gender-api)
- [GenderAPI 개인정보 처리방침](https://www.genderapi.io/ko/privacy-policy)

## 구조화된 응답이 필요하면 V2 사용하기

직접 구축하는 연동에서는 GenderAPI V2가 이름, 이메일 주소, 사용자 이름을 받아 결과, 신뢰도, 출처, 사용량을 나타내는 명시적인 필드를 반환합니다. 이 연결은 별도로 설정하세요. V2 가이드를 읽는다고 해서 설치된 앱이나 앱이 기록하는 출력 열이 바뀌지는 않습니다.

Python과 Node.js 예시는 단일 요청, 일괄 요청, 알 수 없는 결과, 운영상 오류를 다룹니다. 인증 가이드부터 시작하고, 과금 대상 요청을 보내기 전에 AI 모드를 선택하세요.

- [V2 인증](https://www.genderapi.io/ko/docs/v2/authentication)
- [V2 응답 필드](https://www.genderapi.io/ko/docs/v2/responses)
- [Python 연동 예시](https://www.genderapi.io/ko/integrations/python)
- [Node.js 연동 예시](https://www.genderapi.io/ko/integrations/javascript)

## Shopify 앱을 V2 API 키로 설정하나요?

검토한 Shopify 전용 앱은 Shopify 설치, 자체 요금제 설정, 스토어별 잔액을 사용합니다. 직접 구축하는 V2 HTTP 워크플로는 별도의 연동이며 이 앱의 설정을 대신하지 않습니다.

## 추정된 고객 레이블은 어디에서 확인하나요?

검토한 앱은 고객 태그와 custom.gender 고객 메타필드에 값을 기록합니다. 이 값으로 세그먼트를 만들기 전에 설치된 앱과 샘플 고객을 확인하세요.

## gender_null은 무엇을 의미하나요?

검토한 Shopify 전용 앱에서 판정되지 않은 레이블을 나타냅니다. 이 값을 male 또는 female로 바꾸지 말고 해당 고객을 알 수 없는 결과 그룹에 두세요.

## 고객 이름을 변경하지 않고 그대로 둘 수 있나요?

누락된 이름 보완 설정은 성별 처리와 별도로 검토하세요. 앱이 이메일 주소에서 도출한 후보로 누락된 이름을 채우기를 원할 때만 이 설정을 켜세요.

## 출처와 문서

- [공식 등록 정보: Shopify](https://apps.shopify.com/gender-api)
- [개인정보 처리방침과 데이터 처리](https://www.genderapi.io/ko/privacy-policy)
- [별도의 V2 API 문서](https://www.genderapi.io/ko/api-documentation)