오디언스 - 오디언스 가져오기

다음 사양에 따라 CSV 파일을 준비하세요.

형식

• 업로드되는 각 유저 식별자에 대한 하나의 열
• 각 열의 식별자 이름이 있는 헤더 행(모두 소문자)
• 빈 행 없음
• 최대 행 수: 1,000만
• Excel을 사용하여 파일을 준비할 경우, 다음 이미지와 같이 CSV (쉼표로 구분)(*.csv) 파일로 저장합니다.

  

식별자 해시

열 및 식별자

• 데이터는 헤더 행을 사용하여 각 열의 데이터를 식별합니다. 따라서:
  • 열이 특정 순서로 표시될 필요는 없습니다.
  • 업로드되지 않는 식별자에 대한 열을 포함할 필요는 없습니다.
  • 각 행에 필수 식별자가 포함되어 있는 한, 하나의 CSV 파일에서 원하는 만큼 식별자를 가져올 수 있습니다. 아래에서 자세히 설명합니다.
• 사용 가능한 식별자:
  • app_id
  • idfv
  • idfa
  • gaid
  • oaid
  • imei
  • cuid
  • 이메일
  • 전화번호
  • 전화_e164
  • braze_id
  • amplitude_id
• 필수 식별자:
  
  • 안드로이드 오디언스: app_id + 다음 중 하나: gaid, oiad, imei, cuid, braze_id 또는 amplitude_id
  • iOS 오디언스: app_id + 다음 중 하나: idfv, cuid, braze_id 또는 amplitude_id
• 2024년 3월 6일 Google에서 디지털 시장법(DMA)을 준수하기 위해, '있는 그대로' 오디언스를 가져올 때에는 앱스플라이어 동의 열 두 개를 추가해야 합니다. 다음과 같습니다:

동의 필드에 값이 입력되지 않으면 Google에 "지정되지 않음"으로 전송되며, Google 측 오디언스에 포함되지 않을 가능성이 큽니다. 이러한 필드를 채우면 Google 오디언스에 유럽 경제 지역(EEA)의 유저를 최대한 포함할 수 있습니다.

CSV 파일 예시:

new-import-android-example.csv
new-import-ios-example.csv

CSV 파일을 사용하여 새 오디언스를 만들고 가져오기:

1. 앱스플라이어 왼쪽 패널에서 (유저를 앱에) 참여시키다 > 오디언스로 이동합니다.
2. New 오디언스를 클릭합니다.
3. 오디언스 가져오기를 선택합니다.
   오디언스 가져오기 기간이 열립니다.
4. 고유한 오디언스 이름을 입력합니다.
5. 오디언스 플랫폼을 선택하세요: 안드로이드 또는 iOS.
6. 이 오디언스가 표준 오디언스인지 아니면 있는 그대로의 오디언스인지 표시하세요.
7. 표준 오디언스의 경우 상자를 체크하지 않습니다.
8. 있는 그대로의 오디언스의 경우 상자를 체크합니다. (참고: 이 옵션은 관리자만 사용할 수 있습니다.)
9. 오디언스를 저장하고 계속을 클릭하세요.
   가져오기 탭이 표시됩니다.
10. CSV 사용하여 가져오기 섹션에서 기본값인 새로운 디바이스/사용자 추가를 그대로 유지합니다 (새로운 오디언스이기 때문입니다).
11. 업로드할 CSV 파일을 선택합니다.
    성공적으로 업로드되었습니다.라는 확인 메시지가 표시될 때까지 기다립니다.
12. 다음을 클릭하세요.
    연결 탭이 표시됩니다.
13. (선택 사항) 오디언스를 파트너와 연결하는 방법에 대한 지침을 따르세요.
14. 완료를 클릭합니다.

이제 오디언스가 오디언스 대시보드에 표시되며, 가져오기 및 파트너와 연결되었습니다. 그러나 새로 가져온 오디언스 목록은 아직 파트너에게 업로드할 수 없습니다. 이는 가져온 오디언스가 데이터 최신성으로 처리되기 때문입니다.

CSV 파일을 사용하여 기존 오디언스를 업데이트하려면:

1. 앱스플라이어 왼쪽 패널에서 (유저를 앱에) 참여시키다 > 오디언스로 이동합니다.
2. 업데이트하려는 오디언스의 이름을 클릭하세요.
   오디언스 편집 화면이 열리며, 정의 탭이 표시됩니다.
3. 오디언스 이름을 편집하려면 여기에서 가능합니다. 그렇지 않으면 가져오기 탭을 선택하여 새 CSV 파일을 업로드하세요.
4. CSV 사용하여 가져오기 섹션에서 업로드된 목록을 어떻게 처리할지 선택합니다.
5. 새로운 디바이스/사용자 추가: 기존 오디언스에 디바이스/사용자 식별자를 추가합니다.
6. 기존 오디언스에서 디바이스/사용자 제거: 업로드된 목록에서 디바이스/사용자 식별자를 오디언스에서 제거합니다.
7. 기존 오디언스를 새 디바이스/사용자로 덮어쓰기: 업로드된 목록으로 전체 오디언스를 교체합니다.
8. 업로드할 CSV 파일을 선택합니다.
   성공적으로 업로드되었습니다.라는 확인 메시지가 표시될 때까지 기다립니다.
