표준 통합 작업 external-sources

왼쪽 메뉴에서 구성 섹션으로 이동한 다음 통합 카드에서 관리​을 클릭합니다.

그런 다음 통합 만들기​를 클릭하여 새 구성을 시작합니다.

{modal="regular"}

필요한 경우 cURL 명령을 붙여넣어 URL, HTTP 메서드, 헤더 및 쿼리 매개 변수를 자동으로 채웁니다.

통합을 위해 이름 및 설명​을 제공하세요.

API 끝점 URL​을(를) 입력하십시오.

경로 변수의 경우 레이블을 URL의 중괄호(https://api.example.com/v1/products/{{productId}})로 묶은 다음 경로 매개 변수​에서 각 자리 표시자를 설정하십시오.

검색 사용​을 선택하여 활성 검색 통합을 연결하면 해당 응답 필드가 헤더, 쿼리 및 경로 매개 변수의 변수 및 페이로드에 매핑될 수 있습니다.

➡️ 검색 통합 만들기 참조

{modal="regular"}

URL에 추가한 모든 자리 표시자에 대해 이름 및 기본값​으로 경로 매개 변수​을(를) 구성하십시오.

Name​은(는) 편집기에서만 마케터를 나타내는 레이블이며 API 요청 시 전송되지 않습니다.

{modal="regular"}

GET과 POST 사이의 HTTP 메서드​을(를) 선택하십시오.

통합에 필요한 경우 헤더 추가 및/또는 쿼리 매개 변수 추가​를 클릭합니다. 각 매개 변수에 대해 다음 세부 사항을 제공합니다.

• 매개 변수: API에 필요한 실제 헤더 또는 쿼리 매개 변수 이름입니다.

• 이름: 이 매개 변수에 대한 마케터용 레이블입니다. 작성자는 캠페인에서 값을 매핑할 때 이 매개 변수를 선택합니다.

• 유형: 고정 값으로 상수​를 선택하거나 동적 입력으로 변수​를 선택합니다.

• 값: 상수에 직접 값을 입력하거나 변수 매핑을 선택하십시오.

• 필수: 이 매개 변수가 필요한지 여부를 지정합니다. 필수 변수 매개 변수의 경우 런타임 시 확인된 값이 없고 기본값을 제공하지 않으면 요청 생성에 실패하고 오류가 발생하며 아웃바운드 API 호출이 수행되지 않습니다.

{modal="regular"}

인증 유형 선택:

• 인증 없음: 자격 증명이 필요하지 않은 열린 API의 경우.

• API 키: 정적 API 키를 사용하여 요청을 인증합니다. API 키 이름{​1},​​ API 키 값{3​}을(를) 입력하고 위치​를 지정하십시오.​****

• 기본 인증: 표준 HTTP 기본 인증을 사용합니다. 사용자 이름 및 암호​를 입력하십시오.

• OAuth 2.0: OAuth 2.0 프로토콜을 사용하여 인증합니다. 아이콘을 클릭하여 페이로드​를 구성하거나 업데이트합니다.

{modal="regular"}

API 요청에 대해 시간 초과 기간과 같은 정책 구성​을(를) 설정하고 제한, 캐시 및/또는 다시 시도하도록 선택합니다.

POST 메서드의 경우 본문 형식​을(를) 선택하여 페이로드​를 구성하십시오.

• JSON: 아이콘을 클릭하고 JSON 요청 페이로드를 붙여 넣습니다. 페이로드에서 이행해야 하는 변수를 매핑합니다.

• GraphQL: GraphQL 쿼리를 붙여 넣습니다. Journey Optimizer에서는 작업 이름​을 자동으로 생성하며 해당 쿼리 변수를 매핑할 수 있습니다.

  {modal="regular"}

JSON​과(와) HTML 사이의 응답 형식​을(를) 선택하십시오.

응답 페이로드 필드를 사용하여 메시지 개인화에 사용해야 하는 샘플 출력의 필드를 결정할 수 있습니다.

아이콘을 클릭하고 샘플 JSON 응답 페이로드를 붙여 넣어 데이터 형식을 자동으로 검색합니다.

개인화를 위해 표시할 필드를 선택하고 해당 데이터 유형을 지정합니다.

{modal="regular"}

URL, HTTP 메서드, 헤더 및 쿼리 매개 변수가 정의된 경우 테스트 연결 보내기​를 클릭하여 연결 테스트를 실행하고 구성을 확인하십시오.

테스트 연결 보내기 대화 상자에서 URL 경로, 헤더 및 쿼리 매개 변수에 변수 자리 표시자의 기본값을 입력합니다.

이러한 값은 테스트 요청에 포함됩니다. Journey Optimizer은 끝점을 호출하고 연결 성공 또는 실패 여부를 보고합니다.

{modal="regular"}

테스트가 성공적인 응답을 반환하는 경우 응답 페이로드로 사용​을 선택하여 응답 본문을 응답 페이로드 필드에 복사합니다. 통합 구성의 10단계를 참조하십시오. 여기에서 데이터 형식을 감지하고 개인화를 위해 필드를 선택할 수 있습니다.

{modal="regular"}

테스트가 성공하지 않으면 오류 드롭다운을 확장하여 오류 세부 정보를 검토하고 필요에 따라 통합 구성을 업데이트한 다음 테스트 연결 보내기​를 다시 실행하십시오.

{modal="regular"}

유효성을 검사하면 활성화​를 클릭합니다.

새로 생성된 통합에 액세스하여 다음을 수행할 수 있습니다.

• 업데이트: 인증 세부 정보 및 정책 구성​만 변경합니다. 업데이트는 라이브 여정 및 캠페인에 적용됩니다. 변경 내용을 저장하기 전에 참조 탐색 메뉴를 사용하여 통합 사용 위치를 확인하십시오.

• 보관: 통합 구성을 보관합니다.

  {modal="regular"}

활성화한 후 아이콘을 클릭하여 참조 탐색 메뉴에 액세스하고 이를 사용하는 여정 및 캠페인을 포함하여 이 구성에 대한 사용을 검토하십시오.

{modal="regular"}