Configuration of interstitials

interstitials are advertising pages that are integrated into purple issues via the purple importer they are placed within an issue and contain images and can also contain urls that link to websites and work in purple apps and purple websites the configuration of an interstitial is done within the purple experience and can be done by updating the dynamic resources and the purple manager or by making the changes in the purple experience builder this article only explains the integration and usage of purple interstitials with images preconditions the interstitials feature needs to be enabled in the purple backend this is done by purple support if a connection to a google ad server is required, this will need to be arranged by our support helpdesk team please let us know if you need an ad server configured to request the enablement of the feature or the connection to an ad server, please open a support ticket here website of the purple support helpdesk in the german language https //support sprylab com/de/support/home website of the purple support helpdesk in the english language https //support sprylab com/en/support/home the interstitial will be shown on a specific, pre defined page within the issue please let purple know which page you would like the ad to appear on for this article, we will use page 6 as an example adjust the import csv file open the import csv file for the account you want to change on your computer and add the following column at the end of the csv file ads add the term ' p6' for each issue(row) which should have an advertisement slot (as mentioned in the preconditions section of this article, this page can be defined during setup) in this example, we want to place the interstitial on p age 6, which is determined by ' p6 ' so the term ' page ' is shortened to ' p ' and put together with the page number if you want to put it on p age 2 you would need to add ' p2 '; for p age 13 'p13' and so on this page number needs to be exactly the same as the parameter in the config properties file which is setup by the purple support team the final result should look like this in the editor config properties file if you later check your configuration in the preview of the config properties file it should look like this config properties file in preview mode overview of adding/changing ads editing the gad config js file configuration of interstitials publishing date link to advertiser images of your ad editing the gad config js the images for your advertisements will be stored within the dynamic content of the app place the images for your ad campaign in the 'ads' folder and the configuration for the display, images and correct linking of the interstitial in the gad config js file within the same folder all changes must be uploaded with the dynamic content to the purple manager or the purple experience builder to function in your preview or live app let’s take a look at what an entry for a campaign looks like open the gad config js in your in the purple experience builder or in the downloaded dynamic content with a text editor like visual studio code, brackets, notepad++ etc the opened file should look like this gad config js the complete entry for one ad within an issue is this snippet of code gad config js configuration of interstitials publishing date in the gad config js within the experience builder, the publishing date needs to be configured in the following format yyyy mm dd to publish the advertisement on the correct day please be aware of the distinction between summer and winter time as this affects the publication date if you publish during summer time (cest) the publishing date needs to be one day earlier summertime starts on the last sunday of march and ends on the last sunday in october example you want an ad to be published on the 21st of may, then the entered publishing date needs to be one day earlier 2024 05 20 if you publish in winter time , please use the same date example you want an ad to be published on the 17th of november, then the entered publishing date needs to be the same day 2024 11 17 gad config js link to advertiser you can link your ad to e g the website of the advertiser this will generate a touch area within the issue and by tapping it, the in app browser will open the page if you want your ad to be linked to a specific url, add it to the gad config js like in the example below url "https //www mysampledomain com", gad config js images for your ad requirements for images to ensure your ad is displayed optimally, please provide images in the following format file format webp (to ensure small file size) deliver two versions of every image, that you want to insert into the ad portrait format 1532x2048 pixel landscape format 2048x1532 pixel naming of the images name the file and when adding the name into the gad config js, write it in exactly the same way (case sensitive) the portrait image name needs to be placed in the line starting with ' imgp ' the landscape image name needs to be placed in the line starting with ' imgl ' naming the ad images based on a given date may help to keep the gad config js file easier to read, especially when working with multiple interstitials from/for the same advertiser mapping of the images in the gad config js add both images to the add folder alongside the gad config js map both images with the interstitial by adding them like in the example below as imgp "myportraitimage p jpg”, imgl "myportraitimage l jpg" please note that the filename is case sensitive and must be written exactly the same in the gad config js as the file is named gad config js please keep in mind, that interstitial campaigns cannot be tested for dates in the future, as most advertising services will display their content on the day of the campaign