[Ultimate]{class="badge positive"}
Google PubSub來源
Adobe Experience Platform為雲端提供者(例如AWS、Google Cloud Platform和Azure)提供原生連線,可讓您將資料從這些系統帶入Platform,以用於下游服務和目的地。
雲端儲存空間來源可將您的資料帶入Platform,無需下載、格式化或上傳。 內嵌的資料可以格式化為XDM JSON、XDM Parquet或分隔。 流程的每個步驟都會整合到來源工作流程中。 Platform可讓您即時從Google PubSub匯入資料。
先決條件 prerequisites
本節概述在將Google PubSub帳戶連線至Experience Platform之前,必須完成的先決條件設定。
建立服務帳戶 create-service-account
服務帳戶 是應用程式或運算工作負載經常使用的帳戶型別,而不是個人。 服務帳戶由其電子郵件地址識別,該地址為該帳戶所獨有。
- 一方面,服務帳戶是 主參與者 — 您可以授與服務帳戶對Google Cloud資源的存取權。 例如,您可以在指定專案上授與服務帳戶運算管理員角色
(roles/compute.admin)
。 如此一來,服務帳戶就能在該特定專案中管理運算引擎資源。 - 另一方面,服務帳戶也是資源 — 您可以授予其他主體存取服務帳戶的許可權。 例如,您可以授與使用者服務帳戶上的服務帳戶使用者角色
(roles/iam.serviceAccountUser)
,讓使用者將該服務帳戶附加至資源。 或者,您可以授與使用者服務帳戶管理員角色(roles/iam.serviceAccountAdmin)
,讓使用者完成檢視、編輯、停用和刪除服務帳戶等工作。
如需針對使用案例決定正確驗證型別的詳細資訊,請閱讀驗證方法🔗的Google 指南。
請依照下列步驟建立服務帳戶:
首先,導覽至Google Developer Console的IAM頁面,然後選取 Create Service Account。
接下來,輸入服務帳戶的顯示名稱和ID,然後選取 Create and Continue。
產生服務帳戶金鑰 generate-service-account-keys
若要為服務帳戶產生金鑰,請在服務帳戶頁面中選取金鑰標頭。 從那裡選取 Add key,然後從下拉式選單中選取 Create new key。 您也可以使用此面板來上傳現有的金鑰。
成功後,您將會收到一則訊息,指出您的電腦已儲存私密金鑰,且檔案將會下載。 然後,當您在Experience Platform上建立您的Google PubSub帳戶時,可以使用此檔案的內容作為認證。
授與主題和訂閱層級的許可權 grant-permissions
若要授與主題和訂閱層級的許可權,請瀏覽至主題主控台頁面,然後選取 Show info panel。 接著,在Permissions標籤下,選取Add Principal,然後新增服務帳戶主體與許可權。
最佳Google PubSub usage的組態 optimal-configurations
本節概述建議您在Experience Platform上最佳化Google PubSub來源使用方式的設定。
訂閱屬性 subscription-properties
使用Google Developer Console至 增加您的通知期限。 這可讓Google Publisher根據您設定的時間等待,然後再傳送訊息。 此延遲有助於減少訂閱者層級不必要的負載。
啟用 exactly one delivery。 此設定會通知Google Publisher,保證傳送至訂閱的郵件不會在確認截止日期到期前重新傳送。 您可以使用此設定來確保確認訊息不會重新傳送至訂閱。
您可以啟用 Retry after exponential backoff delay,以降低伺服器進一步不堪重負的風險。 您可以在Google Developer Console中啟用此設定,以便在嘗試其他連線之前,提供系統更多的時間復原,以更好地緩解暫時性失敗(通常可自行解決的暫時性錯誤)。
您必須 將訂閱訊息保留期間設為24小時以上,以確保未確認的資料不會在尖峰載入期間遺失。 此外,啟用無效信件主題,以確保即使在極少數邊緣案例中也不會發生資料遺失。
連線Google PubSub至Experience Platform
以下檔案提供如何使用API或使用者介面將Google PubSub連線到Platform的資訊: