设置实体店销售数据的格式

实体店销售数据必须采用正确的格式，并符合我们的客户数据政策。本文介绍了在设置实体店销售数据文件的格式时需遵循的准则。

本文包含的主题

添加实体店销售数据
设置实体店销售数据文件的格式
设置列标题的格式
了解客户交易数据格式设置准则

准备工作

将数据添加到 Excel、CSV 或 Google 表格文件中。如果您在设置数据方面需要帮助，请使用以下模板：

格式设置基本准则

为了确保客户交易信息的安全，您需要对实体店销售数据中的客户姓名、电子邮件地址和电话号码进行哈希处理。您可以自行使用 SHA-256 算法（业界标准的单向哈希处理算法）对信息进行哈希处理，也可以让 Google Ads 使用该算法对您的实体店销售数据进行哈希处理。
请注意，如果您的文件超出文件大小限制，可能无法成功上传。
- 直接将文件一次性上传到您的 Google Ads 账号中：
  - 150MB：仅适用于手动在 Google Ads 中上传的 CSV 文件（估计有 30 万行交易数据）。
  - 50MB：适用于所有其他文件格式，包括根据安排定期上传的 CSV 文件（估计有 10 万行交易数据）。
- 如果您要使用 Google Ads API 上传：每次上传作业不超过 100 万行交易数据。您应使用 OfflineUserDataJobService 创建上传作业，并使用 AddOfflineUserDataJobOperations 方法将交易数据批量（每次 1 万行）添加到作业中，以便系统进行优化处理。您可以同时创建多个上传作业，以提高您提交数据行供系统处理的速率。
  
  注意：如果您通过实体店销售数据合作伙伴上传数据，请与您的实体店销售数据合作伙伴联系，了解他们在上传实体店销售数据方面的限制。

如果您有关于 Google Ads API 的技术问题（例如，与 API 或 SDK 使用直接相关的问题、通过 API 或 SDK 收到的错误，等等），请使用 “API 技术支持”页面中的问题排查步骤。。

如果您有关于 Google Ads API 的问题，特别是与 Google Ads 界面相关的问题，请点击页面底部的“与我们联系”。

列标题格式设置准则

您的实体店销售数据文件中必须具有 2 个标题行：一行用于上传元数据，另一行包含客户交易列名称。

注意：请确保实体店销售数据文件中的列标题与以英文指定的名称完全相同。其余数据可以采用任何语言，但列标题必须为英文。

上传元数据

第一行包括上传的元数据。

注意：如果您使用的是自定义变量功能，则您应将此行中的列标题的格式设置为如下形式：

Parameters:TimeZone=<insert_TZ>;LoyaltyRate=<insert_rate>;TransactionUploadRate=<insert_rate>;CustomVariable=<insert_name>

请注意，您的自定义变量应处于有效状态才能使用。

在尖括号中，您需要为每个参数添加请求的信息：

LoyaltyRate 和 TransactionUploadRate 的值应设置为 1。

客户交易元数据

第二行包含与您要上传的客户交易相关的信息，例如电子邮件地址、电话号码和姓名。以下是您可以添加到第二行的客户交易信息相关列标题：

Email
First Name
Last Name
City
State
Zip
Country
Phone Number
Conversion Name（必需）
Conversion Time（必需）
Conversion Value（必需）
Conversion Currency（必需）
Ad User Data（如果针对欧洲经济区 (EEA) 用户将实体店销售数据与目标客户匹配结合使用）
Ad Personalization（如果针对欧洲经济区 (EEA) 用户将实体店销售数据与目标客户匹配结合使用）

上传时，至少需要提供一个电子邮件地址、电话号码或地址。您最多可以为每位客户添加 3 个电子邮件地址和 3 个电话号码。如果您想要为每位客户添加多个电子邮件地址和电话号码，请在实体店销售数据文件中添加 3 个“Email”列和 3 个“Phone Number”列。

在下一部分中，您将了解如何设置实体店销售数据的格式。

数据格式设置准则

全部展开

您提供的客户交易信息必须进行正确的格式设置，以便 Google Ads 能够上传数据。某些客户交易信息需要使用 SHA-256 算法进行哈希处理，其中包括：

客户电子邮件地址
客户电话号码
客户的名字和姓氏

其他客户交易数据（例如，所在国家/地区、邮政编码和属性数据）不需要进行哈希处理。

要开始进行哈希处理，请下载 Excel、CSV 或 Google 表格模板，然后输入您的客户交易信息。如果您无法对某些客户交易信息进行哈希处理，请使用 CSV 模板。您上传填写好的 CSV 模板后，Google Ads 会自动对需要进行哈希处理的任何数据进行哈希处理。

