使用複合識別鍵呼叫資源 calling-a-resource-using-a-composite-identification-key

在某些情況下,您可能需要為資源定義由兩個欄位組成的識別索引鍵。 在設定識別金鑰後,您需要設定篩選器定義,以便能夠從Campaign Standard介面或API使用此識別金鑰呼叫資源。

在此使用案例中,設定檔 ​資源已使用自訂​ "CRM ID" ​和​ "category" ​欄位擴充。 我們將為設定檔資源建立識別金鑰,該金鑰將由這兩個欄位組成。 然後,我們將設定篩選定義,以便可以使用識別鍵存取設定檔資源。

此使用案例的主要步驟為:

  1. 根據兩個欄位,設定設定檔資源的識別碼。
  2. 設定篩選定義,以便能夠使用設定檔資源的識別鍵進行呼叫。
  3. 從介面或API呼叫設定檔資源。

相關主題:

步驟1:設定識別鍵 step-1-configure-the-identification-key

NOTE
設定識別金鑰時的全域概念在本節中有詳細說明。
  1. 在設定識別金鑰之前,請確定資源已使用所需欄位擴展,並且已發佈。 如需詳細資訊,請參閱本章節

  2. 前往​ Administration / Development / Custom resources ​功能表,然後開啟​ Profile ​資源。

  3. 在​ Identification keys ​區段中,按一下​ Create element ​按鈕。

  4. 新增兩個自訂「CRM ID」和「類別」欄位,然後按一下​ Confirm

    note note
    NOTE
    如果您想要在設定檔介面中顯示兩個自訂欄位,請設定​ Screen definition ​標籤。 如需詳細資訊,請參閱本章節
  5. 您現在可以設定篩選定義,以便能夠使用資源的識別鍵呼叫資源。

步驟2:設定篩選定義 step-2-configure-the-filter-definition

NOTE
設定篩選定義時的全域概念在本節中有詳細說明。
  1. 在​ Filter definition ​索引標籤中,按一下​ Add an element,然後輸入篩選器定義的標籤和ID。

  2. 編輯篩選器定義的屬性以設定其規則。

  3. 將包含識別鍵中所用欄位的表格拖放到工作區中。

  4. 選取識別碼(「CRM ID」)中使用的第一個欄位,然後啟用​ Switch to parameters ​選項。

  5. 在​ Filter conditions ​區段中,保留​ Equal ​運運算元,然後定義引數的名稱並按一下加號以建立它。

    note note
    NOTE
    按一下​**+**​按鈕後,引數名稱會自動產生。 請記下這些資訊,因為您需要這些資訊才能使用API的篩選器。
  6. 對組成識別索引鍵(「類別」)的所有欄位重複上述步驟,然後儲存變更。

  7. 現在已設定篩選器定義。 您可以發佈資源,讓篩選器可供使用。

步驟3:根據其識別鍵呼叫資源 step-3-call-the-resource-based-on-its-identification-key

設定識別鍵及其篩選定義後,您就可以從Campaign標準介面或REST API使用它們來呼叫資源。

若要使用介面的篩選定義,請在工作流程中使用​ Query ​活動(請參閱此區段)。 然後,即可在左窗格中使用篩選器。

若要使用Campaign StandardREST API的篩選定義,請使用下列語法:

GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
NOTE
若要呼叫自訂篩選器,請在步驟2中設定篩選器定義時,使用「by」前置詞,後接定義的篩選器名稱。

在我們的案例中,以「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檔案

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff