AppLovin Support

주문 내역 데이터

프로스펙팅(prospecting) 캠페인(신규 고객 유치)을 최적화하기 위해, AppLovin은 귀사의 주문 내역 데이터를 AppLovin에 제공할 것을 강력히 권장합니다. 이를 통해 AppLovin은 기존 고객의 정확한 모델을 구축하여 가치가 높은 새로운 사용자를 찾을 수 있습니다.

Shopify 사용자로서 AppLovin Shopify 앱을 설치하고 이를 Ads Manager 계정에 연결하셨다면, 모든 준비가 완료된 것입니다!

그렇지 않은 경우, 아래의 요구 사항에 따라 이 데이터를 CSV 형식으로 업로드하십시오.

AppLovin에 고객 데이터를 제공하는 것은 필요한 고지 및 동의를 포함하여 귀사 자체의 개인정보 보호 준수 요구 사항을 따릅니다.

파일 업로드 요구 사항

  • 파일 형식: CSV만 가능.
  • 파일 크기: 파일당 최대 파일 크기는 200 MB입니다.
  • 업로드 방법: 파일을 직접 업로드하거나 안전한 전송 방법(예: SFTP)을 통해 업로드할 수 있습니다.
  • 복수 파일: 여러 파일을 업로드할 수 있습니다. 각 새 파일의 데이터는 기존 백필 데이터에 추가됩니다.
  • 중복 제거: AppLovin은 transaction_id를 기준으로 주문을 자동으로 중복 제거합니다. AppLovin은 시스템에 이미 존재하는 transaction_id를 가진 데이터 행은 무시합니다. 단일 파일에 중복된 transaction_id를 가진 행이 존재하는 경우, AppLovin은 event_timestamp가 가장 빠른 행을 유지하고 나머지는 버립니다.

필드 사양

CSV 파일에는 아래에 나열된 필수 헤더가 모두 포함되어야 하지만, 특정 필드는 선택적으로 채울 수 있습니다.

열 순서는 상관없지만, 헤더 이름은 정확히 일치해야 합니다.

이벤트 기간: AppLovin은 사용 가능한 모든 주문 내역을 업로드할 것을 강력히 권장합니다.

필드값 필수 여부?유형설명
country_codeStringISO 3166 국가 코드US
currencyStringISO 4217 형식의 거래 통화 (3자리 코드)USD
emailString고객의 이메일 주소. 평문 이메일을 제공하십시오. AppLovin이 자체적으로 해싱합니다.customer@example.com
event_nameString반드시 purchase여야 합니다.purchase
event_timestampString구매가 발생한 시간
  • ISO 8601 형식 (UTC)
  • ISO 8601 형식 (오프셋)
  • Unix Timestamp
  • mm/dd/yyyy
  • 2025-11-10T15:30:00Z
  • 2025-11-10T15:30:00+01:00
  • 1459315678
  • 11/10/2025
transaction_idString주문의 고유 식별자 (예: 주문 ID, 체크아웃 ID). 이는 중복 제거에 매우 중요합니다.txn_12345
user_idString귀사의 내부 고객 ID.user_abc123
valueDouble거래의 총 가치. 0보다 크거나 같은 숫자여야 합니다. 통화 기호를 포함하지 마십시오.99.99
zip아니요String고객의 우편번호. 이는 해당 거래의 청구 우편번호여야 합니다. 미국 우편번호의 경우 처음 5자리만 포함하십시오.12345
idfv아니요String사용자의 IDFV.f325g3gb-12fc-352f-c6c3-dz52f0f690d8
ifa아니요String사용자의 광고 식별자. IDFA 또는 GAID 중 하나입니다.918f1d4f-d195-4a8b-af47-44683fe11db9
phone아니요String고객의 전화번호. 국가 코드를 포함해야 합니다 (예: +1). 평문 번호를 제공하십시오. AppLovin이 자체적으로 해싱합니다.+14155551234

AppLovin은 귀사가 제공하는 평문 이메일 주소와 전화번호를 해싱합니다.

직접 해싱을 수행하려는 경우, 다음 가이드라인을 주의 깊게 따르십시오.

