批次新增概覽

匯入使用者 (批次上傳) 功能讓企業管理員得以建立包含使用者身分的檔案,並將此檔案提交給企業客戶管理員使用者管理頁面進行處理。檔案中的每個項目代表一位使用者,而處理結果就是讓每位使用者擁有一個已建立的帳戶。由於可能涉及數以千計的帳戶,系統會將處理狀態和進度顯示出來,您可以隨時取消處理該檔案。

由於客戶向 Adobe 購買授權合約來建立企業帳戶,客戶因而對不同 Adobe 產品享有特定數量的授權。在完成購買交易時,Adobe 的專員會為該組織建立帳戶,並授予一名使用者管理該帳戶的權限。該名管理員可以為該組織成員建立及管理使用者帳戶。

註解:

「匯入使用者」功能不支援含有特殊字元的使用者暱稱,例如逗號 (,) 和分號 (;)。

函式

選取要處理的檔案後,系統會進行以下的預先檢查,並在檢查失敗時發出錯誤訊息。

  • CSV 格式的檔案
  • 合法的標題 (如果有的話)
  • 1-5000 個項目

各個項目須符合以下條件:

  • 合法的電子郵件地址
  • 零或多個指定產品設定
  • 國家或地區 (如果有的話) 為合法且為 Adobe 有業務往來的國家或地區
  • 合法的選項 (如果有的話)

每個檔案只能包含 5000 個項目,這是每筆匯入作業可以處理的最大值。

處理檔案時,每個項目會依以下程序個別處理:

電子郵件地址網域為

動作

例外

由組織取得,並受 Adobe 管理 以指定電子郵件地址建立 Adobe ID 帳戶。送出歡迎郵件。

已經有邀請在處理中,或是已有使用指定電子郵件地址的帳戶。

國家或地區 (如果有的話) 並未開放 Adobe 業務。

產品設定不合法或是超過配額。

由組織取得,並受企業管理 已使用指定使用者名稱建立個人記錄。新增至指定產品設定。電子郵件地址僅用來判定網域,除此之外並不使用。未傳送電子郵件。

使用者名稱已存在。

國家或地區 (如果有的話) 並未開放 Adobe 業務。

產品設定不合法或是超過配額。

非由組織取得

將邀請郵件寄送至使用者電子郵件地址。未建立任何帳戶。該邀請與列出的產品設定有關。

如果帳戶已存在,則新增至產品設定。

已有邀請或是有使用指定電子郵件的帳戶。

國家或地區 (如果有的話) 並未開放 Adobe 業務。

完成處理所有檔案項目時,系統會產生一封電子郵件訊息給啟動此程序的使用者,通知他們已完成處理,並提供處理結果摘要。

匯入作業一經取消,就可能會立即停止處理。已完成的處理無法復原。

使用者介面

在管理控制台的「列出使用者」面板上,有一個上傳使用者檔案的圖示。檔案類型必須是「csv」,且字尾為 .csv。檔案格式如下所述。

在選取匯入後,會有一個對話方塊顯示指示、下載範例檔案的連結,以及用於瀏覽和選取要上傳及處理檔案的連結。

一旦選好要處理的檔案,系統會預先檢查有效性,並回報任何可偵測到的錯誤。如果沒有任何錯誤,該檔案會儲存在伺服器上,並開始進行處理。任何一個特定組織 (不論其網域為何) 只能進行一項匯入作業,因此,後續的匯入作業將會停止啟動,直到第一項匯入作業完成為止。

在接受處理後,「列出使用者」面板的「匯入結果」標籤中會顯示一行訊息。這個項目顯示以下內容:

  • 檔案名稱
  • 上傳和開始處理的日期/時間
  • 狀態 (處理中/已完成/已取消) (定期更新)
  • 已建立的帳戶數 (定期更新)
  • 錯誤數 (定期更新)
  • 處理速率 (項目/每秒) (定期更新)
  • 預估剩餘時間 (定期更新)
  • 取消作業的控制項 (僅限處理正在進行中)
  • 報告的連結 (處理完成後)
  • 刪除項目的控制項 (處理完成後)

