(API) Oracle Eloqua 연결

Oracle Eloqua을(를) 사용하면 마케터가 잠재 고객을 위해 개인화된 고객 경험을 제공하는 동안 캠페인을 계획하고 실행할 수 있습니다. 통합된 리드 관리와 손쉬운 캠페인 생성을 통해 마케터는 구매자의 여정에서 적시에 적절한 대상자를 참여시킬 수 있도록 지원하고 이메일, 디스플레이 검색, 비디오 및 모바일을 비롯한 다양한 채널에서 대상자에게 도달하도록 우아하게 확장할 수 있습니다. 영업 팀은 더 많은 거래를 더 빠른 속도로 마감할 수 있으므로 실시간 통찰력을 통해 마케팅 ROI를 높일 수 있습니다.

이 Adobe Experience Platform 대상은(는) Oracle Eloqua REST API의 연락처 업데이트 작업을 활용합니다. 이를 통해 대상 내의 ID를 업데이트 ​할 수 있습니다. Oracle Eloqua.

Oracle Eloqua은(는) 기본 인증을 사용하여 Oracle Eloqua REST API와 통신합니다. Oracle Eloqua 인스턴스에 대한 인증 지침은 대상에 대한 인증 섹션에서 아래에 더 나와 있습니다.

사용 사례 use-cases

온라인 플랫폼의 마케팅 부서에서 이메일 기반 마케팅 캠페인을 선별된 잠재 고객에게 브로드캐스트하려고 합니다. 플랫폼의 마케팅 팀은 Adobe Experience Platform을 통해 기존 잠재 고객 정보를 업데이트하고, 자체 오프라인 데이터에서 대상을 작성한 다음, 이러한 대상을 Oracle Eloqua에 보낼 수 있습니다. 그런 다음 마케팅 캠페인 이메일을 보내는 데 사용할 수 있습니다.

전제 조건 prerequisites

Experience Platform 사전 요구 사항 prerequisites-in-experience-platform

Oracle Eloqua 대상에 대한 데이터를 활성화하기 전에 Experience Platform에서 만든 스키마, 데이터 세트세그먼트가 있어야 합니다.

대상 상태에 대한 지침이 필요한 경우 대상 멤버십 세부 정보 스키마 필드 그룹에 대한 Experience Platform 설명서를 참조하세요.

Oracle Eloqua개 필수 구성 요소 prerequisites-destination

플랫폼에서 Oracle Eloqua 계정으로 데이터를 내보내려면 Oracle Eloqua 계정이 있어야 합니다.

또한 Oracle Eloqua 인스턴스에 대해 최소한 "고급 사용자 - 마케팅 권한" ​이 필요합니다. 지침은 보안 사용자 액세스 페이지의 "보안 그룹" 섹션을 참조하십시오. Oracle Eloqua API를 호출할 때 프로그래밍 방식으로 기본 URL을 확인하려면 대상에 액세스 권한이 필요합니다.

Oracle Eloqua 자격 증명 수집 gather-credentials

Oracle Eloqua 대상에 인증하기 전에 아래 항목을 적어 두십시오.

자격 증명
설명
Company Name
Oracle Eloqua 계정과 연결된 회사 이름.
나중에 대상에 대한 인증을 수행할 때 사용자 이름(으)로 사용할 연결된 문자열로 Company Name 및 Oracle Eloqua Username을(를) 사용합니다.
Username
Oracle Eloqua 계정의 사용자 이름입니다.
Password
Oracle Eloqua 계정의 암호입니다.
Pod
Oracle Eloqua은(는) 각각 고유한 도메인 이름을 가진 여러 데이터 센터를 지원합니다. Oracle Eloqua은(는) "포드"라고 하며, 현재 p01, p02, p03, p04, p06, p07 및 p08의 총 7개가 있습니다. 사용 중인 POD를 얻으려면 Oracle Eloqua에 로그인하여 로그인한 후 브라우저에서 URL을 확인합니다. 예를 들어 브라우저 URL이 secure.p01.eloqua.com인 경우 pod은(는) p01입니다. 추가 지침은 POD 확인 페이지를 참조하세요.

자세한 내용은 다음에 로그인 Oracle Eloqua을 참조하세요.

가드레일 guardrails

