복합 식별 키로 리소스 호출

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

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

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

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

관련 항목:

1단계: 식별 키 구성

노트

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

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

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

  3. Identification keys 섹션에서 Create element 버튼을 클릭합니다.

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

    노트

    프로필 인터페이스에 두 개의 사용자 지정 필드를 표시하려면 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단계: 식별 키를 기반으로 리소스를 호출합니다

식별 키 및 해당 필터 정의가 구성되면 Campaign Standard 인터페이스 또는 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

자세한 내용은 REST API Campaign Standard 설명서를 참조하십시오.

이 페이지에서는