展开下面的相应部分，可查看有关模板中每一列的准则。列名称应与您模板中输入的列名称完全一致。

Time zone（时区）

如果所有转化时间都在同一个时区内，请在第一行中添加时区
- 如果转化时间处于不同时区，请在“Conversion Time”列中为每个转化时间添加时区。请参阅本文“Conversion Time”部分中的操作说明和表格。
- 如果您在第一行和“Conversion Time”列中都输入了时区，则在上传时系统会优先考虑“Conversion Time”列；如果转化缺少时区，则系统会使用第一行中的时区值。
根据此列表输入您的时区 ID，以避免在夏令时转换期间出现错误。
通过“+”或“-”表示您与格林尼治标准时间的时差，然后输入 4 位数格式的具体时差。如果您使用格林尼治标准时间，请输入 +0000。

例如：

America/New_York-0500
Europe/Berlin+0100

Loyalty rate（忠诚率）

数据文件中可以与客户关联起来的总销售交易次数所占的百分比
我们建议将此值保留为“1”

Transaction upload rate（交易上传率）

目前，交易上传率的值不会影响实体店销售报告。我们建议您上传所有与客户相关的销售数据，并将交易上传率设置为“1”。

例如：

Email（电子邮件）

所有电子邮件地址都必须有域名，例如 gmail.com 或 hotmail.co.jp。
移除电子邮件地址中的所有空格。
全部为小写字母
最多可为每位客户提供 3 个电话号码，分别放在 3 个“Email”列中进行分隔

例如：

user1@gmail.com
user2@yahoo.com

First name（名字）

全部为小写字母
允许使用重音符号。
移除名字前、中、后的任何不必要空格。

例如：

tom
renée
marie-astrid

Last name（姓氏）

全部为小写字母
允许使用重音符号。
移除名字前、中、后的任何不必要空格。

例如：

gupta
o'calloway
cox-cohen
mcdonnell

City

全部为小写字母
允许使用重音符号。

例如：

san francisco
new york city
paris
munich

State（州/省/自治区/直辖市）

全部为小写字母
- 例外情况：双字母的美国州名缩写

例如：

CA
california
new york
maharastra

Zip（邮编）

美国邮政编码和国际邮政编码均可使用。
对于美国：
- 可以使用 5 位数的邮政编码。
- 也可以使用 5 位基础邮编加 4 位扩展邮编的格式，这样可提高您的匹配率。
对于所有其他国家/地区：
- 请勿包含扩展邮政编码。

例如：

94109
94109-1234
W1J 0BH

Country（国家/地区）

使用由两个字母构成的 ISO 国家/地区代码。
即使您的所有客户数据都来自同一个国家/地区，也请添加国家/地区代码

例如：

Phone number（电话号码）

电话号码的格式应根据 E.164 标准设置，即：包含“+”前缀，后跟国家/地区代码和用户号码；可能包含国内目的地代码或区号。
最多可为每位客户提供 3 个电话号码，分别放在 3 个“Phone Number”列中进行分隔

例如：

+12038271234
+442071838750

Conversion name（转化名称）

您要导入的转化操作的名称
必须与您 Google Ads 账号中转化操作的拼写和大小写一致

例如：

SS_customer_signups
SS_customer_purchases

Conversion time（转化时间）

请使用可接受的日期格式（详见下面的表格）。
- 如需为转化时间添加时区，请参阅下表中最后列出的 4 种格式之一。
- 请通过 + 或 - 将“+z”替换为您与格林尼治标准时间的时差，然后输入 4 位数格式的具体时差。
- 或者，您也可以将“zzzz”替换为时区 ID。

格式	示例
MM/dd/yyyy hh:mm:ss aa	“08/14/2020 5:01:54 PM”
MMM dd,yyyy hh:mm:ss aa	“Aug 14, 2020 5:01:54 PM”
MM/dd/yyyy HH:mm:ss	“08/14/2020 17:01:54”
yyyy-MM-dd HH:mm:ss	“2020-08-14 13:00:00”
yyyy-MM-ddTHH:mm:ss	“2020-08-14T13:00:00”
yyyy-MM-dd HH:mm:ss+z	“2020-08-14 13:00:00+0500”
yyyy-MM-ddTHH:mm:ss+z	“2020-08-14T13:00:00-0100”
yyyy-MM-dd HH:mm:ss zzzz	“2020-08-14 13:00:00 America/Los_Angeles”
yyyy-MM-ddTHH:mm:ss zzzz	"2020-08-14T13:00:00 America/Los_Angeles"