DocumentatieCampaignDocumentatie voor Campaign Classic v7

[Ook van toepassing op v8]{class="badge positive" title="Ook van toepassing op campagne v8"}

Gasleiding configureren configuring-pipeline

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

De parameters van de authentificatie zoals klantenidentiteitskaart, de privé sleutel, en het authentificatieeindpunt worden gevormd in de dossiers van de instantieconfiguratie.
De lijst met triggers die moeten worden verwerkt, is geconfigureerd in een optie in JSON-indeling.
De triggers worden gebruikt voor het activeren van een campagneworkflow die e-mails verzendt. De campagne is opgezet zodat een klant die beide triggergebeurtenissen heeft een e-mail ontvangt.

Vereisten prerequisites

Voordat u deze configuratie start, moet u controleren of u deze configuratie gebruikt:

  • Minimaal een van de volgende Adobe Campaign-builds:

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

  • Adobe Analytics Standard-versie

U hebt ook het volgende nodig:

  • Adobe I/O-projectverificatie
  • een geldige organisatie-id - Raadpleeg voor meer informatie over uw organisatie-id deze pagina
  • Een ontwikkelaar heeft toegang tot uw organisatie
  • triggerconfiguratie uitgevoerd in Adobe Analytics

Verificatie- en configuratiebestanden authentication-configuration

De authentificatie wordt vereist aangezien de pijpleiding in Adobe Experience Cloud wordt ontvangen.
Het gebruikt een paar openbare en privé sleutels. Dit proces heeft dezelfde functie als een gebruiker/wachtwoord, maar is veiliger.
Verificatie wordt ondersteund voor de Marketing Cloud via Adobe I/O Project.

Stap 1: het creëren van/het bijwerken van Adobe I/O Project creating-adobe-io-project

Voor Gehoste klanten, kunt u een kaartje van de klantenzorg tot stand brengen om uw organisatie met de Tokens van de Technische Rekening van Adobe I/O voor de integratie van Triggers toe te laten.

Voor klanten op locatie raadpleegt u de Adobe I/O configureren voor Adobe Experience Cloud Triggers pagina. Merk op dat u moet selecteren Adobe Analytics tijdens het toevoegen van API aan de Adobe I/O-referentie.

Stap 2: Het vormen NmsPipeline_Config pijpleidingsoptie configuring-nmspipeline

Zodra de authentificatie wordt geplaatst, zal de pijpleiding de gebeurtenissen terugwinnen. Het zal slechts trekkers verwerken die in Adobe Campaign worden gevormd. De trekker moet van Adobe Analytics zijn geproduceerd en aan de pijpleiding geduwd die slechts trekkers zal verwerken die in Adobe Campaign worden gevormd.
De optie kan ook met een vervanging worden gevormd om alle trekkers ongeacht de naam te vangen.

  1. Open in Adobe Campaign het optiemenu onder Administration > Platform > Options in de Explorer.

  2. Selecteer de NmsPipeline_Config -optie.

  3. In de Value (long text) kunt u de volgende JSON-code plakken, die twee triggers opgeeft. U moet ervoor zorgen dat opmerkingen worden verwijderd.

    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. U kunt ook de volgende JSON-code plakken waarmee alle triggers worden afgevangen.

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

De parameter Consumenten consumer-parameter

De pijpleiding werkt als een leverancier- en consumentenmodel. Berichten worden alleen voor een individuele consument verbruikt: elke consument krijgt zijn eigen exemplaar van de berichten.

De Consumenten parameter geeft de instantie aan als een van deze consumenten . De identiteit van de instantie zal de pijpleiding roepen. U kunt deze vullen met de instantienaam die u kunt vinden op de pagina Bewaking van de clientconsole.

De pijpleidingsdienst houdt spoor van de berichten die door elke consument worden teruggewonnen. Door verschillende consumenten voor verschillende instanties te gebruiken, kunt u ervoor zorgen dat elk bericht naar elke instantie wordt verzonden.

Aanbevelingen voor de optie Pipet pipeline-option-recommendation