NOTE
  • Oracle Eloqua 사용자 지정 연락처 필드는 세그먼트 선택 단계에서 선택한 대상자의 이름을 사용하여 자동으로 만들어집니다.
  • Oracle Eloqua의 최대 사용자 지정 연락처 필드 수는 250개입니다.

  • 새 대상을 내보내기 전에 Platform 대상 수와 Oracle Eloqua 내의 기존 대상 수가 이 제한을 초과하지 않도록 하십시오.

  • 이 한도를 초과하면 Experience Platform 시 오류가 발생합니다. 이는 Oracle Eloqua API가 요청의 유효성을 검사하지 못하고 - 400: 유효성 검사 오류가 있습니다 - 문제를 설명하는 오류 메시지에 응답하기 때문입니다.

  • 위에서 지정한 제한에 도달한 경우 더 많은 세그먼트를 내보내려면 먼저 대상에서 기존 매핑을 제거하고 Oracle Eloqua 계정에서 해당 사용자 지정 연락처 필드를 삭제해야 합니다.

  • 추가 제한에 대한 자세한 내용은 Oracle Eloqua 연락처 필드 만들기 페이지를 참조하세요.

지원되는 ID supported-identities

Oracle Eloqua은(는) 아래 표에 설명된 ID 업데이트를 지원합니다. ID에 대해 자세히 알아보세요.

대상 ID
설명
필수
EloquaId
연락처에 대한 고유 식별자.

내보내기 유형 및 빈도 export-type-frequency

대상 내보내기 유형 및 빈도에 대한 자세한 내용은 아래 표를 참조하십시오.

항목
유형
참고
내보내기 유형
프로필 기반
  • 필드 매핑에 따라 원하는 스키마 필드 (예: 이메일 주소, 전화 번호, 성) ​과(와) 함께 세그먼트의 모든 멤버를 내보냅니다.
  • 플랫폼에서 선택한 각 대상에 대해 해당 Oracle Eloqua 세그먼트 상태가 Platform의 대상 상태로 업데이트됩니다.
내보내기 빈도
스트리밍
  • 스트리밍 대상은 "항상" API 기반 연결입니다. 대상자 평가를 기반으로 Experience Platform에서 프로필이 업데이트되는 즉시 커넥터가 업데이트 다운스트림을 대상 플랫폼으로 전송합니다. 스트리밍 대상에 대해 자세히 알아보세요.

대상에 연결 connect

IMPORTANT
대상에 연결하려면 대상 보기대상 관리 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.

이 대상에 연결하려면 대상 구성 자습서에 설명된 단계를 따르십시오. 대상 구성 워크플로에서 아래 두 섹션에 나열된 필드를 채웁니다.

대상 > 카탈로그 내에서 (API) Oracle Eloqua 검색 또는 이메일 마케팅 범주에서 찾을 수 있습니다.

대상으로 인증 authenticate

아래의 필수 필드를 입력하십시오. 자세한 내용은 수집 Oracle Eloqua 자격 증명 섹션을 참조하십시오.

  • 암호: Oracle Eloqua 계정의 암호입니다.
  • 사용자 이름: Oracle Eloqua 회사 이름과 Oracle Eloqua 사용자 이름으로 구성된 연결된 문자열입니다.
    연결된 값은 {COMPANY_NAME}\{USERNAME} 형식입니다.
    참고: 중괄호 또는 공백을 사용하지 말고 \을(를) 유지하십시오.
    예를 들어 Oracle Eloqua 회사 이름이 MyCompany이고 Oracle Eloqua 사용자 이름이 Username인 경우 사용자 이름 필드에서 사용할 연결된 값은 MyCompany\Username입니다.

대상에 인증하려면 대상에 연결 ​을 선택하세요.
인증 방법을 보여 주는 플랫폼 UI 스크린샷입니다.

제공된 세부 정보가 유효하면 UI에 녹색 확인 표시와 함께 연결됨 상태가 표시됩니다. 그런 다음 다음 다음 단계로 진행할 수 있습니다.

대상 세부 정보 입력 destination-details

대상에 대한 세부 정보를 구성하려면 아래의 필수 및 선택 필드를 채우십시오. UI에서 필드 옆에 있는 별표는 필드가 필수임을 나타냅니다.
대상 세부 정보를 표시하는 플랫폼 UI 스크린샷입니다.

  • 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
  • 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
  • Pod: 현재 pod을(를) 가져오려면 Oracle Eloqua에 로그인하여 로그인한 후 브라우저의 URL을 기록해 두십시오. 예를 들어 브라우저 URL이 secure.p01.eloqua.com인 경우 선택해야 하는 pod 값은 p01입니다. 추가 지침은 수집 Oracle Eloqua 자격 증명 섹션을 참조하십시오.

경고 활성화 enable-alerts

