파이프라인 구성

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

주의

하이브리드 배포의 경우 파이프라인이 mid 인스턴스에 구성되어 있는지 확인하십시오.

기본 사항

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

  • 최소, 다음 Adobe Campaign 빌드 중 하나:
    • 19.1.8.9039
    • 19.1.4.9032.GS.11
    • 20.2.4.9187
    • 20.3.1
  • Adobe Analytics Standard 버전

다음을 수행해야 합니다.

  • 프로젝트 인증 Adobe I/O
  • Adobe Analytics을 사용하는 Experience Cloud 고객의 식별자인 유효한 IMSOrgID가 추가되었습니다.
  • IMS 조직에 대한 개발자 액세스 권한
  • Adobe Analytics에서 수행된 트리거 구성

인증 및 구성 파일

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

1단계:Adobe I/O 프로젝트 만들기/업데이트

호스팅된 고객의 경우 트리거 통합을 위해 기술 계정 토큰 Adobe I/O으로 조직을 활성화하도록 고객 지원 티켓을 만들 수 있습니다.

온-프레미스 고객의 경우 Adobe Experience Cloud Triggers에 대한 Adobe I/O 구성 페이지를 참조하십시오. Adobe I/O 자격 증명에 API를 추가하는 동안 Adobe Analytics 을 선택해야 합니다.

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

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

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

  2. NmsPipeline_Config 옵션을 선택합니다.

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

    {
    "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. 모든 트리거를 캡처하는 다음 JSON 코드를 붙여 넣도록 선택할 수도 있습니다.

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

소비자 매개 변수

파이프라인은 공급자 및 소비자 모델과 같이 작동합니다. 메시지는 개별 소비자에 대해서만 사용됩니다.각 소비자는 고유한 메시지 복사본을 가져옵니다.

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

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

파이프라인 옵션 권장 사항

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

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

3단계:옵션 구성

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

선택적 매개 변수 목록은 아래에서 확인할 수 있습니다.

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

파이프라인 프로세스 자동 시작

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

이렇게 하려면 구성 파일에서 < pipelled > 요소를 autostart="true"로 설정합니다.

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

파이프라인 프로세스가 다시 시작됩니다.

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

nlserver restart pipelined@instance

4단계:유효성 검사

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

  • pipelined 프로세스가 실행 중인지 확인합니다.
  • pipelined.log에서 파이프라인 연결 로그를 확인합니다.
  • 연결 및 Ping이 수신되었는지 확인합니다. 호스팅된 고객은 클라이언트 콘솔에서 모니터링을 사용할 수 있습니다.

이 페이지에서는