복합 식별 키로 리소스 호출

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

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

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

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

관련 항목:

1단계:식별 키 구성

노트

식별 키를 구성할 때의 글로벌 개념은 이 섹션에 자세히 설명되어 있습니다.

  1. ID 키를 구성하기 전에 리소스가 원하는 필드로 확장되었고 게시되었는지 확인하십시오. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.

  2. Administration / Development / Custom resources 메뉴로 이동한 다음 Profile 리소스를 엽니다.

  3. Identification keys 섹션에서 Create element 단추를 클릭합니다.

  4. 2개의 사용자 지정 "CRM ID" 및 "카테고리" 필드를 추가한 다음 Confirm​을 클릭합니다.

    노트

    프로필의 인터페이스에 2개의 사용자 정의 필드를 표시하려면 Screen definition 탭을 구성합니다. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.

  5. 이제 식별 키를 사용하여 리소스를 호출할 수 있도록 필터 정의를 구성할 수 있습니다.

2단계:필터 정의 구성

노트

필터 정의를 구성할 때의 글로벌 개념은 이 섹션에 자세히 설명되어 있습니다.

  1. Filter definition 탭에서 Add an element​을 클릭한 다음 필터 정의의 레이블과 ID를 입력합니다.

  2. 필터 정의의 속성을 편집하여 규칙을 구성합니다.

  3. 식별 키에 사용된 필드가 포함된 테이블을 작업 영역으로 끌어다 놓습니다.

  4. 식별 키("CRM ID")에 사용되는 첫 번째 필드를 선택한 다음 Switch to parameters 옵션을 활성화합니다.

  5. Filter conditions 섹션에서 Equal 연산자를 유지하고 매개 변수의 이름을 정의한 다음 더하기 기호를 클릭하여 매개 변수를 만듭니다.

    노트

    + 단추를 클릭하면 매개 변수의 이름이 자동으로 생성됩니다. API의 필터를 사용하는 데 필요하므로 이 정보를 참고하십시오.

  6. 식별 키("카테고리")를 구성하는 모든 필드와 함께 위의 단계를 반복한 다음 변경 내용을 저장합니다.

  7. 이제 필터 정의가 구성됩니다. 필터를 사용할 수 있도록 리소스를 게시할 수 있습니다.

3단계:식별 키에 따라 리소스를 호출합니다.

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 설명서를 참조하십시오.

이 페이지에서는