當狀態為已完成或已取消時,按一下檔案名稱,畫面上會隨即彈出報告視窗,提供詳細的處理資料。成功數和各類失敗都會摘要顯示。系統只會顯示非零的數值。

在開始處理後,任何已建立的使用者會開始顯示在「有效使用者清單」(如果有顯示) 或是更新計數 (如果有顯示)。

在開始處理後,已產生的使用者邀請會顯示在「擱置中的邀請」清單 (如果有顯示) 或是更新計數 (如果有顯示)。

處理結束時會產生報告,顯示每個項目的處理結果。報告共有 3 欄:

  • 行號
  • 電子郵件地址
  • 狀態和錯誤訊息 (如果有的話)

報告會根據與 csv 檔案中的原始行數相對應的行數和行號來排序。

重要:「匯入結果」頁面會顯示 90 天內的報告。超過 90 天的報告會自動移除,無需系統管理員介入。

檔案格式

列出使用者的檔案必須遵循 RFC 4180 (CSV 檔案規格)。標題行 (如果有的話) 必須包含以下內容:

Type、Email、ProductConfigurations、user name、CountryCode、FirstName、LastName、Options

注意: 這些欄位可能會定期變更。請確定您的標題與 Admin Console 的最新範例相符。

這些欄位的定義如下:

欄位

語法

解釋

Type 其中一個 Adobe ID、Enterprise ID 或 Federated ID 值。 這些值控制指派給使用者的 ID 類型。不區分大小寫。ID 類型必須是網域可支援。
Email

RFC 2822 sec 3.4.1

最多 60 個字元

名稱和網域。如為企業管理的網域,則只使用網域名稱。使用者名稱決定帳戶名稱。如為其他帳戶類型,則以電子郵件地址做為使用者和帳戶名稱。
ProductConfigurations 以逗號分隔的產品設定別稱清單 您想要指派使用者的產品設定別稱。您可以對使用者一次指派多項產品設定;請以逗號分隔設定名稱。例如,「受眾管理: Audience Manager - 預設存取、僅限自訂計劃 - 自訂計劃 - 設計」
User name 任何字串。僅限 ASCII。 僅限用於企業管理的網域。供這名使用者使用的帳戶名稱。網域擁有者可以就電子郵件地址規定限制條件,並要求使用同一個電子郵件地址。長度上限為 255 個字元
CountryCode ISO 3166-1 alpha-2 Country Codes 這是兩個字母的國碼 (例如美國 =「US」) 請檢查並確認使用者所在國家或地區 (如果有的話) 為 Adobe 可以合法經營業務的國家或地區。企業管理帳戶必須顯示此欄位。
FirstName 字串 長度上限為 255 個字元
LastName 字串 長度上限為 255 個字元
Options

以逗號分隔名稱清單。這個欄位可供未來使用

預計未來值:

NoEmail: 禁止寄送帳戶的歡迎郵件。

ResetPassword: 標示重設密碼的帳戶。

下載

疑難排解批次上傳問題

本節協助您疑難排解透過 Adobe 管理控制台使用批次匯入功能時的錯誤情形或可能出現的其他問題。

「無效設定名稱」錯誤

如果您收到「無效設定名稱」的錯誤 (「INVALID_CONFIGURATIONS」),請在管理控制台中檢查產品設定:

  • 如果產品設定是「預設設定」,這是用來做為範例的虛擬設定。您必須編輯這個設定,將它轉換為實際可用的產品設定。
  • 如果您建立新的產品設定,則「預設設定」會消失。
  • 編輯產品設定或建立新設定後,請重新嘗試批次匯入。

驗證 CSV 格式

如要驗證您的 CSV 檔案,請與控制面板中的範例範本作比較。重要的欄位包括名字、姓氏、使用者 ID、電子郵件地址和國碼。

如果使用者存在,則匯入不會失敗。而您會在批次上傳報告中看到使用者存在的訊息。

