在某些情況下,您可能需要為資源定義由兩個欄位組成的識別索引鍵。 在設定識別金鑰後,您需要設定篩選定義,才能透過此識別金鑰(從Campaign Standard介面或API)呼叫資源。
在此使用案例中, 設定檔 已使用自訂擴充資源 "CRM ID" 和 "category" 欄位。 我們將為設定檔資源建立識別索引鍵,由這兩個欄位組成。 之後,我們會設定篩選器定義,以便使用識別索引鍵存取設定檔資源。
此使用案例的主要步驟為:
相關主題:
配置標識鍵時的全局概念在 本節.
在設定識別金鑰之前,請確定資源已擴充至所需的欄位,且已發佈。 如需詳細資訊,請參閱本章節。
前往 Administration / Development / Custom resources ,然後開啟 Profile 資源。
在 Identification keys 區段,按一下 Create element 按鈕。
新增兩個自訂「CRM ID」和「類別」欄位,然後按一下 Confirm.
如果您想在設定檔的介面中顯示兩個自訂欄位,請設定 Screen definition 標籤。 如需詳細資訊,請參閱本章節。
您現在可以設定篩選定義,以使用其識別索引鍵呼叫資源。
設定篩選器定義時的全域概念在 本節.
在 Filter definition 按一下 Add an element,然後輸入篩選定義的標籤和ID。
編輯篩選器定義的屬性以設定其規則。
將包含標識鍵中所用欄位的表拖放到工作區中。
選取識別金鑰(「CRM ID」)中使用的第一個欄位,然後啟用 Switch to parameters 選項。
在 Filter conditions 區段,保留 Equal 運算子,然後定義參數的名稱,然後按一下加號以建立它。
按一下 + 按鈕,則會自動產生參數的名稱。 請注意,因為您需要此資訊才能使用API的篩選器。
對構成識別索引鍵(「category」)的所有欄位重複上述步驟,然後儲存您的變更。
篩選器定義現在已設定。 您可以發佈資源,讓篩選器可供使用。
在設定識別金鑰及其篩選定義後,您就可以使用這些金鑰,從Campaign標準介面或REST API呼叫資源。
若要從介面使用篩選定義,請使用 Query 工作流程中的活動(請參閱 本節)。 篩選器便可在左窗格中使用。
若要使用Campaign StandardREST API的篩選器定義,請使用下列語法:
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
若要呼叫自訂篩選,請在設定篩選器定義時,使用「by」首碼,後接定義的篩選器名稱(在 步驟2.
在本例中,使用「123456」CRM ID從「spring」類別擷取設定檔的語法為:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
如需詳細資訊,請參閱 Campaign StandardREST API檔案.