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

프리미엄

한눈에 보기: 내부 시스템(예: BI 및 CRM)에서 사전 정의된 오디언스 세그먼트를 앱스플라이어 오디언스로 가져와 이를 통해 광고 파트너와 이러한 세그먼트를 연결하고 관리할 있습니다.

오디언스를 가져오는 이유는 무엇인가요?

특정 상황에서는 내부 시스템에 미리 정의된 오디언스 세그먼트가 있을 수 있습니다. 이러한 오디언스(기기 및/또는 사용자 식별자 목록)를 앱스플라이어로 가져오면, 광고 파트너와 모든 오디언스 세그먼트를 연결하고 유지하기 위한 중심점으로 사용할 수 있습니다. 또한 식별자 일치/데이터 보강 및 연결된 캠페인 지표와 같은 오디언스 기능을 사용할 수 있습니다.

다음 예를 생각해 보세요.

 예시

프로모션 리마케팅
생일이 있는 달에 사용자에게 프로모션 오퍼를 타겟팅하려고 합니다.

오디언스에서 이를 수행하는 방법은 다음과 같습니다.

  1. 내부 CRM을 사용하여 생일과 함께 사용자 목록을 생성합니다.
  2. 생일 월에 따라 목록을 세분화하여 광고 ID의 개별 목록으로 내보냅니다.
  3. 리스트를 앱스플라이어에 오디언스로 가져와 프로모션 캠페인을 실행할 파트너에게 연결합니다.
  4. 관련 파트너와 함께 캠페인을 설정하여 오디언스를 적절히 타겟팅하세요.

추가 사용자 확보
사용자의 앱 개발 스튜디오가 다른 스튜디오를 확보했습니다. 획득한 스튜디오에는 이전에 앱을 설치한 사용자의 기기 ID가 있으며, 이러한 사용자를 타겟팅하여 기존 앱을 설치하도록 하려는 것입니다.

오디언스에서 이를 수행하는 방법은 다음과 같습니다.

  1. 확보한 스튜디오에서 기기 ID 목록을 가져와서 앱스플라이어에 오디언스로 가져옵니다.
  2. 캠페인을 운영하려는 파트너와 오디언스를 연결합니다.
  3. 관련 파트너와 함께 캠페인을 설정하여 이러한 사용자를 적절히 타겟팅하세요.

오디언스 가져오기 V2.0

이 글에서는 새로운 오디언스 가져오기 기능 V2.0(CSV 및 API로 가져오기 옵션 포함)과 관련된 개념 및 절차에 대해 설명합니다. 

가져온 오디언스 유형

오디언스를 가져올 때 두 가지 유형 중 하나로 지정하면, 앱스플라이어가 업로드된 오디언스를 처리하고 파트너에게 업로드하는 방식이 결정됩니다. 대상 지정은 오디언스를 처음 가져올 때 이루어지며 추후에 변경할 수 없습니다.

가져오기 대상 표준:

  • 식별자 매칭 및 데이터 보강 - 파트너에게 업로드된 오디언스 데이터를 보강하기 위해 가져온 식별자를 오디언스 데이터베이스의 기존 식별자(동일한 앱의 동일한 사용자에 대해)와 일치시키는 프로세스입니다.
  • 계정의 사용자 식별자 정책에 따라 파트너에게 업로드됩니다.
  • 이 글에서 설명된 V2.0 가져오기 기능을 사용해 가져와야 합니다.

