각 태그 키에 대해 별도의 열 헤더를 사용하는 대신 단일 tags 헤더를 설정할 수 있으며, 각 사용자 행에는 따옴표 안에 모든 키-값 쌍의 JSON 맵이 포함됩니다. 이는 이전에 태그가 포함된 CSV를 내보내고 다시 포맷하지 않고 다시 가져오려는 경우 특히 유용합니다.예제 헤더:
CSV 형식에 오류나 질문이 있는 경우 AI 도구(Claude, ChatGPT 등)에 CSV 문제를 설명하여 다시 가져오기 전에 파일을 자동으로 정리하거나 재구성할 수 있습니다.
수천 개의 레코드를 가져오기 전에 항상 작은 샘플(5-10행)로 테스트하세요.
일반적인 CSV 문제에 대한 AI 프롬프트 예제
태그 삭제
태그 형식
유효하지 않은 형식 식별
전화번호 수정
다른 플랫폼에서 마이그레이션
원하지 않는 태그를 삭제하기 위한 AI 프롬프트 예제
이 CSV에서 "user_name"을 제외한 모든 태그를 제거하고 싶습니다.다음을 수행해 주세요:1. "user_name" 태그 열만 유지하세요.2. 다른 모든 태그 열을 제거하세요.3. 이 문서의 OneSignal 가져오기 요구 사항과 일치하도록 CSV를 형식화하세요: https://documentation.onesignal.com/docs/en/import제 CSV입니다:[CSV 붙여넣기]
여러 태그 열 형식을 수정하기 위한 AI 프롬프트 예제
tag_first_name, tag_last_name, tag_city와 같은 여러 태그 열이 있습니다.OneSignal 가져오기 문서에 따르면 각 태그는 다음을 충족해야 합니다:- tag_ 접두사 사용- 영숫자 문자와 밑줄만 포함- 지원되는 데이터 유형 따르기내 CSV를 검토하고 잘못 형식화된 항목을 식별하고 이러한 요구 사항을 충족하는 수정된 버전을 반환할 수 있습니까?문서 링크:https://documentation.onesignal.com/docs/en/import
누락되거나 유효하지 않은 형식을 식별하기 위한 AI 프롬프트 예제
OneSignal이 가져오기 중에 내 CSV를 거부했습니다.다음을 수행해 주세요:1. CSV 구조를 확인하세요.2. 형식 문제(헤더, ID 열, 태그 형식, 인용 부호)를 식별하세요.3. 이 문서의 요구 사항을 따르는 수정된 버전을 반환하세요: https://documentation.onesignal.com/docs/en/import#prepare-your-csv파일은 다음과 같습니다:[CSV 붙여넣기]
유효하지 않은 전화번호 형식(E.164)을 수정하기 위한 AI 프롬프트 예제
전화번호가 E.164 형식이 아니어서 가져오기가 실패합니다.다음을 수행해 주세요:1. 모든 전화번호를 E.164 형식으로 변환하세요.2. 다른 모든 필드는 변경하지 마세요.3. CSV가 OneSignal의 필수 구조와 일치하는지 확인하세요: https://documentation.onesignal.com/docs/en/import현재 형식 예제: (555) 555-1234제 CSV입니다:[CSV 붙여넣기]
다른 플랫폼에서 마이그레이션하기 위한 AI 프롬프트 예제
[플랫폼 이름]에서 OneSignal로 마이그레이션하고 있습니다.이 CSV를 OneSignal의 가져오기 형식에 맞게 변환할 수 있습니까?다음을 포함하세요:- `external_id`- `tag_` 접두사로 변환된 모든 태그(원하는 경우)- E.164 형식의 전화번호(해당하는 경우)참조 문서:https://documentation.onesignal.com/docs/en/import제 CSV입니다:[CSV 붙여넣기]
가져오기가 완료되면 contact@onesignal.com으로부터 확인 이메일을 받게 됩니다. 단일 사용자가 여러 구독（예: 이메일 + 푸시）을 가질 수 있으므로 구독 수가 행 수보다 많을 수 있습니다.추가된 구독 레코드 — 새로 생성된 이메일 또는 SMS 구독. 0은 고유한 email 또는 phone_number 식별자가 없었음을 의미합니다.수정된 구독 레코드 — 데이터가 변경된 구독（태그, 속성 등）. 예: 10개의 외부 ID 각각이 20개의 구독과 연결된 경우 = 200개의 레코드 수정.건너뛴 구독 업데이트 — 명시된 이유로 건너뛴 구독. 이유가 “앱의 태그 제한 초과”인 경우 태그를 제거하고 다시 가져오거나 플랜을 업그레이드하세요.가져오지 않음 — 업데이트되거나 가져오지 않은 행. 일반적인 원인: external_id가 기존 구독과 일치하지 않거나 email/phone_number가 이미 존재하며 설정할 새 데이터가 없는 경우.생성된 새 세그먼트 — 해당 옵션을 선택한 경우의 세그먼트 이름.
이메일 확인 예제.
위의 예에서:
앱에 존재하지 않는 고유한 이메일 주소 또는 전화번호에서 100개의 구독이 생성되었습니다.
37,814개의 구독이 업데이트되었습니다（사용자 수가 아님 — 각 사용자는 여러 구독을 가질 수 있습니다）.
621,852개 행이 가져오지 않았습니다. 외부 ID가 기존 사용자와 일치하지 않거나 이메일/전화번호가 이미 존재하며 새 데이터가 없었기 때문입니다.
