방법 및 안내

반복 리스트 임포트 방법은 광고주가 정기적으로 업데이트되는 데이터를 Remerge에 제공할 때 활용할 수 있는 특별한 옵션입니다. 여러분의 이해를 돕기 위해, 반복 리스트 임포트를 활용할 수 있는 대표적인 사례들을 정리해 드렸습니다:

• Remerge에 매일 타겟팅할 유저 리스트를 제공하고자 하는 경우
• Remerge에 매주 타겟팅할 세그먼트 리스트를 제공하고자 하는 경우
• 타겟팅 제외 리스트를 생성하는 경우 (예: 광고 노출을 원하지 않는 유저, 디타겟팅)
• MMP 연동등의 인앱 이벤트 를 통해 수집할 수 없는 BI 데이터(예: 고래/고과금 유저 또는 이탈 유저)를 활용하고자 하는 경우

반복 리스트 임포트 방법은 반복적으로 자동화할 수 있으며, 아래의 방식 중 하나를 통해 구현할 수 있습니다: Amazon S3 버킷, URL, Audience Builder(Adjust), 또는 Audiences(AppsFlyer)

다음의 가이드라인, 파일 형식 요구사항, 그리고 예시를 BI 팀(Business Intelligence Team)과 반드시 공유해 주세요. 임포트 방법이나 충분한 데이터 볼륨에 대해 궁금하신 점이 있다면, Remerge 담당자에게 문의해 주세요.

Amazon S3 Bucket

고유한 유저 세그먼트가 포함된 CSV 파일을 귀사가 직접 생성 및 호스팅한 Amazon S3 버킷 또는 Remerge가 제공한 버킷에 정기적으로 업로드하실 수 있습니다.

 

1. Amazon S3 버킷에 연결하기

선택

지정된 Amazon S3 버킷을 확인한 후, 아래에 안내된 해당 단계에 따라 진행해 주세요.

• 귀사의 Amazon S3 버킷 – 이 경우, 아래의 Amazon S3 버킷 로그인 정보를 Remerge 담당자에게 반드시 전달해 주세요:
  • Access Key ID
  • Secret Access Key
  • 서버 인스턴스 리전 (Server Instance Region)

• Remerge의 Amazon S3 버킷 – 이 경우, 아래 예시와 같이 Remerge 담당자로부터 Amazon S3 버킷 로그인 정보를 받아야 합니다.
  • Remerge Access Key ID: PLKR6XORH5XQRXYSLZ1B (예시)
  • Remerge Secret Access Key: 23R52F5678NDFT4L44G23R52M9086NDUT4M44N (예시)
  • Remerge의 서버 인스턴스 리전 (항상 고정): us-east-1 (예시)

자동화

반복적으로 업로드되는 파일이 선택한 Amazon S3 버킷에 자동으로 업로드되도록 내부 팀과 협의해 주세요.

 

2. 오브젝트 키 (Object Key) 정의하기

구조

• 다음과 같은 형식으로 CSV 오브젝트 키를 정의해 주세요:

          /list-import/<APP ID>/<SEGMENT ID>/file.csv

참고: 오브젝트 키 내에 /list-import/ 경로를 포함시키는 것 (예: /list-import/<APP ID>/<SEGMENT ID>/file.csv)은 Remerge가 체계적이고 효율적인 버킷 구조를 유지하는 데 도움이 됩니다.

데이터 입력

아래의 형식(/list-import/<APP ID>/<SEGMENT ID>/file.csv)에 맞춰 데이터 입력 요건을 준수해 주세요:

• APP ID – 특정 세그먼트와 연결된 앱의 고유 ID입니다:
  • 유저 혼합 금지 – 유저 리스트는 반드시 하나의 고유한 애플리케이션과 연결되어야 합니다.
• SEGMENT ID – 세그먼트 이름(식별자)입니다:
  • 유저 혼합 금지 – 유저 리스트는 반드시 하나의 고유한 애플리케이션과 연결되어야 합니다.
  • 세그먼트 ID는 해당 세그먼트의 유형을 반영하는 고유한 이름으로 지정해 주세요. 세그먼트 이름 예시는 아래와 같습니다:
    • purchasers
    • AB-whales
    • holdout_90+
    • exclusion_list_users

디렉토리 구조 예시

• 다음의 CSV 파일 작성 가이드라인을 반드시 준수해 주세요:
  • CSV 파일 이름은 자유롭게 지정하셔도 됩니다.
  •  단, 반드시 유효한 유저 ID만 포함해 주세요 – iOS 세그먼트에는 IDFA, Android 세그먼트에는 AAID만 사용해야 하며,추가적인 정보는 절대 포함하지 마세요.
  • 아래 형식을 반드시 준수해 주세요:
    • IDFA: 대문자(UPPERCASE)
    • AAID: 소문자(lowercase)
    • IDFV는 포함 금지 (NO IDFV)

CSV 파일 예시

3. 정보 공유 및 요청

작업이 완료되면, 이전에 선택한 Amazon S3 버킷 옵션에 해당하는 가이드라인을 준수하고, 함께 제공된 안내 절차를 따라 진행해 주세요.

• 귀사의 Amazon S3 버킷을 활용하는 경우:
  • 앱별 세그먼트 경로(Path)를 Remerge 담당자에게 제공해 주세요.
  • "Amazon S3 버킷에 연결하기" 단계에서 안내된 로그인 정보를 Remerge 담당자에게 함께 전달해 주세요.