'그대로' 가져온 오디언스:

  • 식별자 매칭 및 데이터 보강을 거치지 않습니다.
  • 계정의 사용자 식별자 정책에 대한 참조 없이 파트너에게 업로드됩니다(즉, 가져온 모든 식별자가 파트너에게 업로드됨).
  • V2.0 가져오기 기능(이 글에서 설명됨)을 사용하여 가져올 수 있습니다.

 중요!

  • 2021년 11월 23일 현재 존재하는 모든 대상은 있는 그대로의 오디언스로 지정되며 표준 오디언스로 변경할 수 없습니다. 필요에 따라 V2.0 가져오기 기능(이 문서에 설명되어 있음)을 사용하여 이러한 오디언스를 계속 업데이트할 수 있습니다.
  • 한 번에 최대 500명의 활성 오디언스를 가져올 수 있습니다.
  • 관리자만 새로 가져온 오디언스를 현재 그대로의 오디언스로 지정할 수 있습니다.
  • CUID를 식별자로 사용하여 오디언스를 구축할 때, 관련 기기와의 완전한 연결과 기기 식별자(즉 GAID, IDFA)를 통한 성공적인 보강을 위해 앱스플라이어가 설치 시(설치 후 이벤트 발생 시가 아니라) CUID 연결을 수신해야 합니다. 더 알아보기

오디언스 가져오기 절차

CSV 파일을 업로드하거나 오디언스 가져오기 API를 사용하여 오디언스를 가져옵니다.

CSV 파일 가져오기

다음 사양으로 CSV 파일을 준비합니다.

형식

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

    CSV.jpg

열 및 식별자

  • 데이터는 헤더 행을 사용하여 각 열의 데이터를 식별하기 위해 수집됩니다. 즉,
    • 열이 특정 순서로 표시될 필요는 없습니다.
    • 업로드되지 않는 식별자에 대한 열을 포함할 필요는 없습니다.
    • 아래에 자세히 설명된 대로 각 행에 필수 식별자가 포함되어 있는 한, 하나의 CSV 파일에 원하는 만큼의 식별자를 가져올 수 있습니다.
  • 사용 가능한 식별자:
    • app_id
    • idfv
    • idfa
    • gaid
    • oaid
    • imei
    • cuid
    • 이메일
    • 전화
    • phone_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일 구글의 디지털 시장법(DMA) 시행에 따라, '그대로' 오디언스를 가져올 때, 앱스플라이어 동의 열을 두 개 추가해야 합니다. 예를 들어:
앱스플라이어 동의 열  구글 필드  필드 설명
ad_personalization_enabled ad_personalization true/false 유저가 개인 맞춤 광고를 위해 구글에서 자신의 데이터를 사용하는 데 동의했나요?
ad_user_data_enabled ad_user_data true/false 유저가 유저 데이터를 구글에 전송하는 데 동의했나요?  

동의 필드에 값을 입력하지 않으면 구글에 '지정되지 않음'으로 전송되며 구글 측의 오디언스에 포함되지 않을 가능성이 높습니다. 이 필드를 채우면 유럽 경제 지역(EEA)의 사용자를 구글 오디언스에 최대한 포함할 수 있습니다.

CSV 파일 예시:

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

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

  1. 앱스플라이어 왼쪽 패널에서 연동 > 오디언스로 이동합니다.
  2. 새 오디언스를 클릭합니다.
  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 파일을 사용하여 오디언스가 업데이트되었습니다. 그러나 가져온 오디언스는 매일 데이터 새로 고침으로 처리되므로 수정된 오디언스 목록은 아직 파트너에게 업로드되지 않는다는 점에 유의하세요.

확인 메시지

메시지 원인 수행할 작업
업로드 성공    
기기 목록에 문제 발생 기기 목록에 하나 또는 여러 개의 문제 발생 CSV 파일 확인:
  • 올바른 형식의 기기 및 GAID/IDFA 식별자가 채워져 있는지 확인
  • 필수 식별자 포함 여부 확인
  • 올바른 형식의 헤더 행이 포함된 헤더 행 포함 여부 확인
  • 빈 행이 없는지 확인
  • app_id가 오디언스에 사용하는 올바른 앱으로 채워졌는지 확인
기기 목록이 비어 있는 것 같습니다. 기기 ID를 추가하고 다시 시도하세요. CSV 파일이 비어 있음

CSV가 하나 이상의 기기 ID를 포함하는지 확인하세요.