경고를 활성화하여 대상에 대한 데이터 흐름 상태에 대한 알림을 받을 수 있습니다. 목록에서 경고를 선택하여 데이터 흐름 상태에 대한 알림을 수신합니다. 경고에 대한 자세한 내용은 UI를 사용하여 대상 경고 구독에 대한 안내서를 참조하십시오.

대상 연결에 대한 세부 정보를 모두 제공했으면 다음 ​을 선택합니다.

이 대상으로 대상자 활성화 activate

IMPORTANT
  • 데이터를 활성화하려면 대상 보기, 대상 활성화, 프로필 보기세그먼트 보기 액세스 제어 권한이 필요합니다. 액세스 제어 개요를 읽거나 제품 관리자에게 문의하여 필요한 권한을 받으십시오.
  • ID ​을(를) 내보내려면 ID 그래프 보기 액세스 제어 권한이 필요합니다.
    대상자를 대상으로 활성화하려면 워크플로에서 강조 표시된 ID 네임스페이스를 선택하십시오. {width="100" modal="regular"}

이 대상으로 대상을 활성화하는 방법에 대한 지침은 프로필 및 대상을 스트리밍 대상 내보내기 대상으로 활성화를 참조하십시오.

매핑 고려 사항 및 예제 mapping-considerations-example

대상 데이터를 Adobe Experience Platform에서 Oracle Eloqua 대상으로 올바르게 보내려면 필드 매핑 단계를 거쳐야합니다. 매핑은 Platform 계정의 XDM(Experience Data Model) 스키마 필드와 대상 대상의 해당 필드 간에 링크를 만드는 것으로 구성됩니다.

XDM 필드를 Oracle Eloqua 대상 필드에 매핑하려면 다음 단계를 수행하십시오.

  1. 매핑 단계에서 새 매핑 추가 ​를 선택합니다. 화면에 새 매핑 행이 표시됩니다.

  2. 소스 필드 선택 창에서 특성 선택 범주를 선택하고 XDM 특성을 선택하거나 ID 네임스페이스 선택 ​을 선택하고 ID를 선택합니다.

  3. 대상 필드 선택 창에서 ID 네임스페이스 선택 ​을(를) 선택하고 ID를 선택하거나 사용자 지정 특성 선택 ​을(를) 선택하고 특성 이름 필드에 원하는 특성 이름을 입력합니다. 제공한 특성 이름은 Oracle Eloqua의 기존 연락처 특성과 일치해야 합니다. Oracle Eloqua에서 사용할 수 있는 정확한 특성 이름은 create a contact을(를) 참조하십시오.

    • 다음 단계를 반복하여 XDM 프로필 스키마와 Oracle Eloqua 사이에 필요한 속성 매핑과 원하는 속성 매핑을 모두 추가합니다.
      | Source 필드 | 대상 필드 | 필수 |
      |—|—|
      |IdentityMap: Eid|Identity: EloquaId| 예 |
      |xdm: personalEmail.address|Attribute: emailAddress| 예 |
      |xdm: personName.firstName|Attribute: firstName| |
      |xdm: personName.lastName|Attribute: lastName| |
      |xdm: workAddress.street1|Attribute: address1| |
      |xdm: workAddress.street2|Attribute: address2| |
      |xdm: workAddress.street3|Attribute: address3| |
      |xdm: workAddress.postalCode|Attribute: postalCode| |
      |xdm: workAddress.country|Attribute: country| |
      |xdm: workAddress.city|Attribute: city| |

    • 위 매핑의 예가 아래에 나와 있습니다.

      특성 매핑이 있는 Platform UI 스크린샷 예입니다.

IMPORTANT
  • Target 필드 ​에 지정된 특성은 Create a contact에 지정된 것과 정확히 동일하게 이름을 지정해야 합니다. 이러한 특성은 요청 본문을 형성합니다.
  • Source 필드 ​에 지정된 특성은 이러한 제한을 따르지 않습니다. 필요에 따라 매핑할 수 있지만 Oracle Eloqua에 푸시할 때 데이터 형식이 올바르지 않으면 오류가 발생합니다. 예를 들어 Source 필드 ID 네임스페이스 contact key, ABC ID 등을 매핑할 수 있습니다. 대상 필드 대상 필드: EloquaId. ID 값이 Oracle Eloqua에서 허용하는 형식과 일치하는지 확인한 후.
  • EloquaID 매핑은 ID에 해당하는 특성을 업데이트하는 데 필수입니다.
  • emailAddress 매핑이 필요합니다. 이 옵션이 없으면 API에 아래와 같이 오류가 발생합니다.
code language-json
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

대상 연결에 대한 매핑을 제공했으면 다음 ​을 선택합니다.

