주문 내역 데이터

프로스펙팅(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