Om de optie van de Pijl te vormen, zou u deze aanbevelingen moeten volgen:

  • Triggers toevoegen of bewerken onder Triggers, moet u de rest niet bewerken.
  • Controleer of de JSON geldig is. U kunt een JSON-validatie gebruiken. Raadpleeg deze website bijvoorbeeld.
  • "name" komt overeen met de trigger-id. Met jokerteken "*" worden alle triggers afgevangen.
  • "Consumenten" komt overeen met de naam van de oproepende instantie of toepassing.
  • Pijpleidingen ondersteunen ook het onderwerp "aliassen".
  • Nadat u wijzigingen hebt aangebracht, moet u de pipet altijd opnieuw starten.

Stap 3: Optionele configuratie step-optional

U kunt enkele interne parameters wijzigen op basis van de vereisten voor de belasting, maar zorg dat u deze test voordat u ze in productie neemt.

De lijst met optionele parameters is hieronder te vinden:

Optie
Beschrijving
appName(Legacy)
AppID van de OAuth-toepassing die is geregistreerd in de Legacy Oath-toepassing waar de openbare sleutel is geüpload. Raadpleeg deze pagina voor meer informatie
authGatewayEndpoint(Legacy)
URL om gatewaytokens te krijgen. Standaard: https://api.omniture.com
authPrivateKey(Verouderd)
De persoonlijke sleutel, het openbare deel dat in de Oudere Oath-toepassing wordt geüpload, AES gecodeerd met de optie XtkKey: cryptString("PRIVATE_KEY")
disableAuth(Legacy)
Schakel authentificatie uit, verbindend zonder gatewaytokens slechts door sommige eindpunten van de ontwikkelingsPijpleiding zal worden goedgekeurd.
findPipelineEndpoint
URL om het eindpunt te vinden van de Diensten van de Pijpleiding dat voor deze huurder moet worden gebruikt. Standaard: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
Periode tussen twee dumps van het interne statusproces in var/INSTANCE/pipelined.json.
De interne staat is ook hier op bestelling toegankelijk: http://INSTANCE:7781/pipelined/status
forcePipelineEndpoint
Maak de opsporing van PipelineServicesEndpoint onbruikbaar om het te dwingen
monitorServerPort
Met behulp van een leidinggevend proces wordt naar deze poort geluisterd om het interne statusproces hier te verzorgen: http://INSTANCE:PORT/pipelined/status.
Standaard is 7781
pointerFlushMessageCount
Wanneer dit aantal berichten wordt verwerkt, zullen de compensatie in het gegevensbestand worden bewaard.
Standaard is 1000
pointerFlushPeriodSec
Na deze periode worden de offsets opgeslagen in de database.
Standaard is 5 (sec)
processingJSThreads
Aantal specifieke draden verwerkend berichten met de schakelaars van douaneJS.
Standaard is 4
processingThreads
Aantal specifieke draden verwerkend berichten met ingebouwde code.
Standaard is 4
retryPeriodSec
Vertraging tussen pogingen bij verwerkingsfouten.
Standaard is 30 (sec)
retryValiditySec
Verwijder het bericht als het na deze periode niet succesvol is verwerkt (te veel pogingen).
De standaardwaarde is 300 (sec)

Automatische start van het pijplijnproces pipelined-process-autostart

Het pijplijnproces moet automatisch worden gestart.

Voor dit, plaats het < pijpleiding > element in het config dossier aan autostart= "waar":

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

Opnieuw opstarten van het pijlproces pipelined-process-restart

De wijzigingen worden pas van kracht als u de toepassing opnieuw start:

nlserver restart pipelined@instance

Stap 4: Validatie step-validation

Volg onderstaande stappen om de installatie van de pijplijn voor provisioning te valideren:

  • Zorg ervoor dat de pipelined -proces wordt uitgevoerd.
  • Controleer pipelined.log voor de logboeken van de pijpleidingsverbinding.
  • Verifieer de verbinding en als pingelt worden ontvangen. Gehoste klanten kunnen de Controle van de Console van de Cliënt gebruiken.
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1