NOTE
대화 상대 필드 정보를 Oracle Eloqua (으)로 보낼 때 대상은 각 실행 시 선택한 대상 이름에 자동으로 고유 식별자를 추가합니다. 이렇게 하면 대상자 이름에 해당하는 연락처 필드 이름이 겹치지 않습니다. 대상자 이름을 사용하여 만든 사용자 지정 연락처 필드가 있는 Oracle Eloqua 연락처 세부 정보 페이지의 데이터 내보내기 유효성 검사 섹션 스크린샷 예제를 참조하십시오.

데이터 내보내기 유효성 검사 exported-data

대상을 올바르게 설정했는지 확인하려면 아래 단계를 수행하십시오.

  1. 대상 > 찾아보기 ​를 선택하고 대상 목록으로 이동합니다.

  2. 그런 다음 대상을 선택하고 활성화 데이터 탭으로 전환한 다음 대상 이름을 선택합니다.
    대상 활성화 데이터를 보여주는 플랫폼 UI 스크린샷 예입니다.

  3. 대상자 요약을 모니터링하고 프로필 수가 세그먼트 내의 수와 일치하는지 확인합니다.
    세그먼트를 표시하는 플랫폼 UI 스크린샷 예입니다.

  4. Oracle Eloqua 웹 사이트에 로그인한 다음 연락처 개요 페이지로 이동하여 대상자의 프로필이 추가되었는지 확인합니다. 대상자 상태를 보려면 연락처 세부 정보 페이지로 드릴다운하여 선택한 대상자 이름을 접두사로 사용하는 연락처 필드를 만들었는지 확인하십시오.

대상자 이름으로 만든 사용자 지정 연락처 필드가 있는 연락처 세부 정보 페이지를 보여주는 Oracle Eloqua UI 스크린샷입니다.

데이터 사용 및 관리 data-usage-governance

데이터를 처리할 때 모든 Adobe Experience Platform 대상이 데이터 사용 정책을 준수합니다. Adobe Experience Platform에서 데이터 거버넌스를 적용하는 방법에 대한 자세한 내용은 데이터 거버넌스 개요를 참조하십시오.

오류 및 문제 해결 errors-and-troubleshooting

대상을 만들 때 400: There was a validation error 또는 400 BAD_REQUEST 오류 메시지 중 하나를 받을 수 있습니다. 이 문제는 보호 기능 섹션에 설명된 대로 사용자 지정 연락처 필드 제한인 250개를 초과할 때 발생합니다. 이 오류를 해결하려면 Oracle Eloqua에서 사용자 지정 연락처 필드 제한을 초과하지 않도록 하십시오.
오류를 표시하는 플랫폼 UI 스크린샷.

설명과 함께 상태 및 오류 코드의 전체 목록을 보려면 Oracle Eloqua HTTP 상태 코드Oracle Eloqua 유효성 검사 오류 페이지를 참조하세요.

추가 리소스 additional-resources

자세한 내용은 Oracle Eloqua 설명서를 참조하십시오.

변경 로그

이 섹션에서는 이 대상 커넥터에 대한 기능 및 중요 설명서 업데이트를 캡처합니다.

변경 로그 보기
table 0-row-3 1-row-3 2-row-3 layout-auto
릴리스 월 업데이트 유형 설명
2023년 4월 설명서 업데이트
  • 고객이 이 대상을 사용할 때 이점을 얻을 수 있는 경우를 보다 명확하게 예로 들어 사용 사례 섹션을 업데이트했습니다.
  • 필수 및 선택적 매핑에 대한 명확한 예제로 매핑 섹션을 업데이트했습니다.
  • Oracle Eloqua 회사 이름 및 Oracle Eloqua 사용자 이름을 사용하여 사용자 이름 필드에 연결된 값을 만드는 방법에 대한 예제로 대상에 연결 섹션을 업데이트했습니다. (PLATIR-28343)
  • Oracle Eloqua Pod 선택에 대한 지침과 함께 수집 Oracle Eloqua 자격 증명대상 세부 정보 채우기 섹션을 업데이트했습니다. "Pod" 값은 API 호출에 대한 기본 URL을 구성하는 데 대상에서 사용됩니다. Oracle Eloqua 인스턴스에 필요한 "보안 그룹"(으)로 "고급 사용자 - 마케팅 권한" ​을(를) 할당하는 방법에 대한 지침과 함께 Oracle Eloqua 필수 구성 요소 섹션도 업데이트되었습니다.
2023년 3월 초기 릴리스 초기 대상 릴리스 및 설명서 게시.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6