설명서CampaignCampaign Standard 설명서

복합 식별 키로 리소스 호출 calling-a-resource-using-a-composite-identification-key

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 경험
  • 개발자

경우에 따라 리소스에 대해 두 개의 필드로 구성된 식별 키를 정의해야 할 수 있습니다. 식별 키가 구성되면 Campaign Standard 인터페이스 또는 API에서 이 식별 키로 리소스를 호출할 수 있도록 필터 정의를 구성해야 합니다.

이 사용 사례에서는 Profile 리소스가 사용자 지정 "CRM ID" 및 "category" 필드로 확장되었습니다. 이 두 필드로 구성되는 프로필 리소스에 대한 식별 키를 만들겠습니다. 그런 다음 식별 키를 사용하여 프로필 리소스에 액세스할 수 있도록 필터 정의를 구성합니다.

이 사용 사례의 주요 단계는 다음과 같습니다.

  1. 두 필드를 기반으로 프로필 리소스의 식별 키를 구성합니다.
  2. 식별 키를 사용하여 프로필 리소스를 호출할 수 있도록 필터 정의를 구성합니다.
  3. 인터페이스 또는 AP에서 프로필 리소스를 호출합니다.

관련 항목:

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 Standard REST API의 필터 정의를 사용하려면 아래 구문을 사용하십시오.

GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
NOTE
사용자 지정 필터를 호출하려면 2단계에서 필터 정의를 구성할 때 정의된 필터 이름 뒤에 "by" 접두사를 사용하십시오.

이 경우 "123456" CRM ID를 사용하는 "봄" 카테고리에서 프로필을 검색하는 구문은 다음과 같습니다.

GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456

자세한 내용은 REST API Campaign Standard을 참조하세요.

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