하나 이상의 기기 ID를 식별할 수 없습니다.
  • CSV 형식이 올바르지 않음
  • 업로드한 파일이 CSV 파일이 아님
  • CSV 파일이 유효한 CSV 편집기(예, 마이크로소프트 엑셀)가 아닌 다른 프로그램에 의해 편집 및 저장됨
  • 하나 또는 그 이상의 기기 ID가 잘못된 형식
  • CSV가 정확한 형식인지 확인합니다.
  • 모든 기기 ID가 올바른 GUID 형식으로 되어 있는지 확인합니다.
  • 엑셀을 사용한 경우, 위에서 설명한 대로 파일을 CSV 파일로 저장합니다. 
대상에 사용자 계정 정책을 적용하는 동안에는 v1 가져오기를 사용할 수 없습니다. V1.0 가져오기 구조를 사용하여 표준 오디언스에 대한 CSV 파일을 업로드했습니다. 표준 오디언스는 V2.0 구조의 CSV를 사용하여 업로드해야 합니다. 위에서 설명한 형식, 열 및 식별자를 사용하도록 업로드하는 CSV 파일을 편집합니다.
일시적인 연결 문제가 발생하여 파일을 업로드할 수 없습니다. 다시 시도하세요. 네트워크 오류 가능성 CSV 파일을 다시 업로드합니다.

오디언스 가져오기 API 사용

오디언스 가져오기 API는 오디언스에 기기를 추가하거나 삭제하기 위해 사용됩니다. 

API를 사용하여 새 오디언스를 가져오기:

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

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

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

응답 코드

코드 메시지 설명

200

요청이 성공적으로 완료되었습니다.

오디언스 가져오기에 성공했습니다.

400 유효하지 않은 오디언스 플랫폼입니다. 이 오디언스는 이미 안드로이드/iOS에 설정되어 있습니다. 다른 플랫폼을 사용하려면, UI에서 새 오디언스를 생성하십시오. 요청 본문에서 지정된 플랫폼이 오디언스를 작성할 때 지정한 플랫폼과 일치하지 않습니다.
400 X개 이상의 행에 앱 ID가 포함되어 있지 않습니다. 각 행에 앱 ID를 첨부해야 합니다.

각 행에는 app_id가 포함되어야 합니다.

  • 참고: V1.0 레거시 가져오기 기능을 사용하여 가져온 있는 그대로의 오디언스에게는 app_id가 필요하지 않습니다.
400 X개 이상의 행에 유효한 고유 식별자가 포함되어 있지 않습니다.

전체 또는 일부 행에 유효한 형식의 다음 식별자 중 하나 이상이 포함되어 있지 않습니다.

  • 안드로이드 오디언스의 경우: gaid, oiad, imei, cuid, braze_id 또는 amplitude_id
  • iOS 오디언스의 경우: idfv, cuid, braze_id 또는 amplitude_id
400 요청당 Y개 이상의 기기를 처리할 수 없습니다(이 요청에 포함되는 기기는 N개임).

요청 본문에는 10,000개 이상의 기기 ID 목록이 포함되어 있습니다.

400 기기 목록은 비워둘 수 없습니다.

요청 본문에는 빈 기기 목록이 포함되어 있습니다.

요청당 하나 이상의 기기 ID를 제공해야 합니다.

400 하나 이상의 기기 ID를 식별할 수 없습니다. 전체 또는 일부 기기 ID가 유효한 형식이 아닙니다.

400

제거할 기기 중 X개 이상의 기기에 기기당 하나 이상의 식별자가 포함되어 있습니다.

기기당 두 개 이상의 식별자와 함께 제거 요청이 전송되었습니다. 

403 금지 승인되지 않은 요청: 가져오기 키가 잘못되었거나 누락되었습니다.
429 요청이 너무 많음 요청은 분당 350건으로 제한됩니다.
500 요청을 분석할 수 없습니다.

잘못된 요청 본문 형식 (예상된 JSON 구조가 아니거나 JSON이 아님)입니다.

위의 샘플 요청을 참조하세요.

API 제한 사항

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

가져온 오디언스 관리 API

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