가져오기

​

CSV 가져오기

​

CSV 요구사항

• UTF-8 인코딩 (BOM 제외)
• 인쇄할 수 없는 문자 없음 (특수 문자 또는 비 ASCII 문자 없음)
• 깔끔하고 고유한 열 헤더
• 150MB 미만의 파일 크기 (약 200만 행)
• 다음 중 하나 이상의 식별자:
  • external_id — 권장. 모든 구독에서 사용자를 식별합니다.
  • email — 새 이메일 구독 생성에 필요합니다. 자세한 내용은 이메일 주소 유효성 검사를 참조하세요.
  • phone_number — 새 SMS 구독 생성에 필요합니다.
  • subscription_id — 백엔드에서 OneSignal 구독 ID를 이미 추적하고 external_id를 설정하려는 경우에만 권장됩니다.

​

사용 가능한 CSV 열

​

태그 한도 및 제한

• 일괄 태그 업데이트 워크플로를 사용하여 사용자를 내보내고, 원하지 않는 태그 값을 지우고, 삭제 옵션을 활성화하여 다시 가져옵니다.
• 태그 키에 공백을 사용하지 마세요 — 대신 밑줄을 사용하세요.

• “user”
• “subscription”
• “message”
• “template”
• “app”
• “org”
• “custom_data”
• “dynamic_content”

• CSV에 포함된 태그는 제공된 값으로 덮어씁니다.
• CSV에 포함되지 않은 태그는 사용자 레코드에서 변경되지 않습니다.

• 헤더 열에 태그 키가 포함되어 있는지.
• 행에 값이 없는지.
• 검토 화면에서 “빈 값이 있는 태그 삭제” 옵션을 선택했는지.

• Segment
• HubSpot
• Journeys
• SDK 태깅 방법
• 맞춤 API 또는 ETL 파이프라인

​

단일 열에서 태그 가져오기

external_id,email,tags

userA,example@email.com,"{""level"":""30"",""Color"":""teal""}"

1

데이터 내보내기

• OneSignal 대시보드에서 Audience > Subscriptions으로 이동합니다. External ID, Subscription ID, Tags 열만 활성화합니다(선택적으로 Email 또는 Phone Number도 가능).
• Export를 클릭하여 CSV를 내보냅니다.

2

삭제할 태그 값 지우기

내보낸 CSV를 텍스트 편집기에서 열고 삭제할 각 태그의 값을 빈 문자열로 설정합니다.예를 들어, 편집 전 태그 값이 있는 행:

편집 전 행

복사

AI에게 묻기

userA,example@email.com,"{""level"":""30"",""color"":""teal""}"

태그 값을 지운 후 동일한 행:

태그 값 지운 후 행

복사

AI에게 묻기

userA,example@email.com,"{""level"":"""",""color"":""""}"

이렇게 하면 사용자에서 태그 level과 color가 삭제됩니다.

3

삭제 옵션을 사용하여 CSV 다시 가져오기

• 편집된 CSV를 가져옵니다.
• 검토 화면에서 빈 값의 태그 삭제에 대해 예를 선택합니다. OneSignal이 가져오기 중에 빈 값의 태그를 삭제합니다.

​

이메일 주소 유효성 검사

​

가져오기 전에 AI를 사용하여 CSV 확인

이 CSV에서 "user_name"을 제외한 모든 태그를 제거하고 싶습니다.

다음을 수행해 주세요:
1. "user_name" 태그 열만 유지하세요.
2. 다른 모든 태그 열을 제거하세요.
3. 이 문서의 OneSignal 가져오기 요구 사항과 일치하도록 CSV를 형식화하세요:
   https://documentation.onesignal.com/docs/en/import

제 CSV입니다:
[CSV 붙여넣기]

tag_first_name, tag_last_name, tag_city와 같은 여러 태그 열이 있습니다.

OneSignal 가져오기 문서에 따르면 각 태그는 다음을 충족해야 합니다:
- tag_ 접두사 사용
- 영숫자 문자와 밑줄만 포함
- 지원되는 데이터 유형 따르기

내 CSV를 검토하고 잘못 형식화된 항목을 식별하고 이러한 요구 사항을 충족하는 수정된 버전을 반환할 수 있습니까?

문서 링크:
https://documentation.onesignal.com/docs/en/import

