ドキュメントCampaignCampaign Classic v7 ドキュメント

[v8 にも適用されます]{class="badge positive" title="Campaign v8 にも適用されます"}

パイプラインの設定 configuring-pipeline

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

顧客 ID、秘密鍵、認証エンドポイントなどの認証パラメーターは、インスタンス設定ファイルで設定します。

処理されるトリガーのリストは、JSON フォーマットでオプションに設定されます。

トリガーは、メールを送信するキャンペーンワークフローでターゲティングに使用されます。キャンペーンは、両方のトリガーイベントを持つ顧客がメールを受信するように設定されています。

前提条件 prerequisites

この設定を開始する前に、以下があることを確認してください。

  • Adobe Developer プロジェクト
  • 有効な組織 ID - 組織 ID を見つけるには、このページ を参照してください。
  • 組織への開発者のアクセス
  • Adobe Analytics での有効なトリガー設定

パイプラインは Adobe Experience Cloud でホストされるので、認証が必要です。Adobe Developer プロジェクト経由でサポートされている認証を使用します。

手順 1：Adobe Developer プロジェクトを作成／更新 creating-adobe-io-project

トリガー統合用の Adobe Developer アカウントトークンを使用して、組織を有効にする必要があります。

アドビのテクニカルアカウントの作成方法については、このページを参照してください。Adobe Developer 資格情報に API を追加する際に、「Adobe Analytics」を選択する必要があります。

手順 2：パイプラインオプションを設定 configuring-nmspipeline

認証が設定されると、パイプラインはイベントを取得します。Adobe Campaign で設定されたトリガーのみが処理されます。トリガーは、Adobe Analytics から生成され、Adobe Campaign で設定されたトリガーのみを処理するパイプラインに送られる必要があります。

また、名前に関係なく、すべてのトリガーを取得するように、ワイルドカードを使用して設定することもできます。

  1. Adobe Campaign の​ エクスプローラー ​で、管理／プラットフォーム／オプション ​のオプションメニューにアクセスします。

  2. 「NmsPipeline_Config」オプションを選択します。

  3. 「値 (長いテキスト)」フィールドに、次の JSON コードを貼り付けることができます。このコードは、2 つのトリガーを指定します。コメントは必ず削除してください。

    code language-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 コードを貼り付けることもできます。

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

Consumer パラメーターを設定 consumer-parameter

パイプラインは、「サプライヤーとコンシューマー」モデルのように機能します。メッセージは、個々のコンシューマーによってのみ消費されます。コンシューマーはそれぞれ、メッセージのコピーを取得します。

Consumer パラメーターは、インスタンスをこれらのコンシューマーの 1 つとして識別します。インスタンスの ID がパイプラインを呼び出します。クライアントコンソールの監視ページにあるインスタンス名を入力できます。

パイプラインサービスは、各コンシューマーが取得したメッセージを追跡します。異なるインスタンスに異なるコンシューマーを使用すると、すべてのメッセージを各インスタンスに送信するようにできます。

パイプラインオプションのレコメンデーション pipeline-option-recommendation

パイプラインオプションを設定するには、次のレコメンデーションに従う必要があります。

  • トリガー ​でトリガーを追加または編集します。
  • JSON が有効であることを確認します。
  • Name パラメーターは、トリガー ID に対応します。ワイルドカード「*」は、すべてのトリガーを取得します。
  • Consumer パラメーターは、呼び出し元のインスタンスまたはアプリケーションの名前に対応します。
  • pipelined プロセスでは、「aliases」トピックもサポートしています。
  • 変更を加えた後は、必ず pipelined プロセスをやり直す必要があります。

（オプション）手順 3：追加の設定 step-optional

一部の内部パラメーターは、必要な読み込み量に応じて変更できますが、実稼動環境に適用する前に必ずテストする必要があります。

オプションのパラメーターのリストを以下に示します。

オプション
説明
appName(Legacy)
公開鍵がアップロードされた OAuth レガシーアプリケーションに登録されている OAuth アプリケーションの App ID。詳しくは、このページを参照してください。
authGatewayEndpoint（レガシー）
ゲートウェイトークンを取得するための URL。デフォルト：https://api.omniture.com
authPrivateKey（レガシー）
秘密鍵、OAuth レガシーアプリケーションにアップロードされた公開部分、XtkKey オプション「cryptString("PRIVATE_KEY")」で暗号化された AES。
disableAuth（レガシー）
認証の無効化（ゲートウェイトークンを使用せずに接続することは、一部の開発パイプラインエンドポイントでのみ可能）。
discoverPipelineEndpoint
このテナントに使用するパイプラインサービスエンドポイントを見つけるための URL。デフォルト：https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
var/INSTANCE/pipelined.json. での内部ステートプロセスの 2 つのダンプ間の期間
内部ステートはオンデマンドで http://INSTANCE:7781/pipelined/status でもアクセスできます。
forcedPipelineEndpoint
PipelineServicesEndpoint の検出を無効にし、強制的におこないます。
monitorServerPort
パイプライン化されたプロセスは、このポートでリッスンして内部ステートプロセスを http://INSTANCE:PORT/pipelined/status で提供します。
デフォルトは 7781 です。
pointerFlushMessageCount
この数のメッセージが処理されると、オフセットがデータベースに保存されます。
デフォルトは 1000 です。
pointerFlushPeriodSec
この期間を過ぎると、オフセットがデータベースに保存されます。
デフォルトは 5（秒）です。
processingJSThreads
カスタム JS コネクタを使用してメッセージを処理する専用スレッドの数。
デフォルトは 4 です。
processingThreads
ビルトインコードを使用してメッセージを処理する専用スレッドの数。
デフォルトは 4 です。
retryPeriodSec
処理エラーの場合の再試行間の遅延。
デフォルトは 30（秒）です。
retryValiditySec
この期間が経過してもメッセージが正常に処理されない場合（再試行回数が多すぎる場合）、メッセージを破棄します。
デフォルトは 300（秒）です。

パイプライン化されたプロセスの自動開始 pipelined-process-autostart

pipelined プロセスは自動的に開始する必要があります。

この場合、設定ファイルの <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