Syftet med detta projekt är att automatisera sändningar av statestikskdata kopplat till sidor som representerar innehåll kopplat till SDG.
Konfiguration av tjänsten sker genom 'Azure Configurations settings'.
{
"SDG_API_KEY": "...",
"USE_SDG_ACCEPTENCE": true or false,
"GTM_xxx": "{data...}",
"COSMOSDB_CONNECTIONSTRING": "... CosmosDB connectionstring ..."
}För att tillåta flera olika källor kommer systemet "förhöra" konfigurationen om vilka inställningar som finns.
Idag finns stöd för google analytics
För att konfigurera en källa ifrån google analytics skapar man en inställning som börjar på 'GTM_' och sedan valfritt namn, exempel GTM_kovse.
Datan som ska finnas i denna konfigurationsvariabel ska vara i följande format:
{
"site":"Site name",
"rawQuery":"https://www.googleapis.com/analytics/v3/data/ga?ids=ga%3Axxxxxxxx&start-date=yesterday&end-date=yesterday&metrics=ga%3AuniquePa..."
}Utöver konfigurationen ovan måste även en json fil för inloggning emot google analytics finnas i projektet. Denna genereras ifrån google analytics och måste vara av typen 'service_account'. I källkoden nämns denna filen med namnet googleSdgKey.json men den finns inte med i repot.
En sammanställning av de funktioner som finns
Används för att kunna se den information som ska skickas till SDG APIet baserat på de konfigurationer som finns. Används för att debugga och gör det möjligt att se hur olika google frågor kommer se ut som konverterade till SDG format.
Används för att testa skicka data till till SDG APIet på ett sätt som inte loggas eller kräver något annat än vanliga http triggers.
En Azure Function med en 'timerTrigger' som körs i ett intervall en gång per dygn och skickar data till SDG apierna. Denna funktion loggar även det lyckade eller misslyckade resultatet av operationen i en Azure CosmosDB databas. Jobbet är inställt för att köras kl 3 på natten.
Konfigurationen för CosmosDB återfinns i function.json för denna funktionen.
Dokumentation av CosmosDB bindings
{
"name": "sdgDeliveryLogItem",
"type": "cosmosDB",
"databaseName": "SdgDeliveryLog",
"collectionName": "Statistics",
"connectionStringSetting": "COSMOSDB_CONNECTIONSTRING",
"direction": "out"
}