OneSignal이 가져오기 중에 내 CSV를 거부했습니다.

다음을 수행해 주세요:
1. CSV 구조를 확인하세요.
2. 형식 문제(헤더, ID 열, 태그 형식, 인용 부호)를 식별하세요.
3. 이 문서의 요구 사항을 따르는 수정된 버전을 반환하세요:
   https://documentation.onesignal.com/docs/en/import#prepare-your-csv

파일은 다음과 같습니다:
[CSV 붙여넣기]

전화번호가 E.164 형식이 아니어서 가져오기가 실패합니다.

다음을 수행해 주세요:
1. 모든 전화번호를 E.164 형식으로 변환하세요.
2. 다른 모든 필드는 변경하지 마세요.
3. CSV가 OneSignal의 필수 구조와 일치하는지 확인하세요:
   https://documentation.onesignal.com/docs/en/import

현재 형식 예제: (555) 555-1234

제 CSV입니다:
[CSV 붙여넣기]

[플랫폼 이름]에서 OneSignal로 마이그레이션하고 있습니다.

이 CSV를 OneSignal의 가져오기 형식에 맞게 변환할 수 있습니까?
다음을 포함하세요:
- `external_id`
- `tag_` 접두사로 변환된 모든 태그(원하는 경우)
- E.164 형식의 전화번호(해당하는 경우)

참조 문서:
https://documentation.onesignal.com/docs/en/import

제 CSV입니다:
[CSV 붙여넣기]

​

가져오기 단계

1

CSV 업로드

준비된 CSV 파일을 선택합니다.

2

필드 매핑

OneSignal은 CSV 헤더를 알려진 속성에 자동으로 매핑합니다. 확인하기 전에 매핑을 검토하세요 — external_id, email, phone_number, 및/또는 subscription_id를 태그가 아닌 식별자로 사용하세요.

기존 사용자에게 새 이메일 또는 전화번호를 추가하려면 external_id를 반드시 사용해야 합니다. subscription_id를 사용하지 마세요 — 구독을 연결하거나 병합하지 않습니다.

OneSignal이 형식 문제를 감지하면 CSV를 수정하고 다시 업로드하거나(권장) 영향을 받는 열을 선택 해제하여 건너뜁니다.

3

검토 및 확인

검토 화면에서 다음을 수행할 수 있습니다:

• 세그먼트 자동 생성 — 가져온 각 사용자에게 태그를 추가하고 일치하는 세그먼트를 생성합니다. 플랜 제한에 주의하세요.
• 빈 값의 태그 삭제 — CSV에서 값이 비어 있는 태그를 삭제합니다. 원하지 않는 태그를 정리하고 플랜 제한 내에서 유지하는 데 유용합니다.
• 이메일 주소 유효성 검사 구성 — 이메일 주소 유효성 검사 설정을 구성하여 반송을 줄이고 발신자 평판을 보호하세요.

예를 들어, 다음 CSV를 사용한 경우:

복사

AI에게 묻기

external_id,tag1,tag2
UserA,,"tag2value"
UserB,"tag1value",

“빈 값의 태그 삭제” 옵션을 활성화하면 UserA에서 tag1이, UserB에서 tag2가 삭제됩니다.

확인 및 가져오기를 클릭합니다. 상태 화면에 진행 상황이 표시됩니다.

​

이메일 확인

• 앱에 존재하지 않는 고유한 이메일 주소 또는 전화번호에서 100개의 구독이 생성되었습니다.
• 37,814개의 구독이 업데이트되었습니다（사용자 수가 아님 — 각 사용자는 여러 구독을 가질 수 있습니다）.
• 621,852개 행이 가져오지 않았습니다. 외부 ID가 기존 사용자와 일치하지 않거나 이메일/전화번호가 이미 존재하며 새 데이터가 없었기 때문입니다.

​

수동 입력

​

자주 묻는 질문

​

CSV 가져오기는 얼마나 걸립니까?

​

CSV 가져오기를 취소할 수 있습니까?

​

세그먼트 수가 CSV의 행 수와 일치하지 않는 이유는 무엇입니까?

​

일부 행에서 가져오기가 “가져오지 않음”으로 표시되는 이유는 무엇입니까?

​

삭제된 태그가 계속 돌아오는 이유는 무엇입니까?