v7
Campaign Classic v7에 적용
v8
Campaign v8에도 적용됩니다.

파이프라인 구성 configuring-pipeline

고객 ID, 개인 키 및 인증 끝점과 같은 인증 매개 변수는 인스턴스 구성 파일에 구성됩니다.
처리할 트리거 목록은 JSON 형식의 옵션으로 구성됩니다.
트리거는 이메일을 보내는 캠페인 워크플로우에서 타겟팅하는 데 사용됩니다. 캠페인은 트리거 이벤트가 모두 있는 고객이 이메일을 받도록 설정됩니다.

전제 조건 prerequisites

이 구성을 시작하기 전에 다음을 사용 중인지 확인하십시오.

  • 최소, 다음 Adobe Campaign 빌드 중 하나:

    • 19.1.8.9039
    • 19.1.4.9032 - 금 표준 11
    • 20.2.4.9187
    • 20.3.1
  • Adobe Analytics Standard 버전

또한 다음과 같은 사항도 필요합니다.

  • Adobe I/O 프로젝트 인증
  • 유효한 조직 ID - 조직 ID를 찾으려면 다음을 참조하십시오. 이 페이지
  • 조직에 대한 개발자 액세스 권한
  • Adobe Analytics에서 트리거 구성 완료

인증 및 구성 파일 authentication-configuration

파이프라인이 Adobe Experience Cloud에서 호스팅되므로 인증이 필요합니다.
공개 키와 개인 키 쌍을 사용합니다. 이 프로세스는 사용자/암호와 동일한 기능을 가지고 있지만 보다 안전합니다.
Adobe I/O 프로젝트를 통해 Marketing Cloud에 대한 인증이 지원됩니다.

1단계: Adobe I/O 프로젝트 만들기/업데이트 creating-adobe-io-project

호스팅된 고객의 경우, 고객 지원 티켓을 만들어 트리거 통합을 위한 기술 계정 토큰 Adobe I/O으로 귀사에서 사용할 수 있도록 할 수 있습니다.

온프레미스 고객의 경우 Adobe Experience Cloud Triggers에 대한 Adobe I/O 구성 페이지를 가리키도록 업데이트하는 중입니다. 다음을 선택해야 합니다. Adobe Analytics Adobe I/O 자격 증명에 API를 추가하는 동안.

2단계: NmsPipeline_Config 파이프라인 옵션 구성 configuring-nmspipeline

인증이 설정되면 파이프라인이 이벤트를 검색합니다. Adobe Campaign에 구성된 트리거만 처리합니다. 트리거는 Adobe Analytics에서 생성되어 파이프라인으로 푸시되어야 하며 파이프라인은 Adobe Campaign에 구성된 트리거만 처리합니다.
이름과 관계없이 모든 트리거를 catch하기 위해 와일드카드로 옵션을 구성할 수도 있습니다.

  1. Adobe Campaign에서 아래의 옵션 메뉴에 액세스합니다 Administration > Platform > Options 다음에서 Explorer.

  2. 다음 항목 선택 NmsPipeline_Config 옵션을 선택합니다.

  3. 다음에서 Value (long text) 필드에서는 두 개의 트리거를 지정하는 다음 JSON 코드를 붙여넣을 수 있습니다. 주석을 제거해야 합니다.

    code language-none
    {
    "topics": [ // list of "topics" that the pipelined is listening to.
       {
            "name": "triggers", // Name of the first topic: triggers.
            "consumer": "customer_dev", // Name of the instance that listens.  This value can be found on the monitoring page of Adobe Campaign.
            "triggers": [ // Array of triggers.
                {
                    "name": "3e8a2ba7-fccc-49bb-bdac-33ee33cf02bf", // TriggerType ID from Analytics
                    "jsConnector": "cus:triggers.js" // Javascript library holding the processing function.
                }, {
                    "name": "2da3fdff-13af-4c51-8ed0-05802a572e94", // Second TriggerType ID
                    "jsConnector": "cus:triggers.js" // Can use the same JS for all.
                },
            ]
        }
    ]
    }
    
  4. 모든 트리거를 catch하는 다음 JSON 코드를 붙여넣도록 선택할 수도 있습니다.

    code language-none
    {
    "topics": [
      {
        "name": "triggers",
        "consumer":  "customer_dev",
        "triggers": [
          {
            "name": "*",
            "jsConnector": "cus:pipeline.js"
          }
        ]
      }
    ]
    }
    

소비자 매개 변수 consumer-parameter

파이프라인은 공급업체 및 소비자 모델처럼 작동합니다. 메시지는 개별 소비자에 대해서만 소비됩니다. 각 소비자는 메시지의 자체 복사본을 가져옵니다.

다음 소비자 매개 변수는 인스턴스를 이러한 소비자 중 하나로 식별합니다. 인스턴스 ID가 파이프라인을 호출합니다. 클라이언트 콘솔의 모니터링 페이지에 있는 인스턴스 이름으로 채울 수 있습니다.

