DokumentationCampaignDokumentation för Campaign Classic v7

[v7]{class="badge informative" title="Gäller Campaign Classic v7"} [v8]{class="badge positive" title="Gäller även Campaign v8"}

Konfigurerar pipeline configuring-pipeline

Last update: Tue Mar 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Autentiseringsparametrar som kund-ID, privat nyckel och autentiseringsslutpunkt konfigureras i instanskonfigurationsfilerna.
Listan med utlösare som ska bearbetas konfigureras i ett alternativ i JSON-format.
Utlösarna används för att målinrikta via ett kampanjarbetsflöde som skickar e-post. Kampanjen är konfigurerad så att en kund som har båda utlösarhändelserna får ett e-postmeddelande.

Förhandskrav prerequisites

Innan du startar konfigurationen bör du kontrollera att du använder:

  • Minst en av följande Adobe Campaign-byggen:

    • 19.1.8.9039
    • 19.1.4.9032 - Gold Standard 11
    • 20.2.4.9187
    • 20.3.1

  • Adobe Analytics Standard

Du behöver också:

  • Adobe I/O projektautentisering
  • ett giltigt organisations-ID - Om du vill hitta ditt organisations-ID, se den här sidan
  • en utvecklaråtkomst till din organisation
  • utlöser konfiguration som gjorts i Adobe Analytics

Autentiserings- och konfigurationsfiler authentication-configuration

Autentisering krävs eftersom pipeline lagras i Adobe Experience Cloud.
Den använder ett par offentliga och privata nycklar. Den här processen har samma funktion som en användare/ett lösenord, men är säkrare.
Autentisering stöds för Marketing Cloud via Adobe I/O Project.

Steg 1: Skapa/uppdatera Adobe I/O-projekt creating-adobe-io-project

För kunder med värdtjänst kan du skapa en kundtjänstbiljett som gör att din organisation kan använda Adobe I/O Technical Account Tokens för integrering av utlösare.

För On Premise-kunder, se Konfigurera Adobe I/O för Adobe Experience Cloud Triggers sida. Observera att du måste välja Adobe Analytics när API lades till i Adobe I/O-autentiseringsuppgifterna.

Steg 2: Konfigurera pipelinealternativet NmsPipeline_Config configuring-nmspipeline

När autentiseringen är klar hämtas händelserna. Det bearbetar bara utlösare som har konfigurerats i Adobe Campaign. Utlösaren måste ha genererats från Adobe Analytics och skickats till pipeline, som endast kommer att bearbeta utlösare som har konfigurerats i Adobe Campaign.
Alternativet kan också konfigureras med ett jokertecken för att fånga upp alla utlösare oavsett namn.

  1. I Adobe Campaign finns alternativmenyn under Administration > Platform > Options i Explorer.

  2. Välj NmsPipeline_Config alternativ.

  3. I Value (long text) kan du klistra in följande JSON-kod som anger två utlösare. Du måste se till att ta bort kommentarer.

    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. Du kan också välja att klistra in följande JSON-kod som fångar alla utlösare.

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

Parametern Consumer consumer-parameter

Rörledningen fungerar som en leverantör och en konsumentmodell. Meddelanden används endast för en enskild konsument: varje konsument får sin egen kopia av meddelandena.

The Konsument parameter identifierar förekomsten som en av dessa konsumenter. Instansens identitet anropar pipelinen. Du kan fylla den med instansnamnet som finns på sidan Övervakning på klientkonsolen.

Pipeline-tjänsten håller reda på meddelanden som hämtats av varje konsument. Om du använder olika konsumenter för olika instanser kan du se till att alla meddelanden skickas till varje instans.

Rekommendationer för försäljningsalternativ pipeline-option-recommendation

Om du vill konfigurera alternativet för pipeline bör du följa dessa rekommendationer:

  • Lägg till eller redigera utlösare under Triggers ska du inte redigera resten.
  • Kontrollera att JSON är giltig. Du kan använda en JSON-validerare, se webbplats till exempel.
  • "name" motsvarar utlösar-ID:t. Ett jokertecken "*" fångar upp alla utlösare.
  • "Consumer" motsvarar namnet på den anropande instansen eller det anropande programmet.
  • Pipelined har också stöd för ämnet"alias".
  • Du bör alltid starta om pipelined när du har gjort ändringar.

Steg 3: Valfri konfiguration step-optional

Du kan ändra vissa interna parametrar utifrån dina lastkrav, men se till att testa dem innan du sätter dem i produktion.

Listan med valfria parametrar finns nedan:

Alternativ
Beskrivning
appName(Legacy)
AppID för OAuth-programmet som är registrerat i det äldre Oath-programmet där den offentliga nyckeln överfördes. Se denna sida för mer information om detta
authGatewayEndpoint(Legacy)
URL för att hämta gatewaytoken. Standard: https://api.omniture.com
authPrivateKey(Legacy)
Den privata nyckeln, den offentliga delen som överförts i det äldre Oath-programmet, AES som krypterats med alternativet XtkKey: cryptString("PRIVATE_KEY")
disableAuth(Legacy)
Inaktivera autentisering, anslutning utan gatewaytoken accepteras bara av vissa slutpunkter i utvecklingsfasen.
discoverPipelineEndpoint
URL för att hitta slutpunkten för Pipeline Services som ska användas för den här klienten. Standard: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
Period mellan två dumpar av den interna tillståndsprocessen i var/INSTANCE/pipelined.json.
Den interna statusen är även tillgänglig på begäran här: http://INSTANCE:7781/pipelined/status
forceradPipelineEndpoint
Inaktivera identifiering av PipelineServicesEndpoint för att framtvinga den
monitorServerPort
Den rörliga processen avlyssnar den här porten för att tillhandahålla den interna tillståndsprocessen här: http://INSTANCE:PORT/pipelined/status.
Standardvärdet är 7781
pointerFlushMessageCount
När det här antalet meddelanden bearbetas sparas förskjutningarna i databasen.
Standardvärdet är 1000
pekareFlushPeriodSec
Efter den här perioden sparas förskjutningarna i databasen.
Standardvärdet är 5 (sek)
processingJSThreads
Antal dedikerade trådar som bearbetar meddelanden med anpassade JS-anslutningar.
Standard är 4
processingThreads
Antal dedikerade trådar som bearbetar meddelanden med inbyggd kod.
Standard är 4
retryPeriodSec
Fördröjning mellan återförsök vid fel vid bearbetning.
Standardvärdet är 30 (sekunder)
retryValiditySec
Ignorera meddelandet om det inte har bearbetats korrekt efter den här perioden (för många försök).
Standardvärdet är 300 (sekunder)

Automatisk processstart i pipeline pipelined-process-autostart

Processen med rörlig orientering måste startas automatiskt.

För detta anger du elementet < pipelined > i konfigurationsfilen som autostart="true":

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

Omstart av process i pipeline pipelined-process-restart

En omstart krävs för att ändringarna ska börja gälla:

nlserver restart pipelined@instance

Steg 4: Validering step-validation

Följ stegen nedan för att validera pipeline-konfigurationen för etablering:

  • Se till att pipelined processen körs.
  • Kontrollera om det finns anslutningsloggar för pipeline i filen pipelined.log.
  • Kontrollera anslutningen och om ping-filer tas emot. Värdkunder kan använda övervakning från klientkonsolen.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1