경우에 따라 두 개의 필드로 구성된 리소스 및 식별 키를 정의해야 할 수 있습니다. 식별 키가 구성되면 Campaign Standard 인터페이스 또는 API에서 이 식별 키로 리소스를 호출할 수 있도록 필터 정의를 구성해야 합니다.
이 경우 프로필 리소스가 사용자 지정 "CRM ID" 및 "category" 필드로 확장되었습니다. 이 두 필드로 구성된 프로필 리소스에 대한 ID 키를 만듭니다. 그런 다음 식별 키를 사용하여 프로필 리소스에 액세스할 수 있도록 필터 정의를 구성합니다.
이 사용 사례에 대한 주요 단계는 다음과 같습니다.
관련 항목:
식별 키를 구성할 때의 글로벌 개념은 이 섹션에 자세히 설명되어 있습니다.
ID 키를 구성하기 전에 리소스가 원하는 필드로 확장되었고 게시되었는지 확인하십시오. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.
Administration / Development / Custom resources 메뉴로 이동한 다음 Profile 리소스를 엽니다.
Identification keys 섹션에서 Create element 단추를 클릭합니다.
2개의 사용자 지정 "CRM ID" 및 "카테고리" 필드를 추가한 다음 Confirm을 클릭합니다.
프로필의 인터페이스에 2개의 사용자 정의 필드를 표시하려면 Screen definition 탭을 구성합니다. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.
이제 식별 키를 사용하여 리소스를 호출할 수 있도록 필터 정의를 구성할 수 있습니다.
필터 정의를 구성할 때의 글로벌 개념은 이 섹션에 자세히 설명되어 있습니다.
Filter definition 탭에서 Add an element을 클릭한 다음 필터 정의의 레이블과 ID를 입력합니다.
필터 정의의 속성을 편집하여 규칙을 구성합니다.
식별 키에 사용된 필드가 포함된 테이블을 작업 영역으로 끌어다 놓습니다.
식별 키("CRM ID")에 사용되는 첫 번째 필드를 선택한 다음 Switch to parameters 옵션을 활성화합니다.
Filter conditions 섹션에서 Equal 연산자를 유지하고 매개 변수의 이름을 정의한 다음 더하기 기호를 클릭하여 매개 변수를 만듭니다.
+ 단추를 클릭하면 매개 변수의 이름이 자동으로 생성됩니다. API의 필터를 사용하는 데 필요하므로 이 정보를 참고하십시오.
식별 키("카테고리")를 구성하는 모든 필드와 함께 위의 단계를 반복한 다음 변경 내용을 저장합니다.
이제 필터 정의가 구성됩니다. 필터를 사용할 수 있도록 리소스를 게시할 수 있습니다.
ID 키와 해당 필터 정의가 구성되면 Campaign 표준 인터페이스 또는 REST API에서 해당 리소스를 호출하는 데 사용할 수 있습니다.
인터페이스에서 필터 정의를 사용하려면 워크플로우에서 Query 활동을 사용합니다(이 섹션 참조). 그런 다음 왼쪽 창에서 필터를 사용할 수 있습니다.
Campaign Standard REST API의 필터 정의를 사용하려면 아래 구문을 사용하십시오.
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
사용자 지정 필터를 호출하려면 단계 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 Standard REST API 설명서를 참조하십시오.