파이프라인 서비스는 각 소비자가 검색한 메시지를 추적합니다. 서로 다른 인스턴스에 대해 서로 다른 소비자를 사용하면 모든 메시지가 각 인스턴스로 전송되는지 확인할 수 있습니다.

파이프라인 옵션 권장 사항 pipeline-option-recommendation

파이프라인 옵션을 구성하려면 다음 권장 사항을 따라야 합니다.

  • 아래에 트리거 추가 또는 편집 Triggers ​나머지 부분은 편집하지 마십시오.
  • JSON이 유효한지 확인합니다. JSON 유효성 검사기를 사용할 수 있습니다. 이 내용을 참조하십시오. 웹 사이트 예.
  • "name"은 트리거 ID에 해당합니다. 와일드카드 "*"가 모든 트리거를 catch합니다.
  • "소비자"는 호출 인스턴스 또는 응용 프로그램의 이름에 해당합니다.
  • 파이프라인에서는 "별칭" 항목도 지원합니다.
  • 변경한 후에는 항상 파이프라인을 다시 시작해야 합니다.

3단계: 선택적 구성 step-optional

로드 요구 사항에 따라 일부 내부 매개변수를 변경할 수 있지만 프로덕션에 적용하기 전에 테스트해야 합니다.

선택적 매개 변수 목록은 아래에서 찾을 수 있습니다.

옵션
설명
appName(기존)
공개 키가 업로드된 Legacy Oath 애플리케이션에 등록된 OAuth 애플리케이션의 AppID입니다. 자세한 정보는 이 페이지를 참조하십시오.
authGatewayEndpoint(기존)
게이트웨이 토큰을 가져올 URL입니다. 기본: https://api.omniture.com
authPrivateKey(기존)
Legacy Oath 응용 프로그램에 업로드된 공개 부분인 개인 키는 XtkKey 옵션으로 암호화됩니다. cryptString("PRIVATE_KEY")
disableAuth(기존)
인증을 비활성화하면 일부 개발 파이프라인 엔드포인트에서만 게이트웨이 토큰 없이 연결할 수 있습니다.
discoverPipelineEndpoint
이 테넌트에 사용할 파이프라인 서비스 끝점을 찾는 URL입니다. 기본: https://producer-pipeline-pnw.adobe.net
덤프 상태 기간 초
에서 내부 상태 프로세스의 두 덤프 사이의 기간 var/INSTANCE/pipelined.json.
내부 상태도 여기에서 온디맨드로 액세스할 수 있습니다. http://INSTANCE:7781/pipelined/status
forcedPipelineEndpoint
PipelineServicesEndpoint 검색을 비활성화하여 강제 실행
모니터 서버 포트
파이프라인된 프로세스는 여기에서 내부 상태 프로세스를 제공하기 위해 이 포트에서 수신합니다. http://INSTANCE:PORT/pipelined/status.
기본값은 7781입니다.
pointerFlushMessageCount
이 메시지 수가 처리되면 오프셋은 데이터베이스에 저장됩니다.
기본값은 1000입니다.
pointerFlushPeriodSec
이 기간이 지나면 오프셋이 데이터베이스에 저장됩니다.
기본값은 5초입니다.
processingJSThreads
사용자 지정 JS 커넥터가 있는 메시지를 처리하는 전용 스레드 수입니다.
기본값은 4입니다.
처리 스레드
기본 제공 코드가 있는 메시지를 처리하는 전용 스레드 수입니다.
기본값은 4입니다.
다시 시도 기간 초
처리 오류 시 다시 시도 사이에서 지연.
기본값은 30(초)입니다
retryValiditySec
이 기간 후에 성공적으로 처리되지 않는 경우 메시지를 무시합니다(재시도 횟수가 너무 많음).
기본값은 300(초)입니다.

파이프라인 프로세스 자동 시작 pipelined-process-autostart

파이프라인된 프로세스를 자동으로 시작해야 합니다.

이를 위해 구성 파일의 < pipelined > 요소를 autostart="true"로 설정합니다.

 <pipelined autoStart="true" ... "/>

파이프라인 프로세스 다시 시작 pipelined-process-restart

변경 사항을 적용하려면 다시 시작해야 합니다.

nlserver restart pipelined@instance

4단계: 유효성 검사 step-validation

프로비저닝에 대한 파이프라인 설정의 유효성을 검사하려면 아래 단계를 수행하십시오.

  • 다음을 확인합니다. pipelined 프로세스가 실행 중입니다.
  • pipelined.log에서 파이프라인 연결 로그를 확인합니다.
  • 연결을 확인하고 Ping이 수신되는지 확인합니다. 호스팅된 고객은 클라이언트 콘솔에서 모니터링을 사용할 수 있습니다.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1