订单历史数据

为了优化 prospecting campaigns(获取新客户的广告活动),AppLovin 强烈建议您向 AppLovin 提供订单历史数据。 这使 AppLovin 能够为您现有的客户建立精确的模型,从而寻找新的高价值用户。

如果您是安装了 AppLovin Shopify 应用并将其连接到您的 Ads Manager 账户的 Shopify 用户,那么您已经准备就绪!

否则,请按照以下要求以 CSV 格式上传此数据。

向 AppLovin 提供客户数据受您自身的隐私合规要求的约束,包括任何必要的告知和同意。

文件上传要求

  • File format: 仅限 CSV。
  • File size: 每个文件最大为 200 MB。
  • Upload method: 您可以直接上传文件,也可以通过安全传输方式(例如 SFTP)上传。
  • Multiple files: 您可以上传多个文件。 每个新文件中的数据都将添加到您现有的回填数据中。
  • Deduplication: AppLovin 会根据 transaction_id 自动对订单进行去重。 AppLovin 会忽略系统中已存在相同 transaction_id 的任何数据行。 如果单个文件中存在具有重复 transaction_id 的行,AppLovin 将保留 event_timestamp 最早的一行,并丢弃其余行。

字段规范

您的 CSV 文件必须包含下面列出的所有必需表头,但某些字段是可选填充的。

列的顺序无关紧要,但表头名称必须完全匹配。

Event window: AppLovin 强烈建议您上传所有可用的订单历史记录。

字段是否必需?类型描述示例值
country_codeStringISO 3166 国家/地区代码US
currencyStringISO 4217 格式的交易货币(3 位字母代码)USD
emailString客户的电子邮件地址。请提供明文电子邮件;AppLovin 将在后台对其进行哈希处理。customer@example.com
event_nameString必须为 purchasepurchase
event_timestampString购买发生的时间
  • ISO 8601 格式 (UTC)
  • ISO 8601 格式(带偏移量)
  • Unix 时间戳
  • 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
zipString客户的邮政编码。这必须是交易的账单邮政编码。对于美国邮政编码,仅包含前五位数字。12345
idfvString用户的供应商标识符。f325g3gb-12fc-352f-c6c3-dz52f0f690d8
ifaString用户的广告主标识符。这可以是 IDFA 或 GAID。918f1d4f-d195-4a8b-af47-44683fe11db9
phoneString客户的电话号码。必须包含国家/地区代码(例如 +1)。请提供明文号码;AppLovin 将在后台对其进行哈希处理。+14155551234

AppLovin hashes plaintext email addresses and phone numbers that you provide.

If you would prefer to perform your own hashing, do so by carefully following these guidelines:

email
Remove any leading or trailing whitespace. Convert any uppercase characters to lowercase. Then hash via SHA256.
phone
Remove any leading or trailing whitespace. Also remove any leading zeros. Remove any dashes, plus-signs, or other symbols. Convert any letters to their numerical counterparts. Always include the country code (for example, 1 for United States phone numbers). Then hash via SHA256.

For example (for email addresses):

#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