Contents AdsML ympäristö... 2 AdsML Testi ympäristö... 2 AdsML tuotantoympäristö... 2 AdsML käyttöliittymä... 3 Kirjautuminen... 3 Käsiteltävät sanomat... 4 Yhdisteltävät sanomat... 5 Sanoman historia ja tapahtumat... 8 Sanoman lisätiedot... 9 Lisätoiminnot... 10 AdsML ylläpito... 10 AdsML Testi ympäristö... 10 AdsML tuotantoympäristö... 11 Perustoiminnallisuus... 11 Perusmäärittely... 11 AdsML Advertising web service and the database... 11 AdsML Windows palvelu... 11 AdsML Messaging Web palvelu... 12 AdsML kanavat ja niiden määrittely... 12 Kanavan toiminnallisuuden määrittely... 12 Kohdistustietojen määrittely... 13 Kohdistustietojen ylläpito... 14 Sanomien haku vanhan järjestelmän Archive kansiosta... 15
AdsML ympäristö AdsML Testi ympäristö AdsMLMessaging käyttöliittymä: http://atexdev1/adsmlmessaging/login Määrittelyt ovat palvelimella AdsMLService määrittelytiedosto: AdsML Messaging kotiosoite: atexdev1 C:\AdsML\config\AdsML.xml C:\AdsML\AdsMLHome AdsML tuotantoympäristö AdsMLMessaging käyttöliittymä: http://www-adweb.padat.fi/adsmlmessaging/login Määrittelyt ovat palvelimella b2badgr1: AdsMLService määrittelytiedosto: AdsML Messaging kotiosoite: d:\adsml\config\adsml.xml d:\adsml\adsmlhome
AdsML käyttöliittymä Kirjautuminen Kirjautuminen AdBase käyttäjätunnuksella.
Käsiteltävät sanomat Toiminto Kuvaus Tarkenne Luo Luo ilmoitus Ilmoitus luodaan Alustava tilaisena ilmoitusjärjestelmään. Kuittaus lähetetään kun ilmoitus aktivoidaan tai perutaan. Hylkää Hylkää sanoma Lähetetään negatiivinen kuittaus lisäviestin kanssa. Kiinnitä Kiinnitä olemassa olevaan ilmoitukseen Etukäteen tehty ilmoitus voidaan kiinnittää AD-O sanomaan. 6232360 Sanoman lisätiedot Linkki sanoman lisätietoihin Valitse asiakas Kohdista asiakas Jos asiakasta ei voida kohdistaa nimellä tai LY-tunnuksella tai palautuu useampi kuin yksi vaihtoehto käytettäväksi Sanoma 6232701 näkyy odottaa tilaisena kunnes ilmoitus joko aktivoidaan tai perutaan.
Yhdisteltävät sanomat Yhdistele Vertaa Yhdistä muutostiedot Vertaa muutostietoja aktiiviseen tietoon Jos löytyy AD-OX sanoma, yhdistellään AD-O ja AD-OX sanoma. Muussa tapauksessa yhdistellään sanoma, jolla on korkein versionumero AD-O sanomaan.
Muutosten käsittely Toiminto Kuvaus Tarkenne Päivitä Päivitä yhdistelyn tulos Ilmoitus päivitetään Alustava tilaisena ilmoitusjärjestelmään. Kuittaus lähetetään kun ilmoitus aktivoidaan tai perutaan. Ohita Ohitetaan muutos. Muutoksen tehdään AdBase työkaluilla. Kuittaus lähetetään kun ilmoitus aktivoidaan tai perutaan. 6232360 Sanoman lisätiedot Linkki sanoman lisätietoihin Valitse asiakas Kohdista asiakas Jos asiakasta ei voida kohdistaa nimellä tai LY-tunnuksella tai palautuu useampi kuin yksi vaihtoehto käytettäväksi
Kuittausten seuranta Sanomasta 000300 lähtee kuittaus heti kun ilmoitus joko perutaan tai aktivoidaan. Kuittaus lähettämättä luku voi olla suurempi kuin listalla olevien sanomien lukumäärä. AD-O Sanomalla voi olla useita kuittaamattomia AD-OC tai AD-OX sanomia.
Sanoman historia ja tapahtumat 1) Kyselynimen perusteella (Kyselytyypit määritelty perustiedoissa) 2) Julkaisu- tai luontipäivän perusteella 3) Tunnisteen perusteella (Sanoman tunniste tai ilmoitusnumero) 4) Tunniste tyyppi (Sanomatunnus tai Varausnumero) 5) Kanavanimen perusteella 6) Kuiitaamattomat sanomat 7) Ennakkolaskuttamattomat 8) Sanomat joiden hinta poikkeaa
Sanoman lisätiedot Kohdista Pura sanoman lukitus Kohdista uudelleen Pura sanoman lukitus jos jäänyt virhetilanteessa lukituksi
Lisätoiminnot Poista sanoma Testiympäristöön voidaan määritellä toiminto, jolla kaikki sanomaan liittyvät tiedot poistetaan. Hyödyllinen kun testataan esim. erilaisia hinnoitteluvaihtoehtoja. Luo/Päivitä kaikki sanomat Kaikki kyselyssä näkyvät sanomat käsitellään joko Luo tai Päivitä toiminnolla Kohdista kaikki sanomat Käyttöönottovaiheessa voidaan uudelleen kohdistaa kaikki kyselyssä olevat sanomat AdsML ylläpito AdsML Testi ympäristö AdsMLMessaging käyttöliittymä: http://atexdev1/adsmlmessaging/login Määrittelyt ovat palvelimella AdsMLService määrittelytiedosto: AdsML Messaging kotiosoite: AdsML Windows palvelu on palvelimella Web palvelut ovat palvelimella atexdev1 C:\AdsML\config\AdsML.xml C:\AdsML\AdsMLHome atexdev1 atexdev1 Tietokannan nimi on adon
AdsML tuotantoympäristö AdsMLMessaging UI: http://www-adweb.padat.fi/adsmlmessaging/login Määrittelyt ovat palvelimella b2badgr1: AdsMLService määrittelytiedosto: AdsML Messaging kotiosoite: AdsML Windows service on server Web palvelut ovat palvelimella d:\adsml\config\adsml.xml d:\adsml\adsmlhome b2badgr1 b2badweb1 ja b2badweb2 Database schema name base Perustoiminnallisuus Ilmoitus otetaan vastaan AdsML sanomana. Jokainen sanoma kuitataan hyväksymissanomalla. Tulevat sanomat ovat: 1) AD-O sanoma Tilaus 2) AD-OC sanoma Muutos pyyntö 3) AD-OX sanoma Peruutus pyyntö Lähtevät sanomat ovat: 1) AD-OR-T Tekninen kuittaus 2) AD-OR Kuittaus AD-O, AD-OC tai AD-OX sanomaan 3) AD-OS Ennakkolasku AdsML palvelu lukee tulevat sanomat ja lisää ne tietokantaan. Palvelu tutkii sanoman tilaa ja lähettää kuittaussanoman siinä vaiheessa kun sanoma on käsitelty käyttöliittymässä. Tekninen kuittaus lähetettään heti kun sanoma on lisätty tietokantaan. Ennakkolasku lähetetään kun taitosta saatu sijoitteluinformaatio on päivitetty sanomalle. AdsML Advertising web palvelu luo ja hakee sanoman tietoja Oracle tietokannasta. AdsML Message on web palvelu joka tarjoaa käyttöliittymän sanomien käsittelylle. AdsML tukee useita kanavia. Jokaiselle kanavalle voidaan määritellä oma käsittelytapa. Perusmäärittely Perusmäärittely on tiedostossa AdsML.xml file. AdsML Advertising web palvelussa kerrotaan määrittelytiedoston sijainti <add key="xmlfilefolder" value="\\b2badbgr1\adsml\config"/> AdsML Advertising Web palvelu ja tietokanta AdsML sovelluksella voi olla oma tietokanta. Advertising Web palvelussa on määritelty tietokannan tiedot Asennetaan kansioon C:\inetpub\wwwroot\AdsMLAdvertsing AdsML Windows palvelu AdsML Windows palvelu käsittelee tulevat ja lähtevät sanomat
Asennetaan kansioon C:\Program Files\Atex\AdsMLService AdsML Messaging Web palvelu AdsML Messaging web palvelu tarjoaa käyttöliittymän sanomien käsittelyyn Asennetaan kansioon C:\inetpub\wwwroot\AdsMLMessaging AdsML kanavat ja niiden määrittely AdsML.xml tiedosto sisältää määrittelytiedot Archive folder: ConfigAdsML folder: ConfigDagmar folder: ConfigKM folder: ConfigMyyJaOsta folder: ConfigPaginationfeedBack folder: Work: Tulevien ja lähtevien sanomien arkistointi Yleinen määrittelytietoo Määrittelytieto / Dagmar Määrittelytieto / Kärkimedia Määrittelytieto / MyyJaOsta Määrittelytieto / Anygraaf palautustiedosto Työkansio Kansio määrittely tuleville ja lähteville sanomille kanavakohtaisesti. <InputXmlFolder>\\atexdev1\AdsML\AdsMLHome\inputDagmar</InputXmlFolder> <OutputXmlFolder>\\atexdev1\AdsML\AdsMLHome\OutputDagmar</OutputXmlFolder> Kanavan toiminnallisuuden määrittely Kanavalle kerrotaan määrittelykansio seuraavasti <ConfigurationFolder>\\atexdev1\AdsML\AdsMLHome\ConfigAdsML</ConfigurationFolder> Perustoimintojen määrittely on tiedostossa imp_parameters_adsmlorder.xml. Tuetut toiminnallisuudet ovat Print, Preprint ja Internet
Kohdistustietojen määrittely Kanavalle kerrotaan kohdistustieto seuraavasti <MapFileExtension>DG</MapFileExtension> Määrittelyn mukaan kanavan kohdistustieto on tiedostossa imp_parameters_adsmlorder_map_dg.xml Esimerkki uudelleen kohdistuksesta.
Kohdistustietojen ylläpito Tietoja ylläpidetään Excel taulukossa. Muunnos taulukosta tehdään ohjelmalla ConvertMapDataToXMLFile.exe Sarake Kohdistus Moduuli Sijoittelu Moduulitietojen kohdistus Sijoittelutietojen kohdistus Tyyppi Print Internet Preprint Print ilmoitusten kohdistus Digi ilmoitusten kohdistus Preprint ilmoitusten kohdistus AdsML julkaisu KAU Julkaisu AdsML sanomassa AdsML moduuli 1/1_Etusivu Sanoman moduulikoodi ETUSIVU AdsML sijoittelu MP Moduulitietojen kohdistuksessa käytetään oletussijoittelua jos ei ole tehty yksilöivää määrittelyä. AdBase KL_Moduuli AdBase Normaali AdBase 1/1_Etusivu AdBase Julkaisu Kauppalehti AdBase Sijoittelu KL_Tekstissä AdBase Paikka AdBase Leveys 8 AdBase Korkeus 100 Esimerkkejä moduulimäärittelystä. AdsML sanomassa annetaan sekä moduulikoodi ja sijoittelukoodi. AdsML moduuli AdsML sijoittelu Kohdistus 1/1_Etusivu UTS TS UTS Koska moduulikoodille 1/1_Etusivu ei löydy yksilöivää määrittelyä sijoittelulle UTS TS UTS, käytetään oletussijoittelu kohdistusta riviltä 12. ETUSIVU UTS TS UTS Koska moduulikoodille ETUSIVU ei löydy yksilöivää määrittelyä sijoittelulle UTS TS UTS, käytetään oletussijoittelu kohdistusta riviltä 12. ETUSIVU MP Koska moduulikoodille ETUSIVU löytyy yksilöivä määrittely sijoittelulle MP, käytetään sijoittelua riviltä 7. VAAKA8*100 MP Koska moduulikoodille VAAKA8*100 löytyy koko, luodaan milliilmoitus käyttäen annettuja koko määrittelyjä.
Kanavan määrittelyssä on kerottu tunniste kohdistustietoja varten. Tunniste lisätään tiedoston nimeen. <MapFileExtension>DG</MapFileExtension> Sanomien haku vanhan järjestelmän Archive kansiosta Sanomien hakua varten on olemassa ohjelma GetFiles.exe. Input folder: Archive kansio vanhassa järjestelmässä Compare folder: Archive kansio uudessa järjestelmässä Target folder: Kansio keruutulokselle Start date: Julkaisut alkaen 3.2.2014 Get Files Kerää sanomat Get map data Kerää kohdistustieto ModuleData.txt ja PlacementData.txt tiedostoon