使用複合識別鍵呼叫資源 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
若要呼叫自訂篩選器,請在中設定篩選器定義時,使用「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檔案.

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