각 태그 키에 대해 별도의 열 헤더를 사용하는 대신 단일 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가 기존 사용자와 일치하지 않거나 이메일/전화번호가 이미 존재하며 새 데이터가 없었기 때문입니다.
가져오기 후 통합 또는 SDK 호출이 태그를 다시 추가하고 있을 수 있습니다. 일반적인 소스로는 Segment, HubSpot, Journeys, SDK 태깅 메서드, 사용자 지정 API가 있습니다. 통합 매핑과 이벤트 트리거를 검토하세요.
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OneSignal Documentation","description":"OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.","colors":{"primary":"#3A3DB3","light":"#E54B4D","dark":"#3A3DB3"},"logo":{"light":"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107","dark":"https://mintcdn.com/onesignal/s4WC_KzLxf8ornqq/logo/OneSignal-Logo-White.svg?fit=max\u0026auto=format\u0026n=s4WC_KzLxf8ornqq\u0026q=85\u0026s=2573a53b5aea961e18c82b3af8f31925"},"favicon":"https://mintcdn.com/onesignal/SGduBFHpiRdg5l6h/favicon.ico?fit=max\u0026auto=format\u0026n=SGduBFHpiRdg5l6h\u0026q=85\u0026s=c0a99fadc0553c658a83741c5611cef4","api":{"examples":{"languages":["curl","typescript","python","php","go","ruby","java","csharp","rust"],"autogenerate":true}},"navbar":{"links":[{"href":"mailto:support@onesignal.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.onesignal.com"}},"footer":{"socials":{"github":"https://github.com/OneSignal","linkedin":"https://linkedin.com/company/onesignal","youtube":"https://www.youtube.com/@onesignalofficial/playlists"}},"seo":{"metatags":{"apple-mobile-web-app-title":"OneSignal Docs"}},"fonts":{"family":"Nunito Sans"},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"ga4":{"measurementId":"G-2DGWL0VYP5"},"posthog":{"apiKey":"phc_vZpvE0f5eyzcOt30FHer34yddVmNdo9kmlMVRBzLMtn","apiHost":"https://eu.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"languages":[{"language":"en","href":"docs/en/home"},{"language":"cn","href":"docs/cn/home"},{"language":"ko","href":"docs/ko/home"},{"language":"ja","href":"docs/ja/home"},{"language":"tr","href":"docs/tr/home"},{"language":"pt-BR","href":"docs/pt-BR/home"},{"language":"es","href":"docs/es/home"},{"language":"fr","href":"docs/fr/home"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onesignal","hasAudioNarration":false,"actualSubdomain":"onesignal","customDomains":["documentation.onesignal.com"],"gitSource":{"type":"github","owner":"onesignal","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3b762ba298f9b99480a99","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"en","tag":"User Guides","count":204},{"language":"es","tag":"Guías del Usuario","count":178},{"language":"fr","tag":"Guides utilisateur","count":178},{"language":"ja","tag":"ユーザーガイド","count":178},{"language":"ko","tag":"사용자 가이드","count":178},{"language":"pt-BR","tag":"Guia do Usuário","count":178},{"language":"tr","tag":"Kullanıcı Kılavuzları","count":178},{"language":"cn","tag":"用户指南","count":176},{"language":"en","tag":"Message channels","count":90},{"language":"es","tag":"Canales de mensajería","count":84},{"language":"fr","tag":"Canaux de messagerie","count":84},{"language":"ja","tag":"メッセージングチャネル","count":84},{"language":"ko","tag":"메시지 채널","count":84},{"language":"pt-BR","tag":"Canais de mensagem","count":84},{"language":"tr","tag":"Mesaj kanalları","count":84},{"language":"cn","tag":"消息渠道","count":83},{"language":"default","tag":"API Reference","count":68},{"language":"default","tag":"API reference","count":64},{"language":"en","tag":"Analytics \u0026 Integrations","count":53},{"language":"es","tag":"Analítica \u0026 Integraciones","count":52},{"language":"fr","tag":"Analyses et intégrations","count":52},{"language":"ja","tag":"分析 \u0026 統合","count":52},{"language":"ko","tag":"분석 \u0026 통합","count":52},{"language":"pt-BR","tag":"Análises \u0026 Integrações","count":52},{"language":"tr","tag":"Analitik ve Entegrasyonlar","count":52},{"language":"cn","tag":"分析和集成","count":51},{"language":"cn","tag":"开发者指南","count":48},{"language":"es","tag":"Guías del desarrollador","count":48},{"language":"fr","tag":"Guides développeur","count":48},{"language":"ja","tag":"開発者ガイド","count":48},{"language":"ko","tag":"개발자 가이드","count":48},{"language":"tr","tag":"Geliştirici Kılavuzları","count":48},{"language":"en","tag":"Developer Guides","count":47},{"language":"pt-BR","tag":"Guia de desenvolvedor","count":47},{"language":"en","tag":"Integrations","count":37},{"language":"es","tag":"Integraciones","count":37},{"language":"fr","tag":"Intégrations","count":37},{"language":"ja","tag":"統合","count":37},{"language":"ko","tag":"통합","count":37},{"language":"pt-BR","tag":"Integrações","count":37},{"language":"tr","tag":"Entegrasyonlar","count":37},{"language":"cn","tag":"集成","count":36},{"language":"en","tag":"Tutorials","count":35},{"language":"cn","tag":"推送通知","count":31},{"language":"cn","tag":"OneSignal 作为目的地","count":31},{"language":"en","tag":"Push","count":31},{"language":"en","tag":"OneSignal as destination","count":31},{"language":"es","tag":"Push notificaciones","count":31},{"language":"es","tag":"OneSignal como destino","count":31},{"language":"fr","tag":"Push","count":31},{"language":"fr","tag":"OneSignal comme destination","count":31},{"language":"ja","tag":"プッシュ通知","count":31},{"language":"ja","tag":"OneSignal as 宛先","count":31},{"language":"ko","tag":"푸시","count":31},{"language":"ko","tag":"OneSignal을 데이터 목적지로 사용","count":31},{"language":"pt-BR","tag":"Push notificações","count":31},{"language":"pt-BR","tag":"OneSignal como destino","count":31},{"language":"tr","tag":"Anlık bildirimler","count":31},{"language":"tr","tag":"OneSignal hedef","count":31},{"language":"en","tag":"Mobile SDKs","count":26},{"language":"cn","tag":"移动SDK","count":25},{"language":"es","tag":"SDKs móviles","count":25},{"language":"fr","tag":"SDK mobiles","count":25},{"language":"ja","tag":"モバイルSDK","count":25},{"language":"ko","tag":"모바일 SDKs","count":25},{"language":"pt-BR","tag":"SDKs móveis","count":25},{"language":"tr","tag":"Mobil SDK'lar","count":25},{"language":"cn","tag":"教程","count":24},{"language":"es","tag":"Tutoriales","count":24},{"language":"fr","tag":"Tutoriels","count":24},{"language":"ja","tag":"チュートリアル","count":24},{"language":"ko","tag":"튜토리얼","count":24},{"language":"pt-BR","tag":"Tutoriais","count":24},{"language":"tr","tag":"Eğitimler","count":24},{"language":"en","tag":"Mobile SDK setup","count":19},{"language":"cn","tag":"移动SDK设置","count":18},{"language":"es","tag":"Configuración del SDK móvil","count":18},{"language":"fr","tag":"Configuration SDK mobile","count":18},{"language":"ja","tag":"モバイルSDKセットアップ","count":18},{"language":"ko","tag":"모바일 SDK 설정","count":18},{"language":"pt-BR","tag":"Configuração do SDK móvel","count":18},{"language":"tr","tag":"Mobil SDK kurulumu","count":18},{"language":"default","tag":"Messages","count":9},{"language":"default","tag":"Users","count":9},{"language":"default","tag":"Organization","count":9},{"language":"default","tag":"Journeys","count":8},{"language":"default","tag":"Deprecated","count":6},{"language":"default","tag":"Templates","count":6},{"language":"default","tag":"Subscriptions","count":6},{"language":"default","tag":"Segments","count":5}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@onesignal.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/ko/import","slug":"/docs/ko/import","pageMetadata":{"title":"가져오기","description":"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.","keywords":["import","csv","upload","bulk","tags","migrate","bulk tag updates"],"href":"/docs/ko/import"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,Check,CodeBlock,Frame,Heading,Note,OptimizedImage,ParamField,Step,Steps,Tab,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`CSV 파일 또는 수동 입력을 통해 OneSignal 대시보드에서 사용자를 일괄 가져오기하거나 업데이트합니다. 일반적인 사용 사례로는 다른 플랫폼에서 사용자 마이그레이션, 사용자 세부 정보 업데이트, `,_jsx(_components.a,{href:`/docs/ko/add-user-data-tags`,children:`태그`}),`와 `,_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세그먼트`}),`를 사용한 사용자 구성 등이 있습니다.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/reference/create-user`,children:`REST API`}),`를 통해 사용자를 업데이트하거나 생성할 수도 있습니다.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`csv-가져오기`,children:`CSV 가져오기`}),`\n`,_jsxs(_components.p,{children:[`CSV 파일을 사용하여 이메일 주소, 전화번호, 외부 ID, `,_jsx(_components.a,{href:`/docs/ko/add-user-data-tags`,children:`태그`}),`, 언어, 시간대, 국가 등을 가져오거나 업데이트합니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`csv-요구사항`,children:`CSV 요구사항`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`.csv`}),` 파일이 다음 요구사항을 충족하는지 확인하세요:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`UTF-8 인코딩 (BOM 제외)`}),`\n`,_jsx(_components.li,{children:`인쇄할 수 없는 문자 없음 (특수 문자 또는 비 ASCII 문자 없음)`}),`\n`,_jsx(_components.li,{children:`깔끔하고 고유한 열 헤더`}),`\n`,_jsx(_components.li,{children:`150MB 미만의 파일 크기 (약 200만 행)`}),`\n`,_jsxs(_components.li,{children:[`다음 중 하나 이상의 식별자:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`external_id`}),` — 권장. 모든 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`에서 `,_jsx(_components.a,{href:`/docs/ko/users`,children:`사용자`}),`를 식별합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`email`}),` — 새 이메일 구독 생성에 필요합니다. 자세한 내용은 `,_jsx(_components.a,{href:`/docs/ko/email-address-validation`,children:`이메일 주소 유효성 검사`}),`를 참조하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`phone_number`}),` — 새 SMS 구독 생성에 필요합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`subscription_id`}),` — 백엔드에서 OneSignal `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독 ID`}),`를 이미 추적하고 `,_jsx(_components.code,{children:`external_id`}),`를 설정하려는 경우에만 권장됩니다.`]}),`\n`]}),`\n`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`각 유형의 식별자는 행당 하나만 허용됩니다. 동일한 사용자와 여러 이메일 또는 번호를 연결하려면 동일한 `,_jsx(_components.code,{children:`external_id`}),`를 공유하는 별도의 행을 사용하세요.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`사용자를 중복 제거하려면 `,_jsx(_components.code,{children:`external_id`}),`를 포함하세요. SDK `,_jsx(_components.code,{children:`login`}),` 메서드에서 사용하는 ID와 일치하는지 확인하세요 — 그렇지 않으면 사용자가 앱을 열 때 재설정됩니다.`]}),`\n`,_jsxs(_components.li,{children:[`구독 상태를 변경하려면 행에 `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`phone_number`}),` 또는 `,_jsx(_components.code,{children:`subscription_id`}),`가 포함되어야 합니다. `,_jsx(_components.code,{children:`external_id`}),`만으로는 충분하지 않습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`subscription_id`}),`는 구독을 연결하거나 병합하지 않습니다. 기존 사용자에게 새 이메일 또는 전화번호를 추가하려면 `,_jsx(_components.code,{children:`external_id`}),`를 사용하세요.`]}),`\n`]})}),`\n`,_jsx(Heading,{level:`3`,id:`사용-가능한-csv-열`,children:`사용 가능한 CSV 열`}),`\n`,_jsx(ParamField,{path:`external_id`,type:`고유한 영숫자 값`,id:`param-external-id`,children:_jsxs(_components.p,{children:[`자세한 내용은 `,_jsx(_components.a,{href:`/docs/ko/users#external-id`,children:`외부 ID`}),`를 참조하세요.`]})}),`\n`,_jsx(ParamField,{path:`email`,type:`유효한 이메일 주소`,id:`param-email`,children:_jsxs(_components.p,{children:[`이메일 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`을 생성합니다. 이미 존재하는 경우 중복 제거됩니다.`]})}),`\n`,_jsx(ParamField,{path:`phone_number`,type:`유효한 전화번호`,id:`param-phone-number`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`+15555551234`}),`와 같은 `,_jsx(_components.a,{href:`https://en.wikipedia.org/wiki/E.164`,children:`E.164 형식`}),`을 사용합니다. SMS `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`을 생성합니다.`]})}),`\n`,_jsx(ParamField,{path:`subscription_id`,type:`OneSignal에서 할당한 UUID v4`,id:`param-subscription-id`,children:_jsxs(_components.p,{children:[`백엔드에서 이미 OneSignal `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독 ID`}),`를 추적하는 경우에만 권장됩니다.`]})}),`\n`,_jsx(ParamField,{path:`subscribed`,type:\"`yes`, `no`\",id:`param-subscribed`,children:_jsxs(_components.p,{children:[`구독 상태를 설정합니다. 행에 `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`phone_number`}),` 또는 `,_jsx(_components.code,{children:`subscription_id`}),`가 필요합니다 — `,_jsx(_components.code,{children:`external_id`}),`만으로는 사용할 수 없습니다.`]})}),`\n`,_jsx(ParamField,{path:`suppressed`,type:\"`true`, `false`\",id:`param-suppressed`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`false`}),`는 차단 목록에서 이메일을 제거합니다.`]})}),`\n`,_jsx(ParamField,{path:`timezone_id`,type:`IANA TZ 형식의 시간대`,id:`param-timezone-id`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://en.wikipedia.org/wiki/List_of_tz_database_time_zones`,children:`IANA TZ`}),`를 참조하세요.`]})}),`\n`,_jsx(ParamField,{path:`country`,type:`2자 ISO 3166-2 코드`,id:`param-country`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.iso.org/obp/ui/`,children:`ISO 3166-2`}),`를 참조하세요.`]})}),`\n`,_jsx(ParamField,{path:`language`,type:`2자 ISO 639-1 코드`,id:`param-language`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/multi-language-messaging#supported-languages`,children:`ISO 639-1`}),`을 참조하세요.`]})}),`\n`,_jsx(ParamField,{path:`Tags`,type:`영숫자 값`,id:`param-tags`,children:_jsxs(_components.p,{children:[`최대 1,000개의 태그. 열 헤더를 키로 사용합니다. `,_jsx(_components.a,{href:`/docs/ko/add-user-data-tags`,children:`태그`}),`를 참조하세요.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`태그-한도-및-제한`,children:`태그 한도 및 제한`}),`\n`,_jsxs(_components.p,{children:[`태그 `,_jsx(_components.a,{href:`https://onesignal.com/pricing`,children:`요금제 한도`}),`는 앱이 아닌 사용자별로 적용됩니다. 예를 들어, 요금제에서 사용자당 태그 20개가 허용되고 사용자가 이미 19개를 가지고 있다면, 앱 자체에 무제한 태그 키를 가질 수 있더라도 1개만 더 추가할 수 있습니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`#bulk-tag-updates`,children:`일괄 태그 업데이트`}),` 워크플로를 사용하여 사용자를 내보내고, 원하지 않는 태그 값을 지우고, 삭제 옵션을 활성화하여 다시 가져옵니다.`]}),`\n`,_jsx(_components.li,{children:`태그 키에 공백을 사용하지 마세요 — 대신 밑줄을 사용하세요.`}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`예약 및 제한된 태그 키`})}),`\n`,_jsx(_components.p,{children:`다음 태그 키는 예약되어 있으므로 사용하지 않아야 합니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`“user”`}),`\n`,_jsx(_components.li,{children:`“subscription”`}),`\n`,_jsx(_components.li,{children:`“message”`}),`\n`,_jsx(_components.li,{children:`“template”`}),`\n`,_jsx(_components.li,{children:`“app”`}),`\n`,_jsx(_components.li,{children:`“org”`}),`\n`,_jsx(_components.li,{children:`“custom_data”`}),`\n`,_jsx(_components.li,{children:`“dynamic_content”`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`이 중 하나를 태그 키로 실수로 설정한 경우 `,_jsx(_components.a,{href:`/reference/update-user`,children:`사용자 업데이트 API`}),`를 통해 제거하세요.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`태그 덮어쓰기 및 삭제`})}),`\n`,_jsx(_components.p,{children:`CSV 가져오기 중:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`CSV에 포함된 태그는 제공된 값으로 덮어씁니다.`}),`\n`,_jsx(_components.li,{children:`CSV에 포함되지 않은 태그는 사용자 레코드에서 변경되지 않습니다.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`가져오기 후에도 태그가 남아 있으면 다음을 확인하세요:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`헤더 열에 태그 키가 포함되어 있는지.`}),`\n`,_jsx(_components.li,{children:`행에 값이 없는지.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`#review-and-confirm`,children:`검토 화면`}),`에서 “빈 값이 있는 태그 삭제” 옵션을 선택했는지.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`다른 소스에서 추가되는 태그`})}),`\n`,_jsx(_components.p,{children:`삭제된 태그가 가져오기 후 다시 나타나면 연동이 자동으로 다시 쓰고 있을 수 있습니다. 일반적인 소스는 다음과 같습니다:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Segment`}),`\n`,_jsx(_components.li,{children:`HubSpot`}),`\n`,_jsx(_components.li,{children:`Journeys`}),`\n`,_jsx(_components.li,{children:`SDK 태깅 방법`}),`\n`,_jsx(_components.li,{children:`맞춤 API 또는 ETL 파이프라인`}),`\n`]}),`\n`,_jsx(_components.p,{children:`연동 매핑 및 이벤트 트리거를 검토하여 CSV 변경 사항을 덮어쓰지 않는지 확인하세요.`}),`\n`,_jsx(Heading,{level:`4`,id:`단일-열에서-태그-가져오기`,children:`단일 열에서 태그 가져오기`}),`\n`,_jsxs(_components.p,{children:[`각 태그 키에 대해 별도의 열 헤더를 사용하는 대신 단일 `,_jsx(_components.code,{children:`tags`}),` 헤더를 설정할 수 있으며, 각 사용자 행에는 따옴표 안에 모든 키-값 쌍의 JSON 맵이 포함됩니다. 이는 이전에 태그가 포함된 CSV를 내보내고 다시 포맷하지 않고 다시 가져오려는 경우 특히 유용합니다.`]}),`\n`,_jsx(_components.p,{children:`예제 헤더:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`csv`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`csv`,children:_jsxs(_components.code,{language:`csv`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`external_id,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`email,`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`tags`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`예제 행:\n태그는 따옴표로 묶인 JSON 객체로 포맷되어야 합니다.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`csv`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`csv`,children:_jsxs(_components.code,{language:`csv`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`userA,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`example@email.com,`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`\"{\"\"level\"\":\"\"30\"\",\"\"Color\"\":\"\"teal\"\"}\"`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`가져오면 OneSignal은 각 키-값 쌍을 구독 레코드의 고유한 태그로 자동 변환합니다.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`예시: 태그 일괄 삭제`})}),`\n`,_jsx(_components.p,{children:`태그를 일괄 삭제하려면 현재 데이터를 내보내고, 태그 값을 비워두고, 삭제 옵션을 활성화하여 CSV를 다시 가져옵니다.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`데이터 내보내기`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`OneSignal 대시보드에서 `,_jsx(_components.strong,{children:`Audience > Subscriptions`}),`으로 이동합니다. `,_jsx(_components.strong,{children:`External ID`}),`, `,_jsx(_components.strong,{children:`Subscription ID`}),`, `,_jsx(_components.strong,{children:`Tags`}),` 열만 활성화합니다(선택적으로 `,_jsx(_components.strong,{children:`Email`}),` 또는 `,_jsx(_components.strong,{children:`Phone Number`}),`도 가능).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Export`}),`를 클릭하여 CSV를 내보냅니다.`]}),`\n`]}),_jsx(Frame,{caption:`내보내기를 위한 표시 가능한 열 선택`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=bd8b42aeeff64d1be1e24b6f1ada1aeb`,alt:`내보내기를 위한 표시 가능한 열 선택`,\"data-og-width\":`1854`,width:`1854`,\"data-og-height\":`996`,height:`996`,\"data-path\":`images/dashboard/audience-displayable-columns.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?w=280\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=245901192aba970d3421fb2d64273ced 280w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?w=560\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=71b5fa8ddad014ead2f755f1dba930d6 560w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?w=840\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=2e758e44094b5161be925b1089e16e00 840w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=c05ae5a1c71416e8fa4de3805244cd77 1100w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=9a0cab4ddccba797e3af311370a65c83 1650w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-displayable-columns.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=d96e961c8b35f282015be10f4387a3ac 2500w`})})]}),_jsxs(Step,{title:`삭제할 태그 값 지우기`,children:[_jsx(_components.p,{children:`내보낸 CSV를 텍스트 편집기에서 열고 삭제할 각 태그의 값을 빈 문자열로 설정합니다.`}),_jsx(_components.p,{children:`예를 들어, 편집 전 태그 값이 있는 행:`}),_jsx(CodeBlock,{filename:`편집 전 행`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`userA,example@email.com,\"{\"\"level\"\":\"\"30\"\",\"\"color\"\":\"\"teal\"\"}\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`태그 값을 지운 후 동일한 행:`}),_jsx(CodeBlock,{filename:`태그 값 지운 후 행`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`userA,example@email.com,\"{\"\"level\"\":\"\"\"\",\"\"color\"\":\"\"\"\"}\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`이렇게 하면 사용자에서 태그 `,_jsx(_components.code,{children:`level`}),`과 `,_jsx(_components.code,{children:`color`}),`가 삭제됩니다.`]})]}),_jsxs(Step,{title:`삭제 옵션을 사용하여 CSV 다시 가져오기`,children:[_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`편집된 CSV를 가져옵니다.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`#%EA%B2%80%ED%86%A0-%EB%B0%8F-%ED%99%95%EC%9D%B8`,children:`검토`}),` 화면에서 `,_jsx(_components.strong,{children:`빈 값의 태그 삭제`}),`에 대해 `,_jsx(_components.strong,{children:`예`}),`를 선택합니다. OneSignal이 가져오기 중에 빈 값의 태그를 삭제합니다.`]}),`\n`]}),_jsx(Frame,{caption:`빈 값의 태그 삭제 옵션이 있는 검토 화면`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=8cca408cf4ebf889dfbf67359ae7fdc9`,alt:`빈 값의 태그 삭제 옵션이 있는 검토 화면`,\"data-og-width\":`2316`,width:`2316`,\"data-og-height\":`1122`,height:`1122`,\"data-path\":`images/dashboard/audience-import-review-remove-tags-with-empty-values.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?w=280\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=81f018ba52f24db3fbf912126253e37d 280w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?w=560\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=4b30974e38c91c8b1029e28b2f45a159 560w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?w=840\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=0ba3ba91e12b5f7e47bed2c4540337b8 840w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=b2c9ddbcda8888bfcce5df10601a2fff 1100w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=201b39c986a1f6b3a23abb61087a1524 1650w, https://mintcdn.com/onesignal/V_t1Yu0NBNBFj-6D/images/dashboard/audience-import-review-remove-tags-with-empty-values.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V_t1Yu0NBNBFj-6D\u0026q=85\u0026s=7eae0d5bee3425728039b6981b49b05e 2500w`})})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`특정 태그만 삭제하려면 해당 태그의 값을 지우고 나머지는 변경하지 않습니다. 삭제 옵션이 활성화된 경우에는 빈 값만 삭제됩니다.`})}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`도움이 필요하십니까?`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`위의 `,_jsx(_components.a,{href:`#use-ai-to-check-your-csv-before-import`,children:`가져오기 전에 AI를 사용하여 CSV 확인`}),` 섹션을 시도하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`support@onesignal.com`}),`에 문의하여 업로드한 CSV 파일과 확인 이메일의 스크린샷을 공유하세요. 기꺼이 살펴보겠습니다!`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`4`,id:`이메일-주소-유효성-검사`,children:`이메일 주소 유효성 검사`}),`\n`,_jsx(_components.p,{children:`이메일 주소 유효성 검사는 이메일이 수신자에게 도달하기 전에 이메일 주소의 일반적인 문제를 감지합니다. 반송률을 높이거나 발신자 평판을 손상시킬 수 있는 오타, 잘못된 도메인, 역할 기반 주소 및 일회용 이메일 서비스를 표시합니다.`}),`\n`,_jsx(Card,{title:`이메일 주소 유효성 검사`,icon:`circle-check`,href:`/docs/ko/email-address-validation`,children:_jsx(_components.p,{children:`CSV 가져오기 중 및 일괄적으로 이메일 주소를 검증하여 반송을 줄이고 발신자 평판을 보호하세요.`})}),`\n`,_jsx(Heading,{level:`4`,id:`가져오기-전에-ai를-사용하여-csv-확인`,children:`가져오기 전에 AI를 사용하여 CSV 확인`}),`\n`,_jsx(_components.p,{children:`CSV 형식에 오류나 질문이 있는 경우 AI 도구(Claude, ChatGPT 등)에 CSV 문제를 설명하여 다시 가져오기 전에 파일을 자동으로 정리하거나 재구성할 수 있습니다.`}),`\n`,_jsx(Warning,{children:`수천 개의 레코드를 가져오기 전에 항상 작은 샘플(5-10행)로 테스트하세요.`}),`\n`,_jsx(Accordion,{title:`일반적인 CSV 문제에 대한 AI 프롬프트 예제`,id:`csv-ai`,children:_jsxs(Tabs,{children:[_jsx(Tab,{title:`태그 삭제`,id:`%ED%83%9C%EA%B7%B8-%EC%82%AD%EC%A0%9C`,children:_jsx(CodeBlock,{filename:`원하지 않는 태그를 삭제하기 위한 AI 프롬프트 예제`,numberOfLines:`12`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`이 CSV에서 \"user_name\"을 제외한 모든 태그를 제거하고 싶습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`다음을 수행해 주세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1. \"user_name\" 태그 열만 유지하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2. 다른 모든 태그 열을 제거하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`3. 이 문서의 OneSignal 가져오기 요구 사항과 일치하도록 CSV를 형식화하세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` https://documentation.onesignal.com/docs/en/import`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`제 CSV입니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[CSV 붙여넣기]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`태그 형식`,id:`%ED%83%9C%EA%B7%B8-%ED%98%95%EC%8B%9D`,children:_jsx(CodeBlock,{filename:`여러 태그 열 형식을 수정하기 위한 AI 프롬프트 예제`,numberOfLines:`13`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`tag_first_name, tag_last_name, tag_city와 같은 여러 태그 열이 있습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`OneSignal 가져오기 문서에 따르면 각 태그는 다음을 충족해야 합니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- tag_ 접두사 사용`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 영숫자 문자와 밑줄만 포함`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- 지원되는 데이터 유형 따르기`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`내 CSV를 검토하고 잘못 형식화된 항목을 식별하고 이러한 요구 사항을 충족하는 수정된 버전을 반환할 수 있습니까?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`문서 링크:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://documentation.onesignal.com/docs/en/import`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`유효하지 않은 형식 식별`,id:`%EC%9C%A0%ED%9A%A8%ED%95%98%EC%A7%80-%EC%95%8A%EC%9D%80-%ED%98%95%EC%8B%9D-%EC%8B%9D%EB%B3%84`,children:_jsx(CodeBlock,{filename:`누락되거나 유효하지 않은 형식을 식별하기 위한 AI 프롬프트 예제`,numberOfLines:`12`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`OneSignal이 가져오기 중에 내 CSV를 거부했습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`다음을 수행해 주세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1. CSV 구조를 확인하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2. 형식 문제(헤더, ID 열, 태그 형식, 인용 부호)를 식별하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`3. 이 문서의 요구 사항을 따르는 수정된 버전을 반환하세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` https://documentation.onesignal.com/docs/en/import#prepare-your-csv`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`파일은 다음과 같습니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[CSV 붙여넣기]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`전화번호 수정`,id:`%EC%A0%84%ED%99%94%EB%B2%88%ED%98%B8-%EC%88%98%EC%A0%95`,children:_jsx(CodeBlock,{filename:`유효하지 않은 전화번호 형식(E.164)을 수정하기 위한 AI 프롬프트 예제`,numberOfLines:`14`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`전화번호가 E.164 형식이 아니어서 가져오기가 실패합니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`다음을 수행해 주세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1. 모든 전화번호를 E.164 형식으로 변환하세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2. 다른 모든 필드는 변경하지 마세요.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`3. CSV가 OneSignal의 필수 구조와 일치하는지 확인하세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` https://documentation.onesignal.com/docs/en/import`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`현재 형식 예제: (555) 555-1234`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`제 CSV입니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[CSV 붙여넣기]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),_jsx(Tab,{title:`다른 플랫폼에서 마이그레이션`,id:`%EB%8B%A4%EB%A5%B8-%ED%94%8C%EB%9E%AB%ED%8F%BC%EC%97%90%EC%84%9C-%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98`,children:_jsx(CodeBlock,{filename:`다른 플랫폼에서 마이그레이션하기 위한 AI 프롬프트 예제`,numberOfLines:`15`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[플랫폼 이름]에서 OneSignal로 마이그레이션하고 있습니다.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`이 CSV를 OneSignal의 가져오기 형식에 맞게 변환할 수 있습니까?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`다음을 포함하세요:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:\"- `external_id`\"})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:\"- `tag_` 접두사로 변환된 모든 태그(원하는 경우)\"})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- E.164 형식의 전화번호(해당하는 경우)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`참조 문서:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://documentation.onesignal.com/docs/en/import`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`제 CSV입니다:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`[CSV 붙여넣기]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})})]})}),`\n`,_jsx(Heading,{level:`3`,id:`가져오기-단계`,children:`가져오기 단계`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`오디언스 > 가져오기`}),`로 이동하고 `,_jsx(_components.strong,{children:`CSV 가져오기 도구 시작`}),`을 클릭합니다.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`CSV 업로드`,children:[_jsx(_components.p,{children:`준비된 CSV 파일을 선택합니다.`}),_jsx(Frame,{caption:`CSV 가져오기 화면`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=34465e4a19791b38f1edaef4239d7e89`,alt:`OneSignal 대시보드의 CSV 파일 업로드 화면`,\"data-og-width\":`2230`,width:`2230`,\"data-og-height\":`1242`,height:`1242`,\"data-path\":`images/dashboard/audience-import-csv.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=00d91fc8ca3a74805ff79cda19a5ec3e 280w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=5266b8cf9dd3e03dcedfae356d1add3d 560w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=a3d1ce1d9a3468856af0f3ab248363a5 840w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=f1196e3fdde1aa6893f4a52722d4dd74 1100w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=5dfb82ec4017dd577e3d50575290a877 1650w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-csv.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=7aad27244fefcfb199ed462657cf5cbf 2500w`})})]}),_jsxs(Step,{title:`필드 매핑`,children:[_jsxs(_components.p,{children:[`OneSignal은 CSV 헤더를 알려진 속성에 자동으로 매핑합니다. 확인하기 전에 매핑을 검토하세요 — `,_jsx(_components.code,{children:`external_id`}),`, `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`phone_number`}),`, 및/또는 `,_jsx(_components.code,{children:`subscription_id`}),`를 태그가 아닌 `,_jsx(_components.strong,{children:`식별자`}),`로 사용하세요.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`기존 사용자에게 새 이메일 또는 전화번호를 추가하려면 `,_jsx(_components.code,{children:`external_id`}),`를 `,_jsx(_components.strong,{children:`반드시 사용`}),`해야 합니다. `,_jsx(_components.code,{children:`subscription_id`}),`를 사용하지 `,_jsx(_components.strong,{children:`마세요`}),` — 구독을 연결하거나 병합하지 않습니다.`]})}),_jsx(Frame,{caption:`CSV 가져오기 필드 매핑 화면`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=f560f16f8bb3a8d93012c311e0edeb11`,alt:`OneSignal 속성에 매핑된 열 헤더를 보여주는 필드 매핑 화면`,\"data-og-width\":`2190`,width:`2190`,\"data-og-height\":`1242`,height:`1242`,\"data-path\":`images/dashboard/audience-import-map-fields.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=b40124eb19900838e006fa91a0663bd2 280w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=5494f148dcb44025e2b28040cd36e6d2 560w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=85ceda0ed3ee1ec7fa0e9a151f859984 840w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=f96eb62ad0f79da5427e3244e4cdc952 1100w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=cdb977762f99cea1ce85b730ddd97b1b 1650w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-map-fields.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=c1c8a9c609318f68f625963629eda2ed 2500w`})}),_jsx(_components.p,{children:`OneSignal이 형식 문제를 감지하면 CSV를 수정하고 다시 업로드하거나(권장) 영향을 받는 열을 선택 해제하여 건너뜁니다.`})]}),_jsxs(Step,{title:`검토 및 확인`,children:[_jsx(_components.p,{children:`검토 화면에서 다음을 수행할 수 있습니다:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`세그먼트 자동 생성`}),` — 가져온 각 사용자에게 태그를 추가하고 일치하는 `,_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세그먼트`}),`를 생성합니다. `,_jsx(_components.a,{href:`https://onesignal.com/pricing`,children:`플랜 제한`}),`에 주의하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`빈 값의 태그 삭제`}),` — CSV에서 값이 비어 있는 태그를 삭제합니다. 원하지 않는 태그를 정리하고 플랜 제한 내에서 유지하는 데 유용합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`이메일 주소 유효성 검사 구성`}),` — `,_jsx(_components.a,{href:`/docs/ko/email-address-validation`,children:`이메일 주소 유효성 검사`}),` 설정을 구성하여 반송을 줄이고 발신자 평판을 보호하세요.`]}),`\n`]}),_jsx(_components.p,{children:`예를 들어, 다음 CSV를 사용한 경우:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`csv`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`csv`,children:_jsxs(_components.code,{language:`csv`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`external_id,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`tag1,`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`tag2`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`UserA,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`,`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`\"tag2value\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`UserB,`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`\"tag1value\",`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`“빈 값의 태그 삭제” 옵션을 활성화하면 UserA에서 `,_jsx(_components.code,{children:`tag1`}),`이, UserB에서 `,_jsx(_components.code,{children:`tag2`}),`가 삭제됩니다.`]}),_jsx(Frame,{caption:`CSV 가져오기 검토 화면`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=cf54490a35d4562380cd30baa03ee143`,alt:`세그먼트 생성 및 빈 태그 값 삭제 옵션을 보여주는 검토 화면`,\"data-og-width\":`2212`,width:`2212`,\"data-og-height\":`1242`,height:`1242`,\"data-path\":`images/dashboard/audience-import-review.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=70a84d18551d0541981eb2e8da8cc983 280w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=5181ec123eb641d1e5c5eef715e2b900 560w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=d159d13db4132ed7817c7ed679371775 840w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=1a9e06946670af7e55df7093c9614852 1100w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=52108440a34cf691dd489c3267c82360 1650w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-review.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=5dc4a90d90c3b00b6725bbdfd8ccd89a 2500w`})}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`확인 및 가져오기`}),`를 클릭합니다. 상태 화면에 진행 상황이 표시됩니다.`]})]})]}),`\n`,_jsx(Check,{children:_jsxs(_components.p,{children:[`가져오기가 시작되었습니다. 완료되면 `,_jsx(_components.code,{children:`contact@onesignal.com`}),`으로부터 확인 이메일을 받게 됩니다.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`이메일-확인`,children:`이메일 확인`}),`\n`,_jsxs(_components.p,{children:[`가져오기가 완료되면 `,_jsx(_components.code,{children:`contact@onesignal.com`}),`으로부터 확인 이메일을 받게 됩니다. 단일 `,_jsx(_components.a,{href:`/docs/ko/users`,children:`사용자`}),`가 여러 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`（예: 이메일 + 푸시）을 가질 수 있으므로 구독 수가 행 수보다 많을 수 있습니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`추가된 구독 레코드`}),` — 새로 생성된 이메일 또는 SMS `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`. `,_jsx(_components.code,{children:`0`}),`은 고유한 `,_jsx(_components.code,{children:`email`}),` 또는 `,_jsx(_components.code,{children:`phone_number`}),` 식별자가 없었음을 의미합니다.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`수정된 구독 레코드`}),` — 데이터가 변경된 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`（태그, 속성 등）. 예: 10개의 외부 ID 각각이 20개의 구독과 연결된 경우 = `,_jsx(_components.code,{children:`200`}),`개의 레코드 수정.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`건너뛴 구독 업데이트`}),` — 명시된 이유로 건너뛴 `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`. 이유가 “앱의 태그 제한 초과”인 경우 태그를 제거하고 다시 가져오거나 플랜을 업그레이드하세요.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`가져오지 않음`}),` — 업데이트되거나 가져오지 않은 행. 일반적인 원인: `,_jsx(_components.code,{children:`external_id`}),`가 기존 구독과 일치하지 않거나 `,_jsx(_components.code,{children:`email`}),`/`,_jsx(_components.code,{children:`phone_number`}),`가 이미 존재하며 설정할 새 데이터가 없는 경우.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`생성된 새 세그먼트`}),` — 해당 옵션을 선택한 경우의 세그먼트 이름.`]}),`\n`,_jsx(Frame,{caption:`이메일 확인 예제.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=13bf4c01e085ca95e890683d280e8691`,alt:`추가, 수정, 건너뜀, 가져오지 않음 구독 수를 보여주는 이메일 확인`,\"data-og-width\":`639`,width:`639`,\"data-og-height\":`558`,height:`558`,\"data-path\":`images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?w=280\u0026fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=6033cfc2ae729b43acb9f853eda4eda1 280w, https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?w=560\u0026fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=5b7683681cfbacf9200d3e1309898953 560w, https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?w=840\u0026fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=7133cf97dd319d673c29b0330aa7ccdc 840w, https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?w=1100\u0026fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=8573cbd32a6d653a0075985731e054f6 1100w, https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?w=1650\u0026fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=66d5e5ae4c2b5b01355f65e900736d11 1650w, https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0e25f863a4e6728ade07eae4d3f69ee4b42acd3e44e940035d8278d1e24a5882-Screenshot_2025-04-25_at_10.25.05_AM.png?w=2500\u0026fit=max\u0026auto=format\u0026n=6v_cVPknFpo5qSVB\u0026q=85\u0026s=dc90ea71b195e42aae247b9594f17a0a 2500w`})}),`\n`,_jsx(_components.p,{children:`위의 예에서:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`앱에 존재하지 않는 고유한 이메일 주소 또는 전화번호에서 `,_jsx(_components.code,{children:`100`}),`개의 구독이 생성되었습니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`37,814`}),`개의 구독이 업데이트되었습니다（사용자 수가 아님 — 각 사용자는 여러 구독을 가질 수 있습니다）.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`621,852`}),`개 행이 가져오지 않았습니다. 외부 ID가 기존 사용자와 일치하지 않거나 이메일/전화번호가 이미 존재하며 새 데이터가 없었기 때문입니다.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세그먼트`}),`는 `,_jsx(_components.strong,{children:`구독된`}),` `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`만 계산합니다. 구독 취소된 구독은 가져오기로 업데이트되지만 세그먼트 수에는 반영되지 않습니다. 세그멘테이션 개선이 진행 중입니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`수동-입력`,children:`수동 입력`}),`\n`,_jsxs(_components.p,{children:[`OneSignal 대시보드를 통해 `,_jsx(_components.strong,{children:`오디언스 > 사용자 > 사용자 업데이트/가져오기 > 수동으로 사용자 추가`}),`로 이동하여 사용자의 이메일 및 전화번호 구독을 수동으로 추가할 수 있습니다.`]}),`\n`,_jsx(Frame,{caption:`수동으로 사용자 추가 화면`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=80cd5bf606f7e1e5c2ff95ece0620c63`,\"data-og-width\":`2186`,width:`2186`,\"data-og-height\":`1242`,height:`1242`,\"data-path\":`images/dashboard/audience-import-manual.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=c13f0da071d1b85887bbd7e9e18d1632 280w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=b5f8f935084d59e918cf87509c873d3f 560w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=d45480c37ce3c794e7fce48f0b5bab5a 840w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=9e9c3b20326ee06e8135ccd23016b7c4 1100w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=d8085d8bfbc2b77b123bf6be1c69ce72 1650w, https://mintcdn.com/onesignal/ZiYMeMG9Jy-RGXDM/images/dashboard/audience-import-manual.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZiYMeMG9Jy-RGXDM\u0026q=85\u0026s=83d4ea3280636ec91947c0dc478f0434 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`새 사용자`}),` 화면에서 원하는 데이터를 포함하고 `,_jsx(_components.strong,{children:`사용자 생성`}),`을 선택합니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`자주-묻는-질문`,children:`자주 묻는 질문`}),`\n`,_jsx(Heading,{level:`3`,id:`csv-가져오기는-얼마나-걸립니까`,children:`CSV 가져오기는 얼마나 걸립니까?`}),`\n`,_jsxs(_components.p,{children:[`소요 시간은 파일 크기에 따라 다릅니다. 대부분의 가져오기는 몇 분 내에 완료됩니다. 가져오기가 완료되면 `,_jsx(_components.code,{children:`contact@onesignal.com`}),`에서 이메일을 받습니다 — 해당 주소를 연락처에 추가하여 이메일을 확실히 받을 수 있도록 하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`csv-가져오기를-취소할-수-있습니까`,children:`CSV 가져오기를 취소할 수 있습니까?`}),`\n`,_jsxs(_components.p,{children:[`아니요. CSV 가져오기에는 내장된 실행 취소 기능이 없습니다. 변경 사항을 되돌려야 하는 경우 올바른 값으로 새 CSV를 준비하여 다시 가져오세요. 태그 삭제의 경우 `,_jsx(_components.a,{href:`#%EC%98%88%EC%8B%9C-%ED%83%9C%EA%B7%B8-%EC%9D%BC%EA%B4%84-%EC%82%AD%EC%A0%9C`,children:`태그 일괄 삭제`}),` 워크플로우를 사용하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`가져오기가-구독-상태에-어떤-영향을-미칩니까`,children:`가져오기가 구독 상태에 어떤 영향을 미칩니까?`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`subscribed`}),` 열이 구독 상태를 제어합니다. 같은 행에 `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`phone_number`}),` 또는 `,_jsx(_components.code,{children:`subscription_id`}),`가 있어야 합니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`새 이메일 또는 전화번호, `,_jsx(_components.code,{children:`subscribed`}),` 열 없음`]}),`: OneSignal이 `,_jsx(_components.strong,{children:`구독됨`}),` 상태로 구독을 생성합니다. `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`을 참조하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`기존 이메일 또는 전화번호, `,_jsx(_components.code,{children:`subscribed`}),` 열 없음`]}),`: 현재 구독 상태는 변경되지 않습니다. 가져오기는 제공한 필드만 업데이트합니다.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`subscribed`}),`가 `,_jsx(_components.code,{children:`yes`}),` 또는 `,_jsx(_components.code,{children:`no`}),`로 설정됨`]}),`: 가져오기가 기존 상태를 제공한 값으로 덮어씁니다. 여기에는 현재 구독 취소된 구독을 다시 구독시키거나 현재 구독된 구독을 구독 취소하는 것도 포함됩니다.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`기존 상태를 그대로 유지하려면 CSV에서 `,_jsx(_components.code,{children:`subscribed`}),` 열을 생략하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`세그먼트-수가-csv의-행-수와-일치하지-않는-이유는-무엇입니까`,children:`세그먼트 수가 CSV의 행 수와 일치하지 않는 이유는 무엇입니까?`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/docs/ko/segmentation`,children:`세그먼트`}),`는 `,_jsx(_components.strong,{children:`구독된`}),` `,_jsx(_components.a,{href:`/docs/ko/subscriptions`,children:`구독`}),`의 수만 계산합니다. 구독 취소된 구독은 가져오기로 업데이트되지만 세그먼트 수에는 반영되지 않습니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`일부-행에서-가져오기가-“가져오지-않음”으로-표시되는-이유는-무엇입니까`,children:`일부 행에서 가져오기가 “가져오지 않음”으로 표시되는 이유는 무엇입니까?`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`external_id`}),`가 앱의 기존 구독과 일치하지 않거나, `,_jsx(_components.code,{children:`email`}),` 또는 `,_jsx(_components.code,{children:`phone_number`}),`가 이미 존재하고 설정할 새 데이터가 없을 때 행이 건너뜁니다. 각 상태에 대한 자세한 내용은 `,_jsx(_components.a,{href:`#%EC%9D%B4%EB%A9%94%EC%9D%BC-%ED%99%95%EC%9D%B8-%EB%B0%8F-%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0`,children:`이메일 확인`}),` 섹션을 확인하세요.`]}),`\n`,_jsx(Heading,{level:`3`,id:`삭제된-태그가-계속-돌아오는-이유는-무엇입니까`,children:`삭제된 태그가 계속 돌아오는 이유는 무엇입니까?`}),`\n`,_jsxs(_components.p,{children:[`가져오기 후 통합 또는 SDK 호출이 태그를 다시 추가하고 있을 수 있습니다. 일반적인 소스로는 Segment, HubSpot, Journeys, SDK 태깅 메서드, 사용자 지정 API가 있습니다. `,_jsx(_components.a,{href:`#%ED%83%9C%EA%B7%B8%EA%B0%80-%EC%B6%94%EA%B0%80%EB%90%98%EB%8A%94-%EB%8B%A4%EB%A5%B8-%EC%86%8C%EC%8A%A4`,children:`통합 매핑`}),`과 이벤트 트리거를 검토하세요.`]}),`\n`,_jsx(_components.hr,{})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"가져오기","description":"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.","keywords":["import","csv","upload","bulk","tags","migrate","bulk tag updates"],"href":"/docs/ko/import"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"CSV 가져오기","slug":"csv-가져오기","depth":2,"children":[{"title":"CSV 요구사항","slug":"csv-요구사항","depth":3,"children":[]},{"title":"사용 가능한 CSV 열","slug":"사용-가능한-csv-열","depth":3,"children":[]},{"title":"태그 한도 및 제한","slug":"태그-한도-및-제한","depth":4,"children":[]},{"title":"단일 열에서 태그 가져오기","slug":"단일-열에서-태그-가져오기","depth":4,"children":[]},{"title":"이메일 주소 유효성 검사","slug":"이메일-주소-유효성-검사","depth":4,"children":[]},{"title":"가져오기 전에 AI를 사용하여 CSV 확인","slug":"가져오기-전에-ai를-사용하여-csv-확인","depth":4,"children":[]},{"title":"가져오기 단계","slug":"가져오기-단계","depth":3,"children":[]},{"title":"이메일 확인","slug":"이메일-확인","depth":3,"children":[]}]},{"title":"수동 입력","slug":"수동-입력","depth":2,"children":[]},{"title":"자주 묻는 질문","slug":"자주-묻는-질문","depth":2,"children":[{"title":"CSV 가져오기는 얼마나 걸립니까?","slug":"csv-가져오기는-얼마나-걸립니까","depth":3,"children":[]},{"title":"CSV 가져오기를 취소할 수 있습니까?","slug":"csv-가져오기를-취소할-수-있습니까","depth":3,"children":[]},{"title":"가져오기가 구독 상태에 어떤 영향을 미칩니까?","slug":"가져오기가-구독-상태에-어떤-영향을-미칩니까","depth":3,"children":[]},{"title":"세그먼트 수가 CSV의 행 수와 일치하지 않는 이유는 무엇입니까?","slug":"세그먼트-수가-csv의-행-수와-일치하지-않는-이유는-무엇입니까","depth":3,"children":[]},{"title":"일부 행에서 가져오기가 “가져오지 않음”으로 표시되는 이유는 무엇입니까?","slug":"일부-행에서-가져오기가-“가져오지-않음”으로-표시되는-이유는-무엇입니까","depth":3,"children":[]},{"title":"삭제된 태그가 계속 돌아오는 이유는 무엇입니까?","slug":"삭제된-태그가-계속-돌아오는-이유는-무엇입니까","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/onesignal/e069c1b9f3157e14/hotjar-koala.js","/_mintlify/custom/onesignal/3e5d03885ab32f49/intercom.js","/_mintlify/custom/onesignal/dbb7af4794d1b586/munchkin-marketo.js"],"subdomain":"onesignal","siteName":"OneSignal Documentation","title":"가져오기 - OneSignal Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/en/import","matchLevel":1},"cn":{"href":"/docs/cn/import","matchLevel":1},"ko":{"href":"/docs/ko/import","matchLevel":0},"ja":{"href":"/docs/ja/import","matchLevel":1},"tr":{"href":"/docs/tr/import","matchLevel":1},"pt-BR":{"href":"/docs/pt-BR/import","matchLevel":1},"es":{"href":"/docs/es/import","matchLevel":1},"fr":{"href":"/docs/fr/import","matchLevel":1}}},"lastModified":"2026-08-31T16:35:17.538Z","originalFileLocation":"docs/ko/import.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"가져오기 - OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OneSignal Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.onesignal.com/docs/ko/import\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%EC%98%A4%EB%94%94%EC%96%B8%EC%8A%A4+%26+%EC%82%AC%EC%9A%A9%EC%9E%90+%EC%A7%80%EC%A0%95+%EC%9D%B4%EB%B2%A4%ED%8A%B8\u0026amp;title=%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0\u0026amp;description=CSV+%EC%97%85%EB%A1%9C%EB%93%9C%2C+REST+API+%EB%98%90%EB%8A%94+%EC%88%98%EB%8F%99+%EC%9E%85%EB%A0%A5%EC%9D%84+%EC%82%AC%EC%9A%A9%ED%95%98%EC%97%AC+OneSignal%EC%97%90%EC%84%9C+%EC%82%AC%EC%9A%A9%EC%9E%90%EB%A5%BC+%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B1%B0%EB%82%98+%EC%97%85%EB%8D%B0%EC%9D%B4%ED%8A%B8%ED%95%A9%EB%8B%88%EB%8B%A4.+%EC%9B%90%ED%99%9C%ED%95%9C+%EC%82%AC%EC%9A%A9%EC%9E%90+%EC%98%A8%EB%B3%B4%EB%94%A9+%EB%98%90%EB%8A%94+%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98%EC%9D%84+%EC%9C%84%ED%95%B4+%EC%9D%B4%EB%A9%94%EC%9D%BC%2C+SMS%2C+%ED%83%9C%EA%B7%B8+%EB%93%B1%EC%9D%84+%EC%A7%80%EC%9B%90%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=f4b5a432236e1c4845cde032e698db11e7bbe8f8171eae2fc7120e69687dd178\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"가져오기 - OneSignal Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onesignal.mintlify.site/_mintlify/api/og/v2?division=%EC%98%A4%EB%94%94%EC%96%B8%EC%8A%A4+%26+%EC%82%AC%EC%9A%A9%EC%9E%90+%EC%A7%80%EC%A0%95+%EC%9D%B4%EB%B2%A4%ED%8A%B8\u0026amp;title=%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0\u0026amp;description=CSV+%EC%97%85%EB%A1%9C%EB%93%9C%2C+REST+API+%EB%98%90%EB%8A%94+%EC%88%98%EB%8F%99+%EC%9E%85%EB%A0%A5%EC%9D%84+%EC%82%AC%EC%9A%A9%ED%95%98%EC%97%AC+OneSignal%EC%97%90%EC%84%9C+%EC%82%AC%EC%9A%A9%EC%9E%90%EB%A5%BC+%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B1%B0%EB%82%98+%EC%97%85%EB%8D%B0%EC%9D%B4%ED%8A%B8%ED%95%A9%EB%8B%88%EB%8B%A4.+%EC%9B%90%ED%99%9C%ED%95%9C+%EC%82%AC%EC%9A%A9%EC%9E%90+%EC%98%A8%EB%B3%B4%EB%94%A9+%EB%98%90%EB%8A%94+%EB%A7%88%EC%9D%B4%EA%B7%B8%EB%A0%88%EC%9D%B4%EC%85%98%EC%9D%84+%EC%9C%84%ED%95%B4+%EC%9D%B4%EB%A9%94%EC%9D%BC%2C+SMS%2C+%ED%83%9C%EA%B7%B8+%EB%93%B1%EC%9D%84+%EC%A7%80%EC%9B%90%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=12e705baa88dc8cc6d7a9877\u0026amp;signature=f4b5a432236e1c4845cde032e698db11e7bbe8f8171eae2fc7120e69687dd178\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/onesignal/eCiRydtW5fLfLRWp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OneSignal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3A3DB3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.onesignal.com/docs/ko/import\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ko/import.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://documentation.onesignal.com/docs/ko/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://documentation.onesignal.com/docs/en/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://documentation.onesignal.com/docs/cn/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://documentation.onesignal.com/docs/ja/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://documentation.onesignal.com/docs/tr/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://documentation.onesignal.com/docs/pt-BR/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://documentation.onesignal.com/docs/es/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://documentation.onesignal.com/docs/fr/import\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://documentation.onesignal.com/docs/en/import\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.onesignal.com/#organization\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onesignal/yJcueeDCO7UpHnnY/logo/OneSignal-Logo.svg?fit=max\u0026auto=format\u0026n=yJcueeDCO7UpHnnY\u0026q=85\u0026s=1fcfb6fef6d820fd9d99c74850711107\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.onesignal.com#website\",\"name\":\"OneSignal Documentation\",\"url\":\"https://documentation.onesignal.com\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.onesignal.com/docs/ko/import#webpage\",\"url\":\"https://documentation.onesignal.com/docs/ko/import\",\"name\":\"가져오기\",\"description\":\"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.\",\"dateModified\":\"2026-08-31T16:35:17.538Z\",\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/import#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.onesignal.com/docs/ko/import#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"오디언스 \u0026 사용자 지정 이벤트\",\"item\":\"https://documentation.onesignal.com/docs/ko/segmentation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"가져오기\",\"item\":\"https://documentation.onesignal.com/docs/ko/import\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.onesignal.com/docs/ko/import#article\",\"headline\":\"가져오기\",\"name\":\"가져오기\",\"description\":\"CSV 업로드, REST API 또는 수동 입력을 사용하여 OneSignal에서 사용자를 가져오거나 업데이트합니다. 원활한 사용자 온보딩 또는 마이그레이션을 위해 이메일, SMS, 태그 등을 지원합니다.\",\"url\":\"https://documentation.onesignal.com/docs/ko/import\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.onesignal.com/docs/ko/import#webpage\"},\"dateModified\":\"2026-08-31T16:35:17.538Z\",\"keywords\":\"import, csv, upload, bulk, tags, migrate, bulk tag updates\",\"publisher\":{\"@id\":\"https://documentation.onesignal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.onesignal.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OneSignal Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OneSignal Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/ko/import.md","siteName":"OneSignal Documentation","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/docs/en/import"}]},{"language":"cn","pages":[{"title":"cn","href":"/docs/cn/import"}]},{"language":"ko","tabs":[{"tab":"홈","pages":[{"title":"홈","href":"/docs/ko/home"}]},{"tab":"사용자 가이드","groups":[{"group":"시작하기 \u0026 설정","pages":[{"title":"OneSignal 시작하기","href":"/docs/ko/quickstart-guide"},{"group":"OneSignal 대시보드","pages":[{"title":"앱, 조직 및 계정","href":"/docs/ko/apps-organizations"},{"title":"팀 멤버","href":"/docs/ko/manage-team-members"},{"title":"키 및 ID","href":"/docs/ko/keys-and-ids"},{"title":"감사 로그","href":"/docs/ko/audit-logs"},{"title":"사용량 및 청구","href":"/docs/ko/billing-faq"},{"title":"비활성화된 앱 및 조직","href":"/docs/ko/disabled-apps"}]},{"title":"OneSignal로 마이그레이션","href":"/docs/ko/migrating-to-onesignal"}]},{"group":"메시지 채널","pages":[{"title":"채널 설정","href":"/docs/ko/channel-setup"},{"group":"푸시","pages":[{"title":"푸시 개요","href":"/docs/ko/push"},{"group":"모바일 푸시","pages":[{"title":"모바일 푸시 설정","href":"/docs/ko/mobile-push-setup"},{"title":"푸시 권한 요청","href":"/docs/ko/prompt-for-push-permissions"},{"title":"iOS 임시 푸시 알림","href":"/docs/ko/ios-provisional-push-notifications"},{"title":"Android 알림 카테고리","href":"/docs/ko/android-notification-categories"},{"title":"데이터 및 백그라운드 알림","href":"/docs/ko/data-notifications"},{"title":"VoIP 푸시 알림","href":"/docs/ko/voip-notifications"}]},{"group":"웹 푸시","pages":[{"title":"웹 푸시 설정","href":"/docs/ko/web-push-setup"},{"title":"Web 권한 프롬프트","href":"/docs/ko/permission-requests"},{"title":"웹 푸시 FAQ","href":"/docs/ko/web-push-setup-faq"},{"title":"웹 푸시 브라우저 동작","href":"/docs/ko/browser-behavior-and-unsubscribes"},{"title":"Shopify 웹 푸시 통합","href":"/docs/ko/shopify"},{"title":"웹 푸시를 위한 OneSignal WordPress 플러그인 설정","href":"/docs/ko/wordpress"},{"title":"WordPress 문제 해결","href":"/docs/ko/troubleshooting-wordpress-web-push"}]},{"group":"푸시 기능","pages":[{"title":"알림 아이콘","href":"/docs/ko/notification-icons"},{"title":"알림 이미지 및 리치 미디어","href":"/docs/ko/rich-media"},{"title":"알림 사운드","href":"/docs/ko/notification-sounds"},{"title":"알림 배지","href":"/docs/ko/badges"},{"title":"푸시 알림용 액션 버튼","href":"/docs/ko/action-buttons"},{"title":"푸시 빈도 제한","href":"/docs/ko/frequency-capping"},{"title":"푸시 제한","href":"/docs/ko/throttling"},{"title":"iOS: 집중 모드 및 중단 수준","href":"/docs/ko/ios-focus-modes-and-interruption-levels"},{"title":"iOS: 관련성 점수","href":"/docs/ko/ios-relevance-score"}]},{"group":"푸시 분석 \u0026 문제 해결","pages":[{"title":"푸시 메시지 리포트","href":"/docs/ko/push-notification-message-reports"},{"title":"확인된 전달","href":"/docs/ko/confirmed-delivery"},{"title":"알림 CTR","href":"/docs/ko/notification-ctr"},{"title":"모바일 푸시: 알림이 표시되지 않거나 지연됨","href":"/docs/ko/notifications-show-successful-but-are-not-being-shown"},{"title":"Web push: 알림이 표시되지 않음","href":"/docs/ko/notifications-not-shown-web-push"},{"title":"알림 이미지가 표시되지 않음","href":"/docs/ko/notification-images-not-showing"},{"title":"중복 알림","href":"/docs/ko/duplicated-notifications"},{"title":"FCM 만료 토큰 FAQ","href":"/docs/ko/fcm-expired-token-faq"}]}]},{"group":"인앱 메시지","pages":[{"title":"인앱 개요","href":"/docs/ko/in-app-messages-setup"},{"title":"인앱 트리거","href":"/docs/ko/iam-triggers"},{"title":"인앱 클릭 작업","href":"/docs/ko/iam-click-actions"},{"group":"인앱 디자인","pages":[{"title":"드래그 앤 드롭으로 인앱 메시지 디자인하기","href":"/docs/ko/design-your-in-app-message"},{"title":"HTML로 인앱 메시지 디자인하기","href":"/docs/ko/design-your-in-app-message-with-html"},{"title":"인앱 메시지 템플릿 및 퀵스타트","href":"/docs/ko/in-app-html-templates"},{"title":"인앱 메시지 JavaScript API 레퍼런스","href":"/docs/ko/in-app-message-api"}]},{"title":"인앱 메시지 보고서","href":"/docs/ko/in-app-message-reports"},{"title":"인앱 문제 해결","href":"/docs/ko/in-app-message-troubleshooting"}]},{"group":"이메일","pages":[{"title":"이메일 개요","href":"/docs/ko/email-messaging"},{"group":"Email setup","pages":[{"title":"이메일 설정","href":"/docs/ko/email-setup"},{"title":"이메일 DNS 구성","href":"/docs/ko/email-dns-configuration"},{"title":"발신자","href":"/docs/ko/senders"},{"title":"트랜잭션 이메일","href":"/docs/ko/setup-transactional-emails"},{"title":"사용자 지정 이메일 수신 거부 페이지 만들기","href":"/docs/ko/create-custom-unsubscribe-page"}]},{"group":"이메일 전달 가능성","pages":[{"title":"이메일 메시지 보고서","href":"/docs/ko/email-message-reports"},{"title":"이메일 전달 가능성","href":"/docs/ko/email-deliverability"},{"title":"이메일 평판 모범 사례","href":"/docs/ko/email-reputation-best-practices"},{"title":"이메일 주소 유효성 검사","href":"/docs/ko/email-address-validation"},{"title":"이메일 준비 가이드","href":"/docs/ko/email-warm-up"},{"title":"Google Postmaster Tools","href":"/docs/ko/google-postmaster-tools"},{"title":"차단 목록","href":"/docs/ko/suppressions"},{"title":"이메일 문제 해결","href":"/docs/ko/email-troubleshooting"}]},{"group":"이메일 메시지","pages":[{"title":"드래그 앤 드롭으로 이메일 디자인하기","href":"/docs/ko/design-emails-with-drag-and-drop"},{"title":"HTML로 이메일 디자인하기","href":"/docs/ko/design-emails-with-html"},{"title":"이메일 구독 취소 링크 및 헤더","href":"/docs/ko/unsubscribe-links-email-subscriptions"},{"title":"이메일 템플릿 전달","href":"/docs/ko/email-template-forwarding"}]}]},{"group":"SMS 및 RCS","pages":[{"title":"SMS, MMS, RCS 개요","href":"/docs/ko/sms-messaging"},{"title":"Rich Communication Services (RCS)","href":"/docs/ko/rcs-messaging"},{"group":"SMS 설정","pages":[{"title":"SMS 설정","href":"/docs/ko/sms-setup"},{"title":"발신자 리소스 신청 및 국가별 요구사항","sidebarTitle":"발신자 리소스 신청","href":"/docs/ko/sms-registration-requirements"},{"title":"SMS 옵트인 및 수집","href":"/docs/ko/sms-opt-in-and-collection"},{"title":"SMS 동의 키워드 관리","href":"/docs/ko/sms-consent-keyword-management"},{"title":"SMS 키워드","href":"/docs/ko/keywords"}]},{"group":"SMS 메시지","pages":[{"title":"SMS 메시지 리포트","href":"/docs/ko/sms-message-reports"},{"title":"일회용 비밀번호(OTP)","sidebarTitle":"일회용 비밀번호","href":"/docs/ko/sms-verify"}]}]},{"group":"실시간 현황","pages":[{"title":"Live Activities","href":"/docs/ko/live-activities"},{"title":"Live Activities 분석","href":"/docs/ko/live-activities-analytics"}]},{"group":"기능","pages":[{"title":"A/B 테스팅","href":"/docs/ko/ab-testing"},{"title":"다국어 메시징","href":"/docs/ko/multi-language-messaging"},{"group":"메시지 개인화","pages":[{"title":"개인화","href":"/docs/ko/message-personalization"},{"title":"Liquid 구문 사용","href":"/docs/ko/using-liquid-syntax"},{"title":"데이터 피드","href":"/docs/ko/data-feeds"},{"title":"Custom Events로 개인화하기","href":"/docs/ko/personalization-custom-event"},{"title":"속성을 사용한 개인화","href":"/docs/ko/personalization-properties-and-tags"},{"title":"API custom_data로 메시지 개인화하기","href":"/docs/ko/personalization-api-custom-data"},{"title":"CSV를 사용한 동적 콘텐츠","href":"/docs/ko/dynamic-content"}]},{"group":"URL, 링크, 딥 링크","pages":[{"title":"URL, 링크 및 딥 링크","href":"/docs/ko/links"},{"title":"딥 링킹","href":"/docs/ko/deep-linking"},{"title":"이메일 구독 취소 링크 및 헤더","href":"/docs/ko/unsubscribe-links-email-subscriptions"}]},{"title":"리타겟팅 메시지","href":"/docs/ko/retargeting"},{"title":"템플릿","href":"/docs/ko/templates"},{"title":"레이블","href":"/docs/ko/labels"}]}]},{"group":"Journeys","pages":[{"title":"Journey 개요","href":"/docs/ko/journeys-overview"},{"group":"Journey 기능","pages":[{"title":"Journey 설정","href":"/docs/ko/journeys-settings"},{"title":"Journey 메시지","href":"/docs/ko/journeys-messages"},{"title":"Journey 액션","href":"/docs/ko/journeys-actions"},{"title":"Journey Webhook","href":"/docs/ko/journeys-webhook"},{"title":"Journey Webhook을 통해 WhatsApp 메시지 보내기","href":"/docs/ko/sending-whatsapp-messages-via-journey-webhooks"},{"title":"Journeys 관리","href":"/docs/ko/managing-journeys"},{"title":"Journey 분석","href":"/docs/ko/journeys-analytics"}]},{"title":"Journey 예시","href":"/docs/ko/journeys-examples"}]},{"group":"오디언스 \u0026 사용자 지정 이벤트","pages":[{"title":"세그먼트","href":"/docs/ko/segmentation"},{"group":"Users \u0026 Subscriptions","pages":[{"title":"사용자","href":"/docs/ko/users"},{"title":"구독","href":"/docs/ko/subscriptions"},{"title":"별칭","href":"/docs/ko/aliases"},{"title":"테스트 사용자","href":"/docs/ko/test-users"},{"title":"사용자 삭제","href":"/docs/ko/delete-users"}]},{"group":"사용자 지정 이벤트","pages":[{"title":"사용자 지정 이벤트","href":"/docs/ko/custom-events"},{"title":"사용자 지정 이벤트 저장 및 보존","href":"/docs/ko/custom-event-storage"}]},{"group":"태그","pages":[{"title":"태그","href":"/docs/ko/add-user-data-tags"},{"title":"태그: 시간 연산자","description":"초 단위 Unix 타임스탬프를 저장하는 데이터 태그와 Time Elapsed 연산자를 사용해 시간 기반 메시지를 자동화하세요. 장바구니 이탈 리마인더, 생일 메시지, 예약된 미래 날짜 알림 같은 사용 사례를 코드 예제와 함께 안내합니다.","href":"/docs/ko/time-operators"}]},{"title":"가져오기","href":"/docs/ko/import"}]},{"group":"분석 \u0026 통합","pages":[{"group":"분석","pages":[{"title":"분석 개요","description":"OneSignal에서 메시지 성능, 사용자 참여, 전환을 측정하세요. 메시지 보고서, Event Streams, 전환 지표, Journey 및 템플릿 분석, 목표, CSV 데이터 내보내기 등 분석 기능을 선택하고 활용하는 방법을 안내합니다.","href":"/docs/ko/analytics-overview"},{"title":"목표","sidebarTitle":"목표","href":"/docs/ko/goals"},{"title":"템플릿 분석","href":"/docs/ko/template-analytics"},{"title":"데이터 내보내기","href":"/docs/ko/exporting-data"},{"title":"사용자 지정 Outcomes","href":"/docs/ko/custom-outcomes"},{"title":"전환 지표","href":"/docs/ko/conversion-metrics"},{"title":"참여 트렌드","href":"/docs/ko/engagement-analytics"},{"title":"구독 트렌드","href":"/docs/ko/subscription-trends"},{"group":"리텐션 지표","pages":[{"title":"리텐션 지표","href":"/docs/ko/retention-metrics"},{"title":"리텐션 곡선 해석","href":"/docs/ko/interpreting-retention-curves"}]},{"title":"지표 용어집","href":"/docs/ko/analytics-metrics-glossary"}]},{"group":"이벤트 스트림","pages":[{"title":"이벤트 스트림","href":"/docs/ko/event-streams"},{"title":"이벤트 스트림 데이터 참조","sidebarTitle":"이벤트 스트림 데이터","href":"/docs/ko/event-streams-data"},{"title":"인앱 메시지 이벤트 스트림","href":"/docs/ko/iam-event-streams"},{"title":"Event Streams와 Google Sheets 통합","href":"/docs/ko/google-sheets-integration-with-event-streams"}]},{"group":"통합","pages":[{"title":"통합 개요","href":"/docs/ko/integrations"},{"title":"데이터 웨어하우스, DMP 및 CRM 통합","href":"/docs/ko/database-dmp-crm-integration"},{"group":"OneSignal을 데이터 소스로 사용","pages":[{"title":"Amplitude","href":"/docs/ko/amplitude"},{"title":"Databricks","href":"/docs/ko/databricks"},{"title":"Google BigQuery","href":"/docs/ko/bigquery"},{"title":"Mixpanel","href":"/docs/ko/mixpanel"},{"title":"Snowflake","href":"/docs/ko/snowflake"},{"title":"Segment (Twilio)","href":"/docs/ko/segment-onesignal-integration"}]},{"group":"OneSignal을 데이터 목적지로 사용","pages":[{"title":"Adobe Audience Manager","href":"/docs/ko/adobe-audience-manager"},{"title":"AlloyDB","href":"/docs/ko/alloydb"},{"title":"Amazon Athena","href":"/docs/ko/amazon-athena"},{"title":"Amazon S3","href":"/docs/ko/s3"},{"title":"Amplitude","href":"/docs/ko/amplitude"},{"title":"Apache Kafka","href":"/docs/ko/kafka"},{"title":"Amazon Redshift","href":"/docs/ko/amazon-redshift"},{"title":"Azure Synapse","href":"/docs/ko/azure-synapse"},{"title":"ClickHouse","href":"/docs/ko/clickhouse"},{"title":"Confluent Cloud","href":"/docs/ko/confluent-cloud"},{"title":"Databricks","href":"/docs/ko/databricks"},{"title":"Elasticsearch","href":"/docs/ko/elasticsearch"},{"title":"Google BigQuery","href":"/docs/ko/bigquery"},{"title":"Google Cloud SQL","href":"/docs/ko/google-cloud-sql"},{"title":"Google Sheets","href":"/docs/ko/google-sheets"},{"title":"Greenplum","href":"/docs/ko/greenplum"},{"title":"HubSpot","href":"/docs/ko/hubspot"},{"title":"Materialize","href":"/docs/ko/materialize"},{"title":"Microsoft Fabric","href":"/docs/ko/microsoft-fabric"},{"title":"Mixpanel","href":"/docs/ko/mixpanel"},{"title":"MotherDuck","href":"/docs/ko/motherduck"},{"title":"MySQL","href":"/docs/ko/mysql"},{"title":"PostgreSQL","href":"/docs/ko/postgresql"},{"title":"Pub/Sub","href":"/docs/ko/google-pubsub"},{"title":"SingleStore","href":"/docs/ko/singlestore"},{"title":"Snowflake","href":"/docs/ko/snowflake"},{"title":"SQL Server","href":"/docs/ko/sql-server"},{"title":"Starburst Enterprise","href":"/docs/ko/starburst-enterprise"},{"title":"Starburst Galaxy","href":"/docs/ko/starburst-galaxy"},{"title":"Trino","href":"/docs/ko/trino"},{"title":"Segment (Twilio)","href":"/docs/ko/segment-onesignal-integration"}]},{"group":"소비자 추적","pages":[{"title":"RevenueCat","href":"/docs/ko/revenuecat"},{"title":"Adjust","href":"/docs/ko/adjust"},{"title":"BlueConic","href":"/docs/ko/blueconic"}]},{"title":"OneSignal과 통합 구축: 파트너 가이드","href":"/docs/ko/building-an-integration-with-onesignal-partner-guide"}]}]},{"group":"개인 정보 보호 \u0026 보안","pages":[{"group":"보안 자격 증명","pages":[{"title":"SOC 2 Type II","href":"/docs/ko/soc-2-type-ii"},{"title":"ISO 27001","href":"/docs/ko/iso27001"},{"title":"HIPAA","href":"/docs/ko/hipaa"}]},{"group":"데이터 개인 정보 보호 \u0026 규정 준수","pages":[{"title":"GDPR 및 개인 권리","href":"/docs/ko/gdpr-compliance"},{"title":"EU-US 데이터 개인 정보 보호 프레임워크","href":"/docs/ko/eu-us-data-privacy-framework"},{"title":"이메일 규정 준수","href":"/docs/ko/email-compliance"},{"title":"SMS 규제 준수","href":"/docs/ko/sms-regulatory-compliance"},{"title":"Apple 앱 개인정보 보호 요구 사항","href":"/docs/ko/apple-app-privacy-requirements"},{"title":"Google Play 데이터 보안 요구 사항","href":"/docs/ko/google-play-data-safety-requirements"},{"title":"데이터 수집 및 보안 FAQ","href":"/docs/ko/data-questions"},{"title":"OneSignal SDK가 수집하는 데이터","href":"/docs/ko/data-collected-by-the-onesignal-sdk"},{"title":"개인 데이터 처리","href":"/docs/ko/handling-personal-data"}]},{"group":"인증 및 보안","pages":[{"title":"2단계 인증","href":"/docs/ko/2-step-authentication"},{"title":"Single Sign-On (SSO)","href":"/docs/ko/sso"}]}]}]},{"tab":"개발자 가이드","pages":[{"title":"개발자 가이드","href":"/docs/ko/developers"}]},{"tab":"튜토리얼","pages":[{"title":"튜토리얼","href":"/docs/ko/tutorials"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/rest-api-overview"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]}],"global":{"anchors":[{"anchor":"Blog","icon":"newspaper","href":"https://onesignal.com/blog"},{"anchor":"GitHub","icon":"github","href":"https://github.com/OneSignal"},{"anchor":"YouTube","icon":"youtube","href":"https://www.youtube.com/@onesignalofficial/playlists"}]}},{"language":"ja","pages":[{"title":"ja","href":"/docs/ja/import"}]},{"language":"tr","pages":[{"title":"tr","href":"/docs/tr/import"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/docs/pt-BR/import"}]},{"language":"es","pages":[{"title":"es","href":"/docs/es/import"}]},{"language":"fr","pages":[{"title":"fr","href":"/docs/fr/import"}]}]},"basePath":"","title":"가져오기 - OneSignal Documentation","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BXrZabKK.js","DynamicMarkdown-CtasenyM.js","zoom-image-lightbox-C5F0mVLH.js","lightbox-handle-r17bVUz3.js"]}
