实体店销售数据必须采用正确的格式,并符合我们的客户数据政策。本文介绍了在设置实体店销售数据文件的格式时需遵循的准则。
本文包含的主题
准备工作
将数据添加到 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 账号中:
如果您有关于 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。
客户交易元数据
第二行包含与您要上传的客户交易相关的信息,例如电子邮件地址、电话号码和姓名。以下是您可以添加到第二行的客户交易信息相关列标题:
- 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) 用户将实体店销售数据与目标客户匹配结合使用)
在下一部分中,您将了解如何设置实体店销售数据的格式。
数据格式设置准则
您提供的客户交易信息必须进行正确的格式设置,以便 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
- 数据文件中可以与客户关联起来的总销售交易次数所占的百分比
- 我们建议将此值保留为“1”
- 目前,交易上传率的值不会影响实体店销售报告。我们建议您上传所有与客户相关的销售数据,并将交易上传率设置为“1”。
例如:
- 0.5
- 0.2
- 0.8
- 所有电子邮件地址都必须有域名,例如 gmail.com 或 hotmail.co.jp。
- 移除电子邮件地址中的所有空格。
- 全部为小写字母
- 最多可为每位客户提供 3 个电话号码,分别放在 3 个“Email”列中进行分隔
例如:
- user1@gmail.com
- user2@yahoo.com
- 全部为小写字母
- 允许使用重音符号。
- 移除名字前、中、后的任何不必要空格。
例如:
- tom
- renée
- marie-astrid
- 全部为小写字母
- 允许使用重音符号。
- 移除名字前、中、后的任何不必要空格。
例如:
- gupta
- o'calloway
- cox-cohen
- mcdonnell
- 全部为小写字母
- 允许使用重音符号。
例如:
- san francisco
- new york city
- paris
- munich
- 全部为小写字母
- 例外情况:双字母的美国州名缩写
例如:
- CA
- california
- new york
- maharastra
- 美国邮政编码和国际邮政编码均可使用。
- 对于美国:
- 可以使用 5 位数的邮政编码。
- 也可以使用 5 位基础邮编加 4 位扩展邮编的格式,这样可提高您的匹配率。
- 对于所有其他国家/地区:
- 请勿包含扩展邮政编码。
例如:
- 94109
- 94109-1234
- W1J 0BH
- 电话号码的格式应根据 E.164 标准设置,即:包含“+”前缀,后跟国家/地区代码和用户号码;可能包含国内目的地代码或区号。
- 最多可为每位客户提供 3 个电话号码,分别放在 3 个“Phone Number”列中进行分隔
例如:
- +12038271234
- +442071838750
- 您要导入的转化操作的名称
- 必须与您 Google Ads 账号中转化操作的拼写和大小写一致
例如:
- SS_customer_signups
- SS_customer_purchases
- 请使用可接受的日期格式(详见下面的表格)。
- 如需为转化时间添加时区,请参阅下表中最后列出的 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" |
- 您为此次转化指定的价值,用数字表示
- 只接受正数
- 转化价值采用的币种
- 在下列两种情况下,您需要使用此列:以多币种报告转化价值,或有多个以不同币种进行结算的客户账号
- 请使用 3 个字符的 ISO 4217 货币代码
例如:
- USD
- JPY
- EUR
- 变量值与参数行中提及的自定义变量相关联。
- 上传文件中指定的变量值必须与您在 Google Ads 账号中定义的变量值一致。
- 如果您使用自定义变量,并且在参数中提到了自定义变量,请使用此列。
- 使用此列来指定与每笔交易相关联的变量值。
- 如果所上传交易的变量值与 Google Ads 账号中定义的变量值不一致,则系统会将与此类交易相关联的实体店销售转化数据报告为“未分类”。
例如:
- 自定义变量:“客户类型”
- 变量值:“新客户”或“回头客”
- 自定义变量:“产品类别”
- 变量值:“夹克”、“鞋”、“运动鞋”或“其他”
- 针对欧洲经济区 (EEA) 用户传送意见征求信号,以便衡量广告效果。
- 如果将目标客户匹配与实体店销售数据结合使用,则为必需项。
可能的值:
- 已获同意:用户同意使用数据
- 已被拒:用户不同意使用数据
- 未指定:未指定意见征求状态
例如:
- 已获同意
- 已被拒
- 针对欧洲经济区 (EEA) 用户传送意见征求信号,以便用于广告个性化功能。
- 如果将目标客户匹配与实体店销售数据结合使用,则为必需项。
可能的值:
- 已获同意:用户同意使用数据
- 已被拒:用户不同意使用数据
- 未指定:未指定意见征求状态
例如:
- 已获同意
- 已被拒