在此頁面上：瞭解如何設定讀取對象活動，以隨選或依排程將Adobe Experience Platform對象的設定檔帶入歷程，並個人化每個設定檔的路徑。
使用「讀取對象」活動，以定義對象開始歷程。 您選擇對象及其執行時間；然後使用條件、計時器和動作來個人化每個設定檔的路徑。
關於讀取客群活動 about-segment-trigger-activity
讀取對象活動是歷程進入點活動，會將選定Adobe Experience Platform對象的所有設定檔新增至歷程。 您可以執行一次入口，或依週期性排程執行。 在API和技術參考中，此活動也稱為區段觸發或受眾型歷程專案。
何時使用讀取對象與對象資格
- 每週電子報→讀取對象。 您的對象是每日批次快照。 您排程每個星期一上午9點的歷程。 所有合格的設定檔會一起輸入。
- 忠誠度層級升級→對象資格。 設定檔一旦在串流對象中達到金級狀態，就會立即進入歷程並收到祝賀電子郵件。
- 重新參與系列→讀取對象。 您每30天執行一次週期性歷程，鎖定長達90天以上未使用的設定檔。
金鑰限制：每個歷程一個讀取對象（必須是第一個活動）；每個活動一個對象；每個組織最多可同時執行5個讀取對象；每個沙箱每秒有20,000個設定檔；12小時工作逾時。 在護欄和限制中的完整詳細資料。
先決條件：已建置並評估的Adobe Experience Platform對象（已實現狀態）、為歷程選取的以人物為基礎的身分名稱空間，以及（對於週期性執行）瞭解排程和輸送量限制。
例如，在組建對象使用案例中建立的Luma app opening and checkout對象可以當做進入點。 所有合格的設定檔都會使用條件、計時器、事件和動作，透過個人化路徑進入歷程和進度。
➡️ 在影片中探索此功能
- 在使用讀取對象活動之前，先讀取護欄和限制。
設定活動 configuring-segment-trigger-activity
您將設定： 對象 （必要）、名稱空間 （必要）、讀取率 （必要，預設5,000/s）和排程 （當歷程執行時）。 選擇性地新增 標籤 和補充識別碼。 下列步驟會逐步引導您完成每個設定。
新增活動並選取客群 add-activity-and-select-audience
-
展開 協調流程 類別，並將 讀取對象 活動拖放到您的畫布中。
活動必須定位為歷程的第一步。
-
將 標籤 新增至活動（選擇性）。 選用標籤可協助您在報告和測試模式記錄中識別活動。
-
在 對象 欄位中，選擇將進入歷程的Adobe Experience Platform對象，然後按一下儲存。 您可以選取使用區段定義產生的任何Adobe Experience Platform個對象。
note NOTE 此外，您可以鎖定使用對象組合建立的Adobe Experience Platform對象。
您也可以鎖定從CSV檔案🔗上傳的對象。
進一步瞭解如何在Journey Optimizer中產生及鎖定對象。請注意，您可以自訂清單中顯示的欄並加以排序。
新增對象後，複製按鈕可讓您複製其名稱和ID：
{"name":"Luma app opening and checkout","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}
note NOTE 只有具有 已實現 對象參與狀態的個人才會進入歷程。 如需如何評估對象的詳細資訊，請參閱Segmentation Service檔案。 -
在 名稱空間 欄位中，選擇要使用的名稱空間，以識別個人。 此欄位預設會自動填入上次使用的命名空間。 進一步瞭解名稱空間。
note NOTE 如果屬於對象的個人在不同身分中沒有選取的身分（名稱空間），則無法進入歷程。 您只能選取以人物為基礎的身分名稱空間。 如果您已定義查閱表格的名稱空間（例如：產品查閱的ProductID名稱空間），它將無法在 名稱空間 下拉式清單中使用。
補充識別碼 read-audience-supplemental-id
除了設定檔識別碼之外，您可以選擇啟用使用補充識別碼，在次要識別碼（例如訂單ID或預訂ID）的內容中執行歷程。 當補充識別碼不同時，這允許同一設定檔的多個入口。
瞭解如何在歷程中使用補充識別碼。 對於讀取對象歷程，補充識別碼是從 整合設定檔服務 對象的 聯合/設定檔結構描述 準備的，或是從 外部對象 的合格屬性中選取的（例如，從CSV檔案🔗匯入的對象或從組合工作流程產生的對象）。 使用補充ID時，每個歷程執行個體的讀取率限製為每秒500個設定檔。
護欄和推薦 must-read
讀取對象活動的所有護欄和限制（並行性、輸送量、每個活動一個對象、工作逾時、重試等等）都列在護欄和限制中。
推薦
輪廓輸入與讀取率 profile-entry-and-reading-rate
設定讀取率 （必要）。 這是每秒可以進入歷程的設定檔數目上限。 此費率僅適用於此活動，不適用於歷程中的其他活動。 例如，如果您想定義自訂動作的節流率，則需使用節流應用程式開發介面。 請參見此頁面。
此值會儲存在歷程版本裝載中。 預設值為每秒5,000個設定檔。 您可以將此值從每秒500個設定檔修改為20,000個設定檔。
排程此歷程 schedule
歷程預設會設定為執行一次。 若要定義執行歷程的特定日期/時間和頻率，請遵循下列步驟。
-
在 讀取對象 活動屬性中，選取編輯歷程排程。
在讀取對象活動屬性中
-
歷程的屬性隨即顯示。 在 排程器型別 下拉式清單中，選取您要執行歷程的頻率。
對於週期性歷程，特定選項可協助您管理設定檔對歷程的進入。 展開下列各節，瞭解各個選項的詳細資訊。
當具有週期性 讀取對象 的歷程首次執行時，對象中的所有設定檔都會進入歷程。 此選項可讓您在第一次發生後，僅將目標設定為自上次執行歷程以來進入對象的個人。
使用此選項時，系統會從Adobe Experience Platform的區段服務執行的上次對象評估工作開始，回顧24小時。
分段完成後，設定檔快照匯出作業會開始，允許Journey Optimizer偵測及處理新設定檔。 如果歷程是在這兩個工作之間排程，則增量讀取將不會擷取自上次執行歷程以來成為對象成員的設定檔。
若要將遺失設定檔的風險降至最低：
- 啟用 批次對象評估後觸發 選項，將回顧期間延長至上次成功執行歷程的時間，無論其發生在多久之前
- 排程歷程，以便在每日批次分段工作完成後順利執行（通常為2-3小時的緩衝）
- 對於需要立即包含設定檔的時間關鍵使用案例，請考慮改用具有串流對象的對象資格活動
| note caution |
|---|
| CAUTION |
| 對於自訂上傳對象 （CSV上傳）和其他外部對象（例如同盟對象構成），目前不支援增量讀取的功能。 無論增量讀取切換設定為何，系統都會在每個週期處理整個對象。 |
| 若要控制週期性專案，請使用在週期上強制重新進入。 |
此選項可讓您讓歷程中仍存在的所有設定檔在下次執行時自動退出。
例如，如果您在每日循環歷程中等候2天，啟用此選項會將設定檔移至下一個歷程執行。 無論他們是否在下一個執行的對象中，這都會在隔天發生。
如果此歷程中設定檔的生命週期可能超過週期頻率，請勿啟用此選項以確保設定檔可完成其歷程。
這兩個選項可控制歷程執行的不同部分：
- 增量讀取控制 從對象 中選取哪些設定檔以供下次重複執行。
- 重複時強制重新進入控制下次重複執行開始時，在歷程中仍處於作用中狀態的設定檔會發生什麼情況。
請使用下表來瞭解下次執行的合併行為。
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 | ||
|---|---|---|
| 增量讀取 | 在週期時強制重新進入 | 下次執行時的行為 |
| 關閉 | 關閉 | Journey Optimizer讀取該回合的完整對象。 仍在歷程中的設定檔不會自動重設。 |
| 於 | 關閉 | Journey Optimizer只會讀取自上次執行以來新增到對象中的設定檔。 仍在歷程中的設定檔不會自動重設。 |
| 關閉 | 於 | Journey Optimizer會在開始下一次執行前，從目前的歷程執行中移除作用中的參與者，然後再次讀取完整對象。 如此可讓設定檔在新發生次數時重新開始。 |
| 於 | 於 | Journey Optimizer會在開始下一次執行前，從目前的歷程執行中移除作用中的參與者，然後只讀取自上次執行以來新增到受眾的設定檔。 強制重新進入會重設作用中的歷程參與率，但增量讀取仍會將選擇限製為新新增的對象成員。 |
換言之，重複時強制重新進入不會停用增量讀取。 如果兩個選項都啟用，則設定檔會在下次發生次數開始前從使用中的歷程例項中移除，但下次發生次數仍只會選取自上次執行以來被視為新的對象成員。
| note important |
|---|
| IMPORTANT |
| 在週期強制重新進入移除的設定檔不會自動視為 增量讀取 的新對象成員。 對象選擇仍取決於設定檔自上次執行以來是否新新增到對象。 |
對於每日排程的歷程和目標鎖定批次對象，您可以定義最多6小時的時間視窗，讓歷程等待批次分段工作產生新的對象資料。 如果分段工作於時間範圍內完成，則歷程會觸發。 否則，會略過歷程，直到下一次發生為止。 此選項可確保歷程以準確且最新的對象資料執行。
例如，如果歷程排程為每日下午6點，您可以指定歷程執行前要等待的分鐘數或小時數。 當歷程下午6點醒來時，它會檢查是否有新的受眾，這表示受眾比上一個歷程執行中使用的受眾更新。 在指定的時間範圍內，當偵測到新的受眾時，將會立即執行歷程。 如果未偵測到新的受眾，將會略過當天的歷程執行。
測試並發佈歷程 testing-publishing
讀取對象活動可讓您在單一設定檔上測試歷程。
要執行此操作，請啟動測試模式。
照常設定並執行測試模式。 瞭解如何測試歷程。
測試執行後，顯示記錄按鈕可讓您檢視測試結果。 如需詳細資訊，請參閱本節
測試成功後，您就可以發佈歷程（請參閱發佈歷程）。 屬於對象的個人將在歷程的屬性 排程器 區段中指定的日期/時間進入歷程。
歷程中的受眾目標定位 audience-targeting-in-journeys
以對象為基礎的歷程一律以 讀取對象 活動開始，以擷取屬於Adobe Experience Platform對象的個人。 這些設定檔會讀取一次，或按照週期性排程讀取。
當他們進入歷程後，您可使用 條件 活動加以協調：依屬性或行為分段、排除部分母體，或將分支合併在一起（聯合）。 以下各節將說明每個模式。
區段
您可以使用 條件 活動來使用條件來執行分段。 例如，您可以讓VIP人員採用特定路徑，而非VIP人員則採用其他路徑。
區段可根據：
- 資料來源資料
- 歷程資料中事件內容的一部分，例如：某人點選了一小時前收到的訊息嗎？
- 日期，例如：某人瀏覽歷程時，我們是在6月嗎？
- 時間，例如：上午是在個人的時區嗎？
- 一種演演算法，根據百分比分割歷程中流動的對象，例如：90% - 10%以排除控制組
排除
用於分段的相同 條件 活動（請參閱上文）也可讓您排除部分母體。 例如，您可以排除VIP人員，方法是讓該人員流入之後有結束步驟的分支。
此排除作業可能會在對象擷取之後發生、基於母體計數目的或沿著多步驟歷程發生。
使用結束活動的
聯集
歷程可讓您建立N個分支，並在分段後將其聯結。 因此，您可以讓兩個對象回到共同體驗。
例如，在歷程中追蹤十天內的不同體驗後，VIP和非VIP客戶可以回到相同路徑。 聯合後，您可以執行細分或排除來再次分割對象。
疑難排解 audience-count-mismatch
此區段可協助您解決受眾規模不相符專案 （輸入的設定檔少於或多於預期）、已處理0個設定檔 （讀取對象警示或無專案）以及延遲或遺失的專案 （時間與資料傳輸）。
segmentExportJob事件）以追蹤對象匯出作業的生命週期。 這些事件會在活動層級記錄，而非個別設定檔，且可供查詢以用於監控和疑難排解目的。 深入瞭解查詢讀取對象事件。尋找您的問題：
零個設定檔已處理 zero-profiles-processed
如果 讀取對象 活動尚未處理任何設定檔（例如，您會看到讀取對象警示）：
- 檢查對象是否空白 — 在Adobe Experience Platform中，驗證對象人數以及設定檔是否處於 已實現 狀態。 空白或尚未評估的對象將導致零個專案。
- 檢查名稱空間 — 讀取對象活動中選取的名稱空間必須存在於您對象的設定檔中。 沒有該身分的設定檔無法進入歷程。 進一步瞭解名稱空間。
- 檢閱警示與重試 - 警示中報告失敗。 系統每10分鐘重試一次匯出作業建立，最長可持續1小時。 進一步瞭解重試和警示。
如果在這些檢查後問題仍然存在，請參閱計時和資料傳輸和資料驗證和監視以取得批次和組態原因。
時間與資料傳播 timing-and-data-propagation
-
批次分段工作完成：對於批次對象，請確保在歷程執行之前完成每日批次分段工作並更新快照。 批次對象在細分工作完成約 2小時 後即可使用。 深入瞭解對象評估方法。
-
資料擷取時間：驗證在歷程執行之前，設定檔資料擷取是否已完全完成。 如果在歷程開始前不久擷取設定檔，這些設定檔可能不會反映在對象中。 深入瞭解 Adobe Experience Platform🔗中的資料擷取。
-
使用「批次對象評估後觸發」選項：對於使用批次對象的每日排程歷程，請考慮啟用 批次對象評估後觸發 選項。 這可確保歷程在執行之前會等待新的受眾資料（最多6小時）。 進一步瞭解排程
-
新增等待活動：對於具有最近擷取之資料的串流對象，請考慮在歷程開始時新增 等待 活動，以便有時間進行資料傳播和設定檔資格。 進一步瞭解等待活動
-
inAudience()條件時間：在讀取對象歷程的條件節點中使用inAudience()時，會從設定檔的批次投影讀取區段會籍。 此投影中的資料在內嵌後 2小時 內已重新整理。 如需傳輸計時情況的完整詳細資訊，請參閱inAudience函式檔案。
資料驗證 data-validation-and-monitoring
-
檢查分段工作狀態：在Adobe Experience Platform 監視儀表板中監視批次分段工作完成時間。 用它來驗證對象資料何時準備就緒。
-
驗證合併原則：確定為對象設定的合併原則符合合併不同來源設定檔資料的預期行為。 深入瞭解 Adobe Experience Platform🔗中的合併原則。
-
檢閱區段定義：確認區段定義已正確設定，並包含所有預期的資格條件。 深入瞭解建立對象。 請特別注意：
- 可能根據事件時間戳記排除設定檔的時間型條件
- 取決於最近更新資料的屬性資格
- 串流與批次評估方法
-
驗證名稱空間設定：確定 讀取對象 活動中選取的名稱空間符合對象中設定檔使用的主要身分。 沒有所選名稱空間的設定檔將不會進入歷程。 深入瞭解識別名稱空間。
最佳做法
-
在分段後排程歷程：對於批次對象，請將歷程執行排程在典型的批次分段工作完成時間後至少2-3小時。 進一步瞭解歷程排程
-
將串流對象用於即時使用案例：如果您需要立即的設定檔資格和歷程專案，請將對象資格活動與串流對象搭配使用，而非 讀取對象 與批次對象。
-
先以較小的對象進行測試：在啟動大規模歷程之前，請使用較小的子集進行測試，以驗證計數符合預期。 瞭解如何測試歷程
-
定期監視：設定定期監視對象人數和歷程專案量度，以及早偵測差異。 深入瞭解歷程處理率和專案管理。
何時聯絡支援
如果計數不相符或在執行上述步驟後持續零設定檔執行，請聯絡Adobe支援。 準備就緒：對象名稱/ID、歷程名稱/ID、排程的執行時間、沙箱，以及差異的簡短說明（例如「對象顯示已實現10,000個，只有2,000個在[日期]進入歷程」）。
重試次數 read-audience-retry
擷取匯出工作時，預設會對對象觸發的歷程 (從 讀取客群 或 商業事件 開始) 套用重試。 如果在匯出工作建立期間發生錯誤，將每隔 10 分鐘進行重試，最長為 1 小時。 在這之後，我們會將其視為失敗。 因此，這些類型的歷程可在排程時間後最多 1 小時執行。
已擷取失敗的 讀取對象 觸發器，並顯示在 警示 中。 如果 讀取對象 活動在排定的執行時間後10分鐘未處理任何設定檔，讀取對象警報會警告您。 此失敗可能是由技術問題或空受眾所導致。 如果失敗是技術問題所造成，根據問題型別仍可能發生重試。 例如，如果匯出作業建立失敗，我們每10分鐘會重試一次，重試時間最長為1小時。 了解更多
如需讀取對象護欄的完整清單（包括重試和輸送量限制），請參閱護欄和限制。
相關主題
- 建立對象 — 建立並管理您要在讀取對象歷程中鎖定的對象區段。
- 對象資格活動 — 在設定檔進入或退出對象時即時觸發歷程，而不是以批次處理。
- 在歷程中使用補充識別碼 — 將讀取對象歷程擴充至目標次要實體，例如與設定檔連結的預訂、合約或訂閱。
- 護欄和限制 — 大規模啟動前，請先檢閱輸送量限制、重試行為以及對象大小臨界值。
- 歷程處理率和專案管理 — 瞭解設定檔如何插入歷程中，以及哪些專案控制專案及重新專案。
- 測試歷程 — 在上線之前，使用測試設定檔驗證您的歷程邏輯。
- 發佈歷程 — 啟動您的歷程並監視其初始執行。
- 傳送訊息給訂閱者 — 端對端使用案例：從設定到傳遞，使用讀取對象歷程鎖定訂閱清單。
- 讀取對象歷程的最佳實務 — 社群部落格涵蓋常見陷阱、計數差異和公認的最佳實務。
作法影片 video
了解透過讀取客群活動所觸發歷程的適用使用案例。 瞭解如何建立批次式歷程，以及套用哪些最佳實務。
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure and use the Read Audience activity in Adobe Journey Optimizer to add profiles from an Adobe Experience Platform audience into a journey, either once or on a recurring schedule, with guidance on scheduling, throughput, troubleshooting, and best practices.
Intents:
- Configure a Read Audience activity as the entry point of a journey
- Select an Adobe Experience Platform audience and identity namespace for the journey
- Set the reading rate to control how many profiles enter per second
- Schedule a journey to run once, daily, weekly, or on a custom recurrence
- Enable Incremental read to process only new audience members on recurring runs
- Troubleshoot audience count mismatches, zero-profile runs, and delayed entries
- Decide between Read Audience and Audience Qualification based on batch vs. real-time needs
Glossary:
- Read Audience activity: The journey entry-point activity that reads all qualified profiles from a selected Adobe Experience Platform audience and adds them to the journey (product-specific)
- Reading rate: The maximum number of profiles that can enter the journey per second (500–20,000; default 5,000) (product-specific)
- Incremental read: A recurring journey option that processes only profiles newly added to the audience since the last journey execution (product-specific)
- Force reentrance on recurrence: A scheduling option that removes all active journey participants before each new run so profiles can re-enter fresh (product-specific)
- Trigger after batch audience evaluation: A scheduling option that delays journey execution until a fresh batch audience snapshot is available (up to 6 hours) (product-specific)
- Supplemental identifier: A secondary identifier (e.g., order ID) that allows the same profile to enter the journey multiple times when the identifier differs (product-specific)
Guardrails:
- Only one Read Audience activity is allowed per journey, and it must be the first activity.
- Only one audience can be selected per Read Audience activity.
- Up to five concurrent Read Audience runs per organization.
- Maximum reading rate is 20,000 profiles per second per sandbox (sum of all concurrent Read Audience activities).
- Reading rate is limited to 500 profiles per second when a supplemental identifier is used.
- Only profiles with Realized audience participation status enter the journey.
- Only people-based identity namespaces are available; profiles without the selected namespace cannot enter.
- The 12-hour job timeout applies to Read Audience export jobs.
- Retries for failed export jobs occur every 10 minutes for up to 1 hour.
- For custom upload audiences with Incremental read enabled, profiles are only retrieved on the first recurrence (these audiences are fixed).
- Scale the Winner is not available for Read Audience journeys (path experimentation).
Terminology:
- Canonical name: Read Audience — Acronym: none — variants: segment-trigger, audience-based journey entry, Read Segment (legacy API name)
- Synonyms: “Read Audience” = “segment trigger” = “audience-triggered journey”
- Do not confuse: “Read Audience” ≠ “Audience Qualification” (Read Audience is batch/scheduled; Audience Qualification is real-time streaming)
FAQ:
- Q: When should I use Read Audience instead of Audience Qualification? — Use Read Audience for batch, scheduled use cases (e.g., weekly newsletters, re-engagement campaigns). Use Audience Qualification when profiles must enter the journey immediately as they qualify in real time.
- Q: Why are fewer profiles entering the journey than the audience size? — Common causes include profiles not having the selected namespace, batch segmentation jobs not yet completed before the journey ran, or profiles not being in Realized status. Enable “Trigger after batch audience evaluation” and check namespace configuration.
- Q: What does Incremental read do on the first run? — On the first execution, all audience profiles enter. On subsequent runs, only profiles newly added to the audience since the last execution are processed.
- Q: What happens if the export job fails? — The system retries every 10 minutes for up to 1 hour. Failures are reported in Alerts. After 1 hour without success, the run is considered failed.
- Q: Can the same profile enter a Read Audience journey multiple times? — Yes, if a supplemental identifier is configured and differs between entries, or if Force reentrance on recurrence is enabled. Without these, a profile cannot be present multiple times at the same time.
- Q: How long does a one-shot Read Audience journey remain live? — It auto-stops to Stopped when the last profile exits, unless the journey includes Wait, Reaction, or event-triggered transitions — in which case the 91-day global timeout applies. It does not remain Live until Finished at 91 days by default.