上傳報告會與現有使用者警告分開列出其他錯誤訊息。

匯入錯誤

不同類型使用者 ID 的必填欄位:

Type Email ProductConfigurations User name 國碼 FirstName LastName Options
Adobe ID 必要 可選 可選 可選 可選 可選 可選
Enterprise ID 必要 必要 可選 可選 可選 可選 可選
Federated ID 必要 必要 必要 必要 可選 可選 可選

已知問題

批次匯入報告中的匯入錯誤訊息的右側目前遭到截斷。管理控制台會在未來的版本中修正這個問題。

匯入錯誤情形、訊息和回應代碼

 

狀況

訊息

注意

CSV 檔案的標題行無效

 

CSV 檔案中有無效的標題行。標題行必須為

Type、Email、ProductConfigurations、user name、CountryCode、FirstName、LastName、Options

 

上傳時遭到拒絕匯入,無法執行批次匯入。

CSV 檔案的標題行遺失

 

CSV 檔案中有無效的標題行。標題行必須為

Type、Email、ProductConfigurations、user name、CountryCode、FirstName、LastName、Options

 

上傳時遭到拒絕匯入,無法執行批次匯入。

標題行的欄數不正確 第 2 行的檔案格式無效: 如需說明,請參閱範例。csv 檔案行的欄數錯誤 上傳時遭到拒絕匯入,無法執行批次匯入。
資料行的欄數不正確

第 2 行的檔案格式無效: 如需說明,請參閱範例。csv 檔案行的欄數錯誤

上傳時遭到拒絕匯入,無法執行批次匯入。
CSV 或資料行 1 沒有資料行,且遺失標題行 無效的檔案。至少新增一名使用者至檔案,然後再試一次。如需說明,請參閱範例。  上傳時遭到拒絕匯入,無法執行批次匯入。
輸入值無效

第 2 行的檔案格式無效: 身分類型必須是 Adobe ID、Enterprise ID,或 Federated ID。(行號 2)

上傳時遭到拒絕匯入,無法執行批次匯入。
電子郵件地址無效

第 2 行的檔案格式無效: 需要有效的電子郵件地址。(行號 2)

上傳時遭到拒絕匯入,無法執行批次匯入。
電子郵件地址屬於其他網域 參見下方  
國碼無效: 非兩個字母 第 2 行的檔案格式無效: 國碼必須遵守 ISO 3166-1 alpha-2 (2 字元國碼)。(行號 2) 上傳時遭到拒絕匯入,無法執行批次匯入。必須是合法且為 Adobe 有業務往來的國家或地區。
國碼已遭禁止使用 (例如 KP) 無效的國碼。 在報告和摘要中顯示為訊息。
國碼為兩個字母,但並非有效代碼 (例如 AB) 無效的國碼。 在報告和摘要中顯示為訊息。
Firstname 或 Lastname 或 user name 或 Options 太長 (超過 255 個字元) 第 3 行的檔案格式無效: 字串超過 255 個字元。(行號 3) 上傳時遭到拒絕匯入,無法執行批次匯入。
使用者名稱不是電子郵件地址 無效的使用者名稱。

這視授權來源是否需要此項目而定。

也會顯示在摘要中。

使用者名稱和電子郵件地址必須相符 無效的使用者名稱。此組織的使用者名稱和電子郵件地址必須相符

這視授權來源是否需要此項目而定。

無效的使用者名稱。在摘要中顯示

電子郵件地址不在適當的網域內 並未擁有電子郵件網域。這個使用者受其他組織管理或為不同類型。 電子郵件網域不是擁有者。顯示在摘要中。
Options 欄位包含不合法的值   目前沒有檢查或訊息
內部錯誤 內部錯誤: <字串>  
使用者已受邀 已經受邀為 Adobe ID 使用者。邀請已送出。 第一部分顯示在摘要中。
使用者已在組織內 已經與組織相關聯。使用者 <xxx> 已經與貴組織相關聯。 第一部分顯示在摘要中。
不支援的編碼   編碼為不支援的類型。

