(API) Oracle Eloqua 연결

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

이 Adobe Experience Platform 대상 을 활용합니다. 연락처 업데이트 에서 작업 Oracle Eloqua 다음을 수행할 수 있는 REST API id 업데이트 대상 내에서으로 Oracle Eloqua.

Oracle Eloqua 사용 기본 인증 을(를) 통해 Oracle Eloqua REST API. 에 대한 인증 지침 Oracle Eloqua 인스턴스는 다음보다 아래에 있습니다. 대상에 인증 섹션.

사용 사례

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

전제 조건

Experience Platform 사전 요구 사항

에 대한 데이터를 활성화하기 전에 Oracle Eloqua 대상, 다음 항목이 있어야 합니다. 스키마, a 데이터 세트, 및 세그먼트 생성 위치 Experience Platform.

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

Oracle Eloqua 전제 조건

Platform에서 로 데이터를 내보내려면 Oracle Eloqua 계정 이(가) 있어야 함 Oracle Eloqua 계정입니다.

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

수집 Oracle Eloqua 자격 증명

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

다음을 참조하십시오. 에 로그인 Oracle Eloqua 지침을 참조하십시오.

가드레일

• Oracle Eloqua 에는 최대 250개의 사용자 지정 연락처 필드 제한이 있습니다.

• 새 대상을 내보내기 전에 Platform 대상의 수와 내의 기존 대상의 수를 확인해야 합니다 Oracle Eloqua 이 한도를 초과하지 마십시오.

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

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

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

지원되는 ID

Oracle Eloqua 는 아래 표에 설명된 id 업데이트를 지원합니다. 자세히 알아보기 id.

내보내기 유형 및 빈도

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

대상에 연결

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

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

대상으로 인증

아래의 필수 필드를 입력하십시오. 다음을 참조하십시오. 수집 Oracle Eloqua 자격 증명 섹션에 자세히 설명되어 있습니다.

• 암호: 의 암호 Oracle Eloqua 계정입니다.
• 사용자 이름: 다음으로 구성된 연결된 문자열 Oracle Eloqua 회사 이름 및 Oracle Eloqua 사용자 이름.
  연결된 값은 다음 형식을 갖습니다. {COMPANY_NAME}\{USERNAME}.
  참고: 중괄호나 공백을 사용하지 말고 \.
  예를 들어 Oracle Eloqua 회사 이름: MyCompany 및 Oracle Eloqua 사용자 이름: Username에서 사용할 연결된 값 사용자 이름 필드는 입니다. MyCompany\Username.

대상에 인증하려면 다음을 선택합니다. 대상에 연결.

제공된 세부 정보가 유효한 경우 UI에 연결됨 녹색 확인 표시가 있는 상태. 그런 다음 다음 다음 단계로 진행할 수 있습니다.

대상 세부 정보 입력

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

• 이름: 나중에 이 대상을 인식할 수 있는 이름입니다.
• 설명: 나중에 이 대상을 식별하는 데 도움이 되는 설명입니다.
• Pod: 가져올 항목 pod 을(를) 켜고 (으)로 로그인했습니다. Oracle Eloqua 에 로그인하고 나면 브라우저의 URL을 확인합니다. 예를 들어 브라우저 URL이 secure.p01.eloqua.com 다음 pod 선택해야 하는 값은 다음과 같습니다. p01. 다음을 참조하십시오. 수집 Oracle Eloqua 자격 증명 섹션에 자세히 설명되어 있습니다.

경고 활성화

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

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

이 대상으로 대상자 활성화

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

매핑 고려 사항 및 예제

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

XDM 필드를 매핑하려면 Oracle Eloqua 대상 필드에서 다음 단계를 수행합니다.

1. 다음에서 매핑 단계, 선택 새 매핑 추가. 화면에 새 매핑 행이 표시됩니다.
2. 다음에서 소스 필드 선택 창에서 다음을 선택합니다. 속성 선택 범주를 선택한 다음 XDM 속성을 선택하거나 ID 네임스페이스 선택 id를 선택합니다.
3. 다음에서 대상 필드 선택 창, 선택 ID 네임스페이스 선택 id를 선택하거나 사용자 지정 속성 선택 에서 원하는 속성 이름을 입력합니다 속성 이름 필드. 제공하는 속성 이름은 의 기존 연락처 속성과 일치해야 합니다. Oracle Eloqua. 다음을 참조하십시오 create a contact 에서 사용할 수 있는 정확한 속성 이름 Oracle Eloqua.

   • 다음 단계를 반복하여 XDM 프로필 스키마와 간에 필요한 속성 매핑과 원하는 속성 매핑을 모두 추가합니다. Oracle Eloqua: | 소스 필드 | 대상 필드 | 필수 | |—|—| |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| |

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

     

{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

대상 연결에 대한 매핑 제공을 마치면 을(를) 선택합니다 다음.

데이터 내보내기 유효성 검사

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

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

2. 그런 다음 대상을 선택하고 활성화 데이터 탭을 누른 다음 대상 이름을 선택합니다.
   

3. 대상자 요약을 모니터링하고 프로필 수가 세그먼트 내의 수와 일치하는지 확인합니다.
   

4. 에 로그인합니다 Oracle Eloqua 웹 사이트를 방문한 다음 연락처 개요 대상자의 프로필이 추가되었는지 확인할 페이지입니다. 대상자 상태를 보려면 연락처 세부 정보 을(를) 페이징하고 선택한 대상자 이름을 접두사로 하는 연락처 필드가 만들어졌는지 확인합니다.

데이터 사용 및 관리

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

오류 및 문제 해결

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

다음을 참조하십시오. Oracle Eloqua HTTP 상태 코드 및 Oracle Eloqua 유효성 검사 오류 설명이 포함된 상태 및 오류 코드의 전체 목록을 보여 주는 페이지입니다.

추가 리소스

자세한 내용은 Oracle Eloqua 설명서:

• Oracle Eloqua 마케팅 자동화
• oracle Eloqua Marketing Cloud 서비스를 위한 REST API

변경 로그

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