{"id":57700,"date":"2023-07-11T09:06:08","date_gmt":"2023-07-11T03:36:08","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=57700"},"modified":"2024-06-10T15:38:36","modified_gmt":"2024-06-10T10:08:36","slug":"campaign-standard-integration-in-aem","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/campaign-standard-integration-in-aem\/","title":{"rendered":"Campaign Standard Integration in AEM"},"content":{"rendered":"

Introduction:<\/strong><\/h3>\n

In this comprehensive guide, we will walk you through the end-to-end process of integrating Adobe Campaign Standard into Adobe Experience Manager (AEM) with a real-world use case. You will learn how to seamlessly connect the two platforms and leverage the power of Adobe Campaign’s marketing automation capabilities within AEM. We will cover the steps from setting up the integration, creating projects, generating key pairs, and establishing secure authentication. With a practical use case, we will demonstrate how to retrieve customer profiles, send personalized transactional messages, and seamlessly subscribe users to newsletters. Get ready to unlock the full potential of Adobe Campaign Standard within your AEM environment.
\n<\/strong><\/p>\n

Prerequisites:<\/strong><\/h3>\n
    \n
  1. \u00a0You should have access to\u00a0Adobe developer console.<\/a><\/li>\n
  2. \u00a0On dev console, you should have access to\u00a0Adobe Campaign.<\/a><\/li>\n
  3. \u00a0You should have access to Adobe Campaign Standard instance access as well to create campaigns and messages.<\/li>\n<\/ol>\n

    Steps to Integrate Adobe Campaign APIs in AEM project<\/h3>\n
      \n
    1. Create an account at the\u00a0Adobe developer console<\/a>.<\/li>\n
    2. On dev console, create a project and add the Campaign API to it.<\/li>\n
    3. Generate key pair in project setup and store the private key from the downloaded config file.<\/li>\n
    4. Navigate to the API documentation to see which operations you can perform in Adobe Campaigns via Adobe I\/O.<\/li>\n
    5. Set up a connection with the campaign standard server using the JWT token to fetch the access token. You can find\u00a0documentation\u00a0<\/a>on how to do this on the developer console.<\/li>\n
    6. Now you have the access token, and you can make use of all the available APIs from Adobe I\/O.<\/li>\n<\/ol>\n

      Steps Explained<\/u><\/h2>\n

      1.\u00a0 Create Project for Campaigns at the Adobe dev console<\/h3>\n
        \n
      1. Navigate to the\u00a0dev console<\/a>. If not created the account, create and proceed.
        \n        Create a project<\/a>\u00a0for your application.<\/li>\n
      2. Once created, add Campaign API<\/a>\u00a0to your project. Select Adobe Campaign and then Generate Key pair in the next step.\n

        config.zip gets downloaded. Public Key Certificate and the private key gets downloaded<\/li>\n

      3. After successful API creation, you will land on Adobe Campaign SDK details for your project with Service Account credentials info.<\/li>\n
      4. If you go to the last of the page, you can navigate to the API documentation<\/a><\/u> where you can make use of these credentials to access Campaign APIs.Here you can navigate which all operations we can perform in Adobe campaigns via Adobe I\/O.\n

        \"\"<\/li>\n<\/ol>\n

        2. Campaigns Standard Authentication<\/h3>\n

        You can set up connection with the campaign standard server using the JWT token to fetch Access Token. (documentation<\/a>)<\/p>\n

        From the config we downloaded earlier at the project creation on developer console,
        \nGet and store the private key<\/em>.<\/p>\n

        Adobe I\/O –\u00a0setting up API access steps<\/a><\/p>\n

        For implementation reference , check the code below:<\/p>\n

        \n
        Login API Post<\/b><\/div>\n
        \n
        \n
        \n
        \/\/privateKey = RSA private key retrieved earlier<\/code> \r\n\/\/ orgid = Organization id , techact = Technical Account Id.\u00a0<\/code> \r\n\/\/ apikey = Client id, clientsecret = Client Secret<\/code> \r\n\/\/AUTH_SERVER_FQDN = \"ims-na1.adobelogin.com\"\u00a0<\/code> \r\n\r\n\/\/Initialize JWT Claims(Payload)<\/code> \r\nString[] metascopes =\u00a0<\/code>new<\/code>\u00a0String[]{<\/code>\"ent_campaign_sdk\"<\/code>};<\/code> \r\nHashMap<String, Object> jwtClaims =\u00a0<\/code>new<\/code>\u00a0HashMap<>();<\/code> \r\njwtClaims.put(<\/code>\"iss\"<\/code>, orgid);<\/code> \r\njwtClaims.put(<\/code>\"sub\"<\/code>, techact);<\/code> \r\njwtClaims.put(<\/code>\"exp\"<\/code>, System.currentTimeMillis() \/\u00a0<\/code>1000<\/code>\u00a0+ 86400L);<\/code> \r\njwtClaims.put(<\/code>\"aud\"<\/code>,\u00a0<\/code>\"https:\/\/\"<\/code>\u00a0+ AUTH_SERVER_FQDN +\u00a0<\/code>\"\/c\/\"<\/code>\u00a0+ apikey);<\/code> \r\nfor<\/code>\u00a0(String metascope : metascopes) {<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>jwtClaims.put(<\/code>\"https:\/\/\"<\/code>\u00a0+ AUTH_SERVER_FQDN +\u00a0<\/code>\"\/s\/\"<\/code>\u00a0+ metascope, Boolean.TRUE);<\/code> \r\n}<\/code> \r\n\u00a0<\/code>\u00a0 \r\n\/\/sign with Private Key<\/code> \r\nString jwtToken = Jwts.builder().setClaims(jwtClaims).signWith(RS256, privateKey).compact();<\/code> \r\n\u00a0<\/code>\u00a0 \r\n\/\/Perform HTTP post<\/code> \r\nHttpPost authPostRequest =\u00a0<\/code>new<\/code>\u00a0HttpPost(<\/code>\"https:\/\/ims-na1.adobelogin.com\/ims\/exchange\/jwt\/<\/a>\"<\/code>);<\/code> \r\nauthPostRequest.addHeader(CACHE_CONTROL, NO_CACHE);<\/code> \r\nList<NameValuePair> params =\u00a0<\/code>new<\/code>\u00a0ArrayList<>();<\/code> \r\nparams.add(<\/code>new<\/code>\u00a0BasicNameValuePair(<\/code>\"jwt_token\"<\/code>, jwtToken));<\/code> \r\nparams.add(<\/code>new<\/code>\u00a0BasicNameValuePair(<\/code>\"client_id\"<\/code>, apikey));<\/code> \r\nparams.add(<\/code>new<\/code>\u00a0BasicNameValuePair(<\/code>\"client_secret\"<\/code>, clientsecret));<\/code> \r\nauthPostRequest.setEntity(<\/code>new<\/code>\u00a0UrlEncodedFormEntity(params));<\/code> \r\nHttpResponse response = httpClient.execute(authPostRequest);<\/code> \r\n\u00a0<\/code>\u00a0 \r\n\/\/process response<\/code> \r\nHttpEntity entity = response.getEntity();<\/code> \r\nJsonObject jo =\u00a0<\/code>new<\/code>\u00a0JsonParser().parse(EntityUtils.toString(entity)).getAsJsonObject();<\/code> \r\nreturn<\/code>\u00a0jo.get(<\/code>\"access_token\"<\/code>).getAsString();<\/code><\/pre>\n
        <\/div>\n
        Now that we have the Access Token with Us,<\/p>\n<\/div>\n
        We can make use of all the available APIs from Adobe I\/O<\/div>\n<\/div>\n<\/div>\n<\/div>\n
        3. Retrieve Profiles from Campaign Standard<\/h3>\n
        API documentation<\/a><\/p>\n
        Added cURL, used in demo project, below for reference
        \nRetrieve Profiles<\/strong><\/p>\n
        \n
        \n
        \n
        \n\n\n\n
        \n
        \n
        curl --location -g --request GET\u00a0<\/code>'https:\/\/mc.adobe.io\/<\/a>{{org_id}}\/campaign\/profileAndServices\/profile'<\/code> \\<\/code> \r\n--header\u00a0<\/code>'X-Api-Key: {{api_key}}'<\/code>\u00a0\\<\/code> \r\n--header\u00a0<\/code>'Authorization; Bearer {{access_token}}'<\/code>\u00a0\\<\/code> \r\n--header\u00a0<\/code>'Content-Type: application\/json'<\/code>\u00a0\\<\/code> \r\n--data-raw '{<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>\"ctx\"<\/code>: {<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>},<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>\"email\"<\/code>:\u00a0<\/code>\"\\\"\\\\\\\"polidew222@agrolivana.com\\\\\\\"\\\"\"<\/code> \r\n}'<\/code><\/pre>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
        <\/div>\n
        Now we have the APIs in Place.<\/p>\n
        <\/span><\/div>\n<\/div>\n<\/div>\n
        We have integrated shooting emails from our demo AEM app via\u00a0Transactional Messaging<\/strong>\u00a0and subscribing to\u00a0Newsletter Campaigns<\/strong>\u00a0on Campaign Standard:<\/p>\n
        4. Sending Transactional Messages from the AEM app:<\/h3>\n
        API documentation<\/a> for creating transactional Messages on Campaign standard
        \nOnce you have followed the above steps and published & tested your transactional message
        \nYou can navigate to the Event configuration of the transactional message and check the Api preview for\u00a0        managing the message via REST Api<\/a>.<\/p>\n
        Refer to cURL below, used in our demo AEM app, for reference<\/p>\n
        Send Transactional Message<\/strong><\/p>\n
        \n
        \n
        \n
        \n
        curl --location -g --request POST\u00a0<\/code>'https:\/\/mc.adobe.io\/<\/a>{{org_id}}\/campaign\/mctangerinedigiapacptrsd\/EVTsampleTransactionalEmail'<\/code>\u00a0\\<\/code> --header\u00a0<\/code>'X-Api-Key: {{api_key}}'<\/code>\u00a0\\<\/code> \r\n--header\u00a0<\/code>'Authorization; Bearer {{access_token}}'<\/code>\u00a0\\<\/code> \r\n--header\u00a0<\/code>'Content-Type: application\/json'<\/code>\u00a0\\<\/code> \r\n--data-raw '{<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>\"email\"<\/code>:\u00a0<\/code>\"test-u6vse5z1s@srv1.mail-tester.com\"<\/code>,<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>\"ctx\"<\/code>: {<\/code> \r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>\"hasInsurance\"<\/code>:\u00a0<\/code>false<\/code>,<\/code> \r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>\"dob\"<\/code>:\u00a0<\/code>\"string127\"<\/code>,<\/code> \r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>\"lname\"<\/code>:\u00a0<\/code>\"Vashistha\"<\/code>,<\/code> \r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<\/code>\"fname\"<\/code>:\u00a0<\/code>\"Pulkit\"<\/code> \r\n\u00a0\u00a0\u00a0\u00a0<\/code>}<\/code> \r\n}'<\/code><\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
        5. Integration of Newsletter Subscription:<\/h3>\n
        Making Use of Adobe I\/O we have integrated following Logic for Campaign Standard with the Subscribe to Newsletter Campaign on our AEM application\u00a0:<\/p>\n
        \"\"<\/p>\n
        In the above component, on the home page User enters the mail id and hits subscribe.
        \nNow on the application layer, we are making use of the following business logic to subscribe users to the Newsletter :<\/p>\n
          \n
        1. User authentication via JWT to fetch auth token.<\/a><\/li>\n
        2. Checking if user exists on Campaign Standard user db<\/a>\u00a0(Search on linked page=>\u00a0Sample request to filter profiles on the basis of email)<\/li>\n
        3. If not, then create\u00a0<\/a>and\u00a0fetch\u00a0<\/a>profile.<\/li>\n
        4. If it exists, then store the profile.<\/li>\n
        5. Send a transactional message<\/a>\u00a0to the mail id.<\/li>\n
        6. Use the profile to fetch the subscription URL for the profile from the json => profilejson[0].subscriptions.href<\/li>\n
        7. Now use the subscription URL for the User and Pkey for the subscription service in Campaign Standard to subscribe user to Service<\/a>\u00a0(use Method 1).<\/li>\n<\/ol>\n
          Conclusion:
          \n<\/b><\/p>\n
          In conclusion, this article has described how to integrate Adobe Campaign APIs with AEM. The integration allows you to send transactional messages and subscribe users to newsletter campaigns on Campaign Standard. The code examples provided in the article can be used as a starting point for your own integration projects. The integration of Adobe Campaign and AEM provides several benefits, including improved email deliverability, increased engagement, and automated workflows.<\/p>\n
          Specifically, Adobe Campaign can help you:<\/p>\n