設定商店銷售資料的格式

商店銷售資料的格式必須正確無誤，並符合我們的顧客數位資料政策。本文將說明如何設定商店銷售資料檔案的格式。

本文內容

新增商店銷售資料
設定商店銷售資料檔案格式
設定欄標題格式
瞭解顧客交易資料格式規範

事前準備

在 Excel、CSV 或 Google 試算表檔案中加入您的資料。如果您在設定資料方面需要協助，請使用下列範本：

基本格式規範

為保護顧客的交易資訊安全，商店銷售資料中的顧客名稱、電子郵件地址和電話號碼必須經過雜湊處理。您可以使用 SHA-256 演算法 (此為單向雜湊的業界標準) 自行雜湊處理資訊，或讓 Google Ads 對商店銷售資料進行雜湊處理。
請注意，如果超過檔案大小限制，可能會導致檔案無法上傳。
- 一次直接上傳到 Google Ads 帳戶：
  - 150 MB：僅限在 Google Ads 中以手動上傳的 CSV 檔案，估計有 300,000 個交易列。
  - 50 MB：所有其他格式，包括排程上傳的 CSV，估計有 100,000 個交易列。
- 如果使用 Google Ads API 上傳資料：每次上傳以 100 萬列資料為限。為達到最佳處理效率，建議使用 OfflineUserDataJobService 建立工作，並使用 AddOfflineUserDataJobOperations 方法在工作中分批加入交易資料 (每次 1 萬列)。您可以並行建立多項上傳工作，加快將資料列送交處理的速度。
  
  注意：如果您委託商店銷售資料合作夥伴代為上傳資料，請洽詢對方瞭解他們的檔案大小限制。

如有 Google Ads API 相關的技術問題 (例如與 API 或 SDK 使用情形直接相關的問題、API 或 SDK 收到的錯誤等)，請使用 API 技術支援頁面中的疑難排解步驟操作。

如果對與 Google Ads 使用者介面相關的 Google Ads API 有任何疑問，請點選頁面底部的「與我們聯絡」。

欄標題格式規範

請務必在商店銷售資料檔案中加入這 2 個標題列：一個包含上傳中繼資料，另一個則包含顧客交易欄名稱。

注意：請確保商店銷售資料檔案中的欄標題與指定的英文名稱完全相符。資料的其他內容可以使用任何語言，但是欄標題必須是英文。

上傳中繼資料

第一列包含上傳中繼資料。

注意：如果您使用自訂變數功能，請將這一列的欄標題格式設為：

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

請注意，自訂變數必須處於有效狀態，才能使用。

請在括號中填入每個參數所需提供的資訊：

LoyaltyRate 和 TransactionUploadRate 值應設為 1。

顧客交易中繼資料

第二列包含您要上傳的顧客交易相關資訊，例如電子郵件地址、電話號碼和姓名。您可以在顧客交易資訊的第二列中加入的欄標題包括：

Email
名字
Last Name
City
State
Zip
Country
Phone Number
Conversion Name (必填)
Conversion Time (必填)
Conversion Value (必填)
Conversion Currency (必填)
廣告使用者資料 (如果針對歐洲經濟區使用者將商店銷售資料用於目標顧客比對)
廣告個人化 (如果針對歐洲經濟區使用者將商店銷售資料用於目標顧客比對)

上傳時，必須提供至少一個電子郵件地址、電話號碼或地址。每位顧客最多可加入 3 個電子郵件地址和 3 組電話號碼。如要為每個顧客加入多個電子郵件地址和電話號碼，請在商店銷售資料檔案中新增 3 個「Email」欄和 3 個「Phone Number」欄。

下一節將說明如何設定商店銷售資料的格式。

資料格式規範

全部展開

您提供的顧客交易資訊格式設定必須正確，Google Ads 才能上傳資料。部分顧客交易資訊必須使用 SHA-256 演算法進行雜湊處理，包括：

顧客電子郵件地址
顧客電話號碼
顧客姓名

其他顧客交易資料 (例如居住國家/地區、郵遞區號和屬性資料) 則不需要雜湊處理。

如要開始，請先下載 Excel、CSV 或 Google 試算表範本，然後輸入顧客交易資訊。如有部分顧客交易資訊無法雜湊處理，請使用 CSV 範本。Google Ads 會在您上傳填寫完成的 CSV 範本時，自動對需要雜湊處理的資料進行雜湊處理。

展開以下區段，查看範本中各資料欄的相關規範。資料欄名稱應與範本中所列名稱完全相同。

Time zone

如果所有的轉換時間都屬於同一個時區，請加入第一列
- 如果轉換時間分屬不同時區，請在「Conversion Time」欄中為每個轉換時間新增時區。請參閱本文「Conversion Time」一節中的操作說明和表格。
- 如果您同時在第一列和「Conversion Time」欄中輸入時區，上傳時，系統會優先採用「Conversion Time」欄中的時區；如果轉換沒有註明時區，才會採用第一列的時區。
為避免日光節約時間轉換錯誤，建議輸入這份清單中的時區 ID。
請輸入「+」或「-」加上 4 位數的時差來代表格林威治中央標準時間 (GMT) 時差。如果是 GMT，請輸入 +0000。

例如：

America/New_York-0500
Europe/Berlin+0100

Loyalty rate

以資料檔案中的整體銷售額而言，能夠與顧客產生關聯的銷售額所占的比例
建議將此值保留為「1」

Transaction upload rate

目前，交易上傳率值不會影響商店銷售報表。建議您上傳與顧客相關聯的所有銷售資料，並將交易上傳率設為「1」。

例如：

為所有電子郵件地址加上網域名稱 (例如 gmail.com 或 hotmail.co.jp)。
移除電子郵件地址中的所有空格。
全部輸入小寫字母
每位顧客最多可輸入 3 個電子郵件地址 (共 3 個「Email」欄，每欄輸入 1 個)

例如：

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」欄，每欄輸入 1 個)

例如：

+12038271234
+442071838750

Conversion name

您要匯入的轉換動作名稱
拼寫和大小寫必須與 Google Ads 帳戶中的轉換動作一致

例如：

SS_customer_signups
SS_customer_purchases

Conversion time

請使用系統接受的日期格式 (請參閱下表)。
- 如要為轉換時間設定時區，請參閱下表中最後 4 種格式。
- 以 GMT 時差 (「+」或「-」加上 4 位數的時差) 取代「+z」。
- 也可以使用時區 ID 取代「zzzz」。

格式	範例
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"