• Remerge의 Amazon S3 버킷을 활용하는 경우:
  • 업로드할 디렉토리의 위치(예: remerge-customers/remerge-abcd12)에 해당하는 S3 Remerge 경로(Path)를 Remerge 담당자에게서 전달받으세요.
  • "Amazon S3 버킷에 연결하기" 단계에 명시된 로그인 정보를 Remerge 담당자로부터 받아 주세요.
• 파트너 전용 데이터가 있는 경우, 지정된 파트너 전용 경로(Partner Path)에 업로드해 주세요.
• 데이터 업데이트 주기를 반드시 Remerge 담당자에게 전달해 주세요.
• 세그먼트를 여러 파일로 분할하지 마세요.
• 업데이트마다 단일 파일만 업로드해 주세요.
  참고: Remerge 시스템은 해당 경로에서 가장 마지막으로 수정된 파일만 인식합니다.
  동시에 여러 파일을 업로드할 경우, 마지막 파일만 사용되고 나머지는 무시됩니다.

Amazon S3 버킷 경로 예시 (광고주)

• https://s3.amazonaws.com/remerge-customers/client/list-import/app/user-list.csv 

Amazon S3 버킷 경로 예시 (파트너)

참고: 외부 서드파티 데이터 파트너를 통해 리스트를 생성하는 경우, 선택한 파트너를 나타내는 별도의 폴더를 경로에 추가하실 것을 권장드립니다. 이 방식은 여러 파트너와 협업하거나 파트너 변경이 발생할 경우에도 유용하게 활용될 수 있습니다.

• https://s3.amazonaws.com/remerge-customers/client/list-import/partner/app/user-list.csv

URL

고유한 유저 세그먼트가 포함된 CSV 파일을 다운로드할 수 있는 URL을 Remerge에 제공하실 수 있습니다

1. 임포트용 유저 리스트 생성하기

• 파일이 다음 조건을 충족하는지 확인해 주세요:
  • 각 파일은 앱별 고유한 유저 세그먼트를 포함해야 합니다.
    (예: iOS 앱용 유저 세그먼트 또는 Android 앱용 유저 세그먼트)
    여러 유저 세그먼트를 하나의 파일에 혼합하지 마세요.
    
    
  • 각 파일에는 세그먼트별 디바이스 ID 목록이 CSV 형식으로 포함되어야 하며,
    추가적인 정보는 필요하지 않습니다.
  • 파일 내용은 특정 세그먼트에 해당하는 디바이스 ID로 정기적으로 업데이트되어야 합니다. 업데이트 주기를 반드시 Remerge 담당자에게 공유해 주세요.

2. URL 경로 (Path) 를 Remerge에 전달하기

• URL이 다음 조건을 충족하는지 확인해 주세요:
  • URL은 해당 파일로 직접 연결되어야 합니다. 파일의 위치는 방식의 성공 여부에 영향을 미치지 않으므로, 자유롭게 설정하셔도 됩니다.단, URL은 반드시 지정된 CSV 파일로 직접 연결되어야 하며, Remerge 시스템이 해당 URL을 호출할 때마다 최신 유저 CSV 파일이 수신되어야 합니다.
  • 각 URL에 대해 세그먼트 및 애플리케이션 식별 정보를 Remerge에 함께 제공해 주세요.
  • Remerge는 해당 경로에 접근하기 위해 비밀번호나 IP 화이트리스트 등록이 필요하지 않습니다. 만약 Remerge의 접근 허용이 필요할 경우, Remerge 담당자에게 연락하여 공용 IP 주소를 받아 주세요.

Audience Builder (Adjust)

Remerge는 Adjust의 Audience Builder 기능과의 연동을 통해 반복 유저 리스트 임포트를 자동화할 수 있습니다. 

참고: 이 기능은 특정 광고주 및 Adjust의 특정 요금제 사용자에게만 제공됩니다.

1. 기능 구현

• 기능 구현에 대한 단계별 안내는 Audience Builder 페이지를 참고해 주세요.

2. URL 경로 (Path) 전달

• 구성이 완료되면, 생성한 오디언스로 직접 연결되는 최종 URL과 함께 희망하는 타겟팅 전략에 대한 추가 정보를 Remerge에 전달해 주세요.

최종 URL 예시

• https://api.adjust.com/audience_builder/v1/data/6f98d163-ad56-01be-b6c5-f611b967ba19

Audiences (AppsFlyer)

Remerge는 Appsflyer의 Audience기능과의 연동을 통해 반복 유저 리스트 임포트를 자동화할 수 있습니다. 

참고: 이 기능은 특정 광고주 및 Appsflyer의 특정 요금제 사용자에게만 제공됩니다.

1. 기능 구현

• 기능 구현에 대한 단계별 안내는 Audience 페이지를 참고해 주세요.

2. URL 경로 (Path) 전달

• 구성이 완료되면, 생성한 오디언스로 직접 연결되는 최종 URL과 함께 희망하는 타겟팅 전략에 대한 추가 정보를 Remerge에 전달해 주세요.

최종 URL 예시

• https://s3.amazonaws.com/remerge-customers/client/list-import/app/user-list.csv