In deze documentatie wordt beschreven hoe u AEM kunt integreren met Adobe Campaign Classic, de on-premise oplossing. Als u Adobe Campaign Standard gebruikt, zie Integratie met Adobe Campaign Standard voor die instructies.
Met Adobe Campaign kunt u inhoud en formulieren voor e-maillevering rechtstreeks in Adobe Experience Manager beheren.
Om beide oplossingen samen tezelfdertijd te gebruiken, moet u hen eerst vormen om met elkaar te verbinden. Dit omvat configuratiestappen in zowel Adobe Campaign als Adobe Experience Manager. Deze stappen worden in dit document uitgebreid beschreven.
Het werken met Adobe Campaign in AEM omvat de capaciteit om e-mail via Adobe Campaign te verzenden en wordt beschreven bij Werken met Adobe Campaign. Dit omvat ook het gebruik van formulieren op AEM pagina's voor het bewerken van gegevens.
Bovendien kunnen de volgende onderwerpen van belang zijn wanneer het integreren van AEM met Adobe Campaign:
Als u uw integratie met Adobe Campaign uitbreidt, wilt u wellicht de volgende pagina's zien:
In deze sectie wordt een typische workflow beschreven tussen AEM en Adobe Campaign bij het maken van campagnes en het leveren van inhoud.
De typische werkstroom omvat het volgende en wordt in detail beschreven:
Je begint op elk moment een campagne te ontwikkelen. Voordat u de inhoud met elkaar verbindt, zijn AEM en AC onafhankelijk. Dit betekent dat marketers hun campagnes kunnen starten en zich kunnen richten in Adobe Campaign, terwijl makers van inhoud aan het ontwerp werken in AEM.
Voordat u de inhoud koppelt en een leveringsmechanisme maakt, moet u het volgende doen:
In AEM
In Adobe Campaign
Nadat u de inhoud voor het verbinden en levering hebt voorbereid, bepaalt u precies hoe en waar om inhoud te verbinden.
Al deze stappen zijn voltooid in Adobe Campaign.
Als u nog niet eerder AEM, zijn de volgende koppelingen wellicht handig voor AEM:
Bij het configureren van Adobe Campaign gaat het om het volgende:
Bovendien zijn er geavanceerde configuraties die u kunt maken, die omvatten:
Zie Geavanceerde configuraties.
Als u deze bewerkingen wilt uitvoeren, moet u de rol administration in Adobe Campaign hebben.
Zorg ervoor dat u de volgende elementen vooraf hebt:
Als u een versie vroeger dan Adobe Campaign Classic bouwt 8640 in werking stelt, zie verbeteringsdocumentatie voor meer informatie. Merk op dat zowel de cliënt als het gegevensbestand aan zelfde bouwstijl moeten worden bevorderd.
Bewerkingen die worden beschreven in de secties Adobe Campaign configureren en Adobe Experience Manager configureren zijn nodig om de integratiefuncties tussen AEM en Adobe Campaign correct te laten werken.
U moet AEM Integratie pakket in Adobe Campaign installeren. Dit doet u als volgt:
Ga naar de Adobe Campaign-instantie die u wilt koppelen aan AEM.
Selecteer Gereedschappen > Geavanceerd > Pakket importeren….
Klik Installeer een standaardpakket, dan selecteer AEM Integratie pakket.
Klik Volgende, en dan Begin.
Dit pakket bevat de aemserver operator die wordt gebruikt om de AEM server aan te sluiten op Adobe Campaign.
Door gebrek, wordt geen veiligheidsstreek gevormd voor deze exploitant. Als u via AEM verbinding wilt maken met Adobe Campaign, moet u er een selecteren.
In het serverConf.xml-bestand moet het allowUserPassword-kenmerk van de geselecteerde beveiligingszone zijn ingesteld op true om AEM te machtigen om Adobe Campaign via aanmelding/wachtwoord te verbinden.
We raden u ten zeerste aan een beveiligingszone in te stellen die is gewijd aan AEM om beveiligingsproblemen te voorkomen. Raadpleeg voor meer informatie de Installatiegids.
U moet een externe account configureren waarmee u Adobe Campaign kunt verbinden met uw AEM.
Een externe AEM-account configureren:
Ga naar Beheer > Platform > Externe accounts.
Maak een nieuwe externe account en selecteer het type AEM.
Voer de toegangsparameters voor de AEM ontwerpinstantie in: het serveradres en de id en het wachtwoord waarmee u verbinding maakt met deze instantie. Het wachtwoord van de campagne-api-gebruikersrekening is het zelfde als de campagne-verre gebruiker die u een wachtwoord voor in AEM plaatst.
Zorg ervoor dat het serveradres niet eindigt in een sluitslash. Typ bijvoorbeeld https://yourserver:4502
in plaats van https://yourserver:4502/
Zorg ervoor dat Enabled checkbox wordt geselecteerd.
De optie AEMResourceTypeFilter wordt gebruikt om typen AEM te filteren die in Adobe Campaign kunnen worden gebruikt. Op deze manier kan Adobe Campaign AEM inhoud ophalen die specifiek is ontworpen voor gebruik in alleen Adobe Campaign.
Deze optie moet vooraf worden geconfigureerd; als u deze optie wijzigt, kan dit echter tot een niet-functionerende integratie leiden.
Om te verifiëren wordt de optie AEMResourceTypeFilter gevormd:
Ga naar Platform >Opties.
Controleer in de optie AEMResourceTypeFilter of de paden juist zijn. Dit veld moet de waarde bevatten:
mcm/campagne/componenten/nieuwsbrief,mcm/campagne/componenten/campagne_newsletterpage,mcm/neolane/components/nieuwsbrief
In sommige gevallen is de waarde als volgt:
mcm/campagne/componenten/nieuwsbrief
Om AEM te vormen, moet u het volgende doen:
Inhoud die is gemaakt van de AEM authoring instantie wordt eerst naar de publishing-instantie verzonden. U moet publiceren zodat de afbeeldingen in de nieuwsbrief beschikbaar zijn op het publicatieexemplaar en aan ontvangers voor de nieuwsbrief. De replicatieagent moet daarom worden gevormd om van de AEM auteursinstantie aan de AEM het publiceren instantie te herhalen.
Als u de replicatie-URL niet wilt gebruiken maar in plaats daarvan de publieksgerichte URL, kunt u Openbare URL in de volgende configuratie plaatsen die in OSGi (AEM logo > Hulpmiddelen pictogram > Verrichtingen > Webconsole > <a 10/>OSGi Configuration > AEM Campagne Integration - Configuration ):
Openbare URL: com.day.cq.mcm.campagne.impl.IntegrationConfigImpl#aem.mcm.campagne.publicUrl
Deze stap is ook nodig om bepaalde configuraties van ontwerpinstanties te repliceren in de publicatieinstantie.
Om replicatie tussen AEM instanties te vormen:
Selecteer AEM logo Tools pictogram > Implementatie > Replication > Agents op auteur en klik vervolgens op Default Agent.
Vermijd het gebruik van localhost (een lokale kopie van AEM) bij het configureren van uw integratie met Adobe Campaign, tenzij de publicatie- en auteurinstantie beide op dezelfde computer staan.
Tik of klik op Bewerken en selecteer vervolgens het tabblad Vervoer.
Vorm URI door localhost met het IP adres of het adres van de AEM het publiceren instantie te vervangen.
Voordat u AEM en Adobe Campaign samen kunt gebruiken, moet u het verband tussen beide oplossingen tot stand brengen zodat zij kunnen communiceren.
Verbind met uw AEM authoring instantie.
Selecteer AEM logo > Gereedschappen pictogram > Implementatie > Cloud Services en Configureer nu in de sectie Adobe Campaign.
Maak een nieuwe configuratie door een Titel in te voeren en op Maken te klikken, of kies de bestaande configuratie die u met uw Adobe Campaign-instantie wilt koppelen.
Bewerk de configuratie zodat deze overeenkomt met de parameters van uw Adobe Campaign-instantie.
Selecteer Verbinding maken met Adobe Campaign en klik op OK.
Nadat u uw e-mail creeert en het publiceert, moet u de configuratie op uw publiceren instantie opnieuw publiceren.
Als de verbinding ontbreekt, zorg ervoor u het volgende controleert:
Daarnaast raadpleegt u Problemen met uw integratie tussen AEM en Adobe Campaign oplossen.
U moet externalizer in AEM op uw auteursinstantie vormen. ExternalAlizer is de dienst OSGi die u een middelweg in een externe en absolute URL laat omzetten. Deze service biedt een centrale plaats om die externe URL's te configureren en samen te stellen.
Zie De externalizer voor algemene instructies configureren. Voor de integratie van Adobe Campaign moet u de publicatieserver op https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl
niet richten naar localhost:4503
maar naar een server die bereikbaar is door de Adobe Campaign-console.
Als het verwijst naar localhost:4503
of een andere server die Adobe Campaign niet kan bereiken, worden uw afbeeldingen niet weergegeven op de Adobe Campaign-console.
U kunt ook een aantal geavanceerde configuraties uitvoeren, namelijk:
De velden en blokken die beschikbaar zijn om personalisatie aan uw e-mailinhoud in AEM toe te voegen, worden beheerd door Adobe Campaign.
Er is een standaardlijst opgegeven, maar deze kan worden gewijzigd. U kunt ook aanpassingsvelden en blokken toevoegen of verbergen.
Om een nieuw verpersoonlijkingsgebied aan die toe te voegen die reeds beschikbaar zijn, moet u het schema van Adobe Campaign nms:seedMember als volgt uitbreiden:
Het gebied dat u moet toevoegen moet reeds via een ontvankelijke schemauitbreiding (nms:ontvanger) zijn toegevoegd. Voor meer informatie, zie Configuratie gids.
Ga naar Beheer > Configuratie > Gegevensschema's in de navigatie van Adobe Campaign.
Selecteer Nieuw.
Selecteer De gegevens in de tabel uitbreiden met een extensieschema in het pop-upvenster en klik op Volgende.
Voer de verschillende parameters van het uitgebreide schema in:
Bewerk de XML-code van het schema om het veld op te geven dat u daar wilt toevoegen. Voor meer informatie bij het uitbreiden van schema's in Adobe Campaign, verwijs naar de gids van de Configuratie.
Sla uw schema op en werk vervolgens de Adobe Campaign-databasestructuur bij via het menu Tools > Advanced > Update databasestructuur in de console.
Verbinding verbreken en vervolgens opnieuw verbinding maken met de Adobe Campaign-console om uw wijzigingen op te slaan. Het nieuwe veld wordt nu weergegeven in de lijst met aanpassingsvelden die beschikbaar zijn in AEM.
Als u een veld Registratienummer wilt toevoegen, moet u de volgende elementen hebben:
<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">
<attribute dataPolicy="smartCase" desc="Recipient registration number"
label="Registration Number"
length="50" name="registrationNumber" type="string"/>
</element>
De schema-extensie nms:seedMember met de naam cus:seedMember bevat:
<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
<element name="custom_nms_recipient">
<attribute name="registrationNumber"
template="cus:recipient:recipient/@registrationNumber"/>
</element>
</element>
Het veld Registratienummer maakt nu deel uit van de beschikbare verpersoonlijkingsvelden:
Om een verpersoonlijkingsgebied onder die te verbergen die reeds beschikbaar zijn, moet u het schema van Adobe Campaign nms uitbreiden nms:seedMember zoals die in een verpersoonlijkingsgebied wordt gedetailleerd. Voer de volgende stappen uit:
Kopieer het veld dat u wilt ophalen uit het schema nms:seedMember in het uitgebreide schema (cus:seedMember bijvoorbeeld).
Voeg het advanced="true" attribuut van XML aan het gebied toe. Deze wordt niet meer weergegeven in de lijst met personalisatievelden die beschikbaar zijn in AEM.
Als u bijvoorbeeld het veld Middennaam wilt verbergen, moet het schema cud:seedMember het volgende element bevatten:
<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
<element name="custom_nms_recipient">
<attribute advanced="true" name="middleName"/>
</element>
</element>
Een van de beschikbare personalisatieklokken deactiveren:
Ga naar Bronnen > Campagnebeheer > Personalisatieblokken in de navigatie van Adobe Campaign.
Selecteer het verpersoonlijkingsblok dat u in AEM wilt deactiveren.
Schakel het selectievakje Zichtbaar in de aanpassingsmenu's uit en sla uw wijzigingen op. Het blok wordt niet meer weergegeven in de lijst met aanpassingsblokken die beschikbaar zijn in Adobe Campaign.
U kunt de gegevens van de doeluitbreiding voor verpersoonlijking ook opnemen. De gegevens van de uitbreiding van het doel (ook genoemd "Gegevens van het Doel"), komen uit het verrijken van of het toevoegen van gegevens in een vraag in een campagnewerkschema bijvoorbeeld. Raadpleeg de secties Query's maken en Gegevens verrijken voor meer informatie.
De gegevens in het doel zijn alleen beschikbaar als de AEM inhoud is gesynchroniseerd met een Adobe Campaign-levering. Zie In AEM gemaakte inhoud synchroniseren met een levering vanuit Adobe Campaign.