email
앞뒤 공백을 제거합니다. 모든 대문자를 소문자로 변환합니다. 그 다음 SHA256을 통해 해싱합니다.
phone
앞뒤 공백을 제거합니다. 또한 앞에 붙은 0을 제거합니다. 대시, 플러스 기호 또는 기타 기호를 제거합니다. 문자를 해당하는 숫자로 변환합니다. 항상 국가 코드를 포함하십시오 (예: 미국 전화번호의 경우 1). 그 다음 SHA256을 통해 해싱합니다.

예시 (이메일 주소의 경우):

#include <iostream>
#include <string>
#include <iomanip>
#include <sstream>
#include <algorithm>
#include <openssl/sha.h>

std::string normalizeAndHash(const std::string& email) {
  std::string normalized = email;
  normalized.erase(0, normalized.find_first_not_of(" \t\n\r"));
  normalized.erase(normalized.find_last_not_of(" \t\n\r") + 1);
  std::transform(normalized.begin(), normalized.end(), normalized.begin(), ::tolower);

  unsigned char hash[SHA256_DIGEST_LENGTH];
  SHA256((unsigned char*)normalized.c_str(), normalized.size(), hash);

  std::ostringstream oss;
  for (int i = 0; i < SHA256_DIGEST_LENGTH; ++i)
    oss << std::hex << std::setw(2) << std::setfill('0') << (int)hash[i];
  return oss.str();
}

int main() {
  std::cout << normalizeAndHash(" John_Smith@gmail.com") << std::endl;
}

주요 유효성 검사 규칙

  • 헤더: 파일에는 위에 나열된 필수 헤더가 모두 포함되어야 합니다.
  • 식별자 요구 사항: 각 행에는 user_idemail이 포함되어야 합니다. AppLovin은 해당 열의 값이 누락된 행을 거부합니다.
  • 이벤트 이름: event_name 열이 존재해야 하며 그 값은 purchase여야 합니다.
  • 거래 가치: value 열에는 음수가 아닌 수(≥0)가 포함되어야 합니다.
  • 국가 코드: AppLovin은 다음 국가/지역의 고객과 관련된 주문 내역 데이터를 수락하지 않습니다.
    • AX — 올란드 제도
    • AD — 안도라
    • AT — 오스트리아
    • BE — 벨기에
    • DK — 덴마크
    • FO — 페로 제도
    • FI — 핀란드
    • FR — 프랑스
    • DE — 독일
    • GI — 지브롤터
    • GR — 그리스
    • GG — 건지
    • IS — 아이슬란드
    • IE — 아일랜드
    • IM — 맨섬
    • IT — 이탈리아
    • JE — 저지
    • LI — 리히텐슈타인
    • LU — 룩셈부르크
    • MT — 몰타
    • MC — 모나코
    • NL — 네덜란드
    • NO — 노르웨이
    • PT — 포르투갈
    • SM — 산마리노
    • ES — 스페인
    • SJ — 스발바르 및 얀마옌
    • SE — 스웨덴
    • CH — 스위스
    • GB — 영국

CSV 파일 예시

다음은 유효한 CSV 파일의 예시입니다.

event_name,user_id,phone,email,event_timestamp,value,currency,transaction_id,country_code,zip,idfv,ifa
purchase,user_abc123,+14155551234,user@example.com,2025-11-10T16:45:00Z,99.99,USD,txn_12345,US,12345,f325g3gb-12fc-352f-c6c3-dz52f0f690d8,918f1d4f-d195-4a8b-af47-44683fe11db9
purchase,user_def456,+14155555678,customer@example.com,2025-11-10T16:45:00Z,149.5,USD,txn_67890,US,12345,f325g3gb-12fc-352f-c6c3-dz52f0f690d8,918f1d4f-d195-4a8b-af47-44683fe11db9
purchase,user_ghi789,+14155559012,shopper@example.com,2025-11-10T17:20:00Z,75,EUR,txn_11223,US,12345,f325g3gb-12fc-352f-c6c3-dz52f0f690d8,918f1d4f-d195-4a8b-af47-44683fe11db9

search