9. 다음을 클릭하세요.
   연결 탭이 표시됩니다.
10. 필요한 경우 이 오디언스에 대한 파트너 연결을 변경하세요.
11. 완료를 클릭합니다.

오디언스가 CSV 파일을 사용하여 업데이트되었습니다. 하지만 가져온 오디언스는 일일 데이터 최신성으로 처리되므로 수정된 오디언스 목록은 아직 파트너에게 업로드되지 않았습니다.

오류 메시지

오디언스 가져오기 API는 오디언스에 디바이스를 추가하거나 제거하는 데 사용됩니다. 

API를 사용하여 New 오디언스를 가져오려면:

1. 앱스플라이어 왼쪽 패널에서 (유저를 앱에) 참여시키다 > 오디언스로 이동합니다.
2. New 오디언스를 클릭합니다.
3. 오디언스 가져오기를 선택합니다.
   오디언스 가져오기 기간이 열립니다.
4. 고유한 오디언스 이름을 입력합니다.
5. 오디언스 플랫폼을 선택하세요: 안드로이드 또는 iOS.
6. 이 오디언스가 표준 오디언스인지 아니면 있는 그대로의 오디언스인지 표시하세요.
   • 표준 오디언스의 경우 박스를 선택하지 않고 둡니다.
   • 있는 그대로의 오디언스의 경우 박스를 선택합니다(이 옵션은 관리자만 사용할 수 있습니다). Google의 디지털 시장법(DMA) 시행에 따라 2024년 3월 6일부터 "있는 그대로" 오디언스를 가져올 때 두 가지 추가 동의 필드가 필요합니다. 이 필드를 채우면 Google 오디언스에 유럽 경제 지역(EEA)의 사용자가 최대한 포함될 수 있습니다.
7. 저장을 클릭합니다.
   가져오기 페이지가 표시됩니다.
8. API를 사용하여 가져오기 섹션에서 기본값인 새 디바이스\/사용자 추가를 유지합니다(이는 New 오디언스이기 때문입니다).
9. New 오디언스 API 가져오기 페이지에서 API 요청 URL을 복사합니다(API 토큰은 이미 포함되어 있습니다).
10. 그런 다음 API 요청 본문을 복사하여 붙여넣습니다.
11. 완료를 클릭합니다.
    연결 탭이 표시됩니다.
12. (선택 사항) 오디언스를 파트너와 연결하는 방법에 대한 지침을 따르세요.
13. 완료를 클릭합니다.
14. 사용자\/디바이스 식별자를 포함한 API 요청을 준비하고 앱스플라이어에 POST합니다. 

API를 사용하여 기존 오디언스를 업데이트하려면:

1. 앱스플라이어 왼쪽 패널에서 (유저를 앱에) 참여시키다 > 오디언스로 이동합니다.
2. 업데이트하려는 오디언스의 이름을 클릭하세요.
   오디언스 편집 화면이 열리며, 정의 탭이 표시됩니다.
3. 오디언스 이름을 편집하려면 여기에서 가능합니다. 그 외에는 가져오기 탭을 선택합니다.
4. API를 사용하여 가져오기 섹션에서 업로드된 목록으로 수행할 작업을 선택합니다.
5. 새 디바이스\/사용자 추가: 기존 오디언스에 디바이스\/사용자 식별자를 추가합니다.
6. 기존 오디언스에서 디바이스\/사용자 제거: 기존 오디언스에서 디바이스\/사용자 식별자를 제거합니다.
7. New 오디언스 API 가져오기 페이지에서 API 요청 URL을 복사합니다(API 토큰은 이미 포함되어 있습니다). 참고: 이 옵션을 변경하면 복사할 코드의 엔드포인트 경로가 변경됩니다. 이번 및 향후 API 요청에서 수행하려는 작업에 대해 올바른 엔드포인트를 사용해야 합니다.
8. 그런 다음 API 요청 본문을 복사합니다.
9. 다음을 클릭하세요.
   연결 탭이 표시됩니다.
10. 필요한 경우 이 오디언스에 대한 파트너 연결을 변경하세요.
11. 완료를 클릭합니다.
12. 사용자\/디바이스 식별자를 포함한 API 요청을 준비하고 앱스플라이어에 POST합니다.

참고: API를 통해 가져오는 경우, 오디언스가 업데이트되는 데 24시간이 소요됩니다.

응답 코드

API 제한 사항

• 요청당 하나의 오디언스에만 디바이스를 추가할 수 있습니다.
• 요청당 하나의 오디언스에서만 디바이스를 제거할 수 있습니다.
• 요청당 최대 20,000개의 디바이스 ID를 발송할 수 있습니다.
• 분당 최대 350건의 요청을 발송할 수 있습니다.

가져온 오디언스 관리 API를 사용하면 광고주가 가져온 오디언스를 생성 및 구성하고, 파트너와 연결하고, 파트너에 업로드할 수 있습니다.