경우에 따라 리소스에 대해 두 개의 필드로 구성된 식별 키를 정의해야 할 수 있습니다. 식별 키가 구성되면 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의 필터를 사용하는 데 필요하므로 이 정보를 참고하십시오.
식별 키를 구성하는 모든 필드("카테고리")를 사용하여 위의 단계를 반복한 다음 변경 사항을 저장합니다.
이제 필터 정의가 구성되었습니다. 필터를 사용할 수 있도록 리소스를 게시할 수 있습니다.
식별 키와 해당 필터 정의가 구성되면 이를 사용하여 Campaign 표준 인터페이스 또는 REST API에서 리소스를 호출할 수 있습니다.
인터페이스에서 필터 정의를 사용하려면 Query 워크플로우의 활동(참조) 이 섹션). 그런 다음 왼쪽 창에서 필터를 사용할 수 있습니다.
Campaign Standard REST API의 필터 정의를 사용하려면 아래 구문을 사용하십시오.
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
사용자 지정 필터를 호출하려면에서 필터 정의를 구성할 때 정의된 필터 이름 뒤에 "by" 접두사를 사용하십시오 2단계.
이 경우 "123456" CRM ID를 사용하는 "봄" 카테고리에서 프로필을 검색하는 구문은 다음과 같습니다.
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
자세한 내용은 다음을 참조하십시오. Campaign Standard REST API 설명서.