一些特別的個案:

組織網域和類型

先決條件

動作

預期

訊息

d3 為 Type3 所取得 使用者 u@d3 存在 Type3 新增 u@d3 為 Type1 錯誤 已經與組織相關聯。此使用者存在
  任一 新增 u@d3 為 Type2 錯誤 並未擁有電子郵件網域。這個使用者受其他組織管理或為不同類型。
  使用者 u@d3 存在 Type3 新增 u@d3 為 Type3 錯誤 已經與組織相關聯。使用者 u@d3 已經與貴組織相關聯。
  使用者 u@d3 存在組織的 Type1 新增 u@d3 為 Type1 錯誤 已經與組織相關聯。使用者 u@d3 已經與貴組織相關聯。
  使用者 u@d3 存在組織的 Type1 新增 u@d3 為 Type3 錯誤 已經與組織相關聯。使用者 u@d3 已經與貴組織相關聯。
 

使用者 u@d3 已邀請 Type1

u@d3 不存在

新增 u@d3 為 Type1 錯誤 已經受邀為 Adobe ID 使用者。邀請已送出。 
 

使用者 u@d3 已邀請 Type1

u@d3 不存在

新增 u@d3 為 Type3 錯誤 已經受邀為 Adobe ID 使用者。邀請已送出。 
 

使用者 u@d3 已邀請 Type1

u@d3 在邀請後已建立 Type1

新增 u@d3 為 Type1 錯誤 已經受邀為 Adobe ID 使用者。邀請已送出。 
 

使用者 u@d3 已邀請 Type1

u@d3 在邀請後已建立 Type1

新增 u@d3 為 Type3 錯誤

已經受邀為 Adobe ID 使用者。邀請已送出。 

 

 

使用者 u@d3 已邀請 Type1

u@d3 在邀請前已建立 Type1

新增 u@d3 為 Type1 錯誤 已經受邀為 Adobe ID 使用者。邀請已送出。 
 

使用者 u@d3 已邀請 Type1

u@d3 在邀請前已建立 Type1

新增 u@d3 為 Type3 錯誤 已經受邀為 Adobe ID 使用者。邀請已送出。 
  使用者 u@d3 存在 Type1 (不在組織) 新增 u@d3 為 Type3 成功  
  d2 非此組織所取得

新增 u@d2 為 Type3

錯誤 並未擁有電子郵件網域。這個使用者受其他組織管理或擁有不同使用者類型。
         
d2 為 type 2 所取得 使用者 x@y 已邀請 Type2 至 d2 新增 x@y 為 Type1 錯誤 已經受邀為 Adobe ID 使用者,已送出邀請。
  任一 新增 u@d3 為 Type2 錯誤 並未擁有電子郵件網域。這個使用者受其他組織管理或為不同類型。
  任一 新增 x@y 為 Type3 錯誤 並未擁有電子郵件網域。這個使用者受其他組織管理或為不同類型。
         

效能詳細資訊

為避免超載,66.6% 的工作週期規則會放入處理程序中。如果處理一個項目的時間與累計平均相差超過 10%,則會調整節流,使要求處理只耗費 2/3 的實際時間。

此外,由作業團隊管理的節流控制也會限制處理速率。如果明確設定了節流控制,則會停用工作週期控制。有個 API 呼叫可切換回以工作週期為基礎的節流。

系統會顯示每秒處理的要求數,為您提供關於效能的反饋。

建立 1000 個帳戶並將每個帳戶新增至 2 項產品設定的目標速率是 1 個帳戶/秒,66.6% 的工作週期不列入計算,所以表面處理速率即為 .66 帳戶/秒,或大約 40 個帳戶/分。按照這個速率建立 1000 個帳戶將需要 25 分鐘。按照這個速率建立 5000 個帳戶將需要 2 小時 5 分鐘。

此産品由 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 授權  Creative Commons 條款未涵蓋 Twitter™ 與 Facebook 文章。

法律說明   |   線上隱私權政策