Identity Management

Allgemeines

 

Die diversen Adtech Integrationen der Ad Alliance bieten die Möglichkeit, für die Vermarktung nutzbare IDs an den Tech & Data Stack und ausgewählte Vendoren zu übergeben. Je nach verwendeter Technologie, sind die Schnittstellen dabei unterschiedlich definiert:

 

Normalisierung und Hashing der eMail

 

Für Normalisierung/Hashing gibt es zwei Wege:

 

  • Der Publisher übergibt die unbearbeitete eMail Adresse direkt an das MoltenBundle und wählt dafür den type 'raw'. In der Folge wird die eMail Adresse auf dem Client normalisiert, gehashed und dann erst in die weitere serverseitige Verarbeitungskette gegeben
  • Der Publisher übernimmt Normalisierung und Hashing nach der folgenden Dokumentation und wählt den type 'hem'.

Für die Normalisierung gelten marktweite Vorgaben, damit die von Publisher A generierte HEM zu der von Publisher B und Werbekunde C passt:

 

  • Leerzeichen müssen entfernt werden, sowohl führende als auch anhängende
  • Die eMail Adresse muss in lowercase umgewandelt werden (JaneDoe@example.com -> janedoe@example.com)
  • Nur bei g(oogle)mail.com Adressen:
    • Punkte müssen gelöscht werden (jane.doe@gmail.com -> janedoe@gmail.com)
    • + Zeichen mit zusätzlichem String vor dem @ müssen gelöscht werden (janedoe+home@gmail.com -> janedoe@gmail.com)

Die so normalisierte eMail Adresse muss mit SHA-256 (ohne Salt) gehashed werden. 

 

Web-Integration über das MoltenBundle

 

Im MoltenBundle werden IDs über die Methode setIdentity übergeben. Diese nimmt sowohl die ID, als auch den ID-Type entgegen. 

 

Derzeit definierte und erlaubte idtypes sind:

 

  • hem (bei von Publishern normalisierten und gehashten eMail Adressen)
  • raw (bei eMail Adressen, für die die Ad Alliance Normalisierung und Hashing übernehmen soll)
  • netid (für die etpid, nicht die tpid [plain text netid])
  • utiq (für den Adtechpass)

1

2

3

4

5

6

7

<script type="text/javascript">  

        if(MoltenBundle !== undefined && MoltenBundle.cmd !== undefined) {  

            MoltenBundle.cmd.push(function() {  

                MoltenBundle.Identity.setIdentity(string: id, string: idtype);

            });  

        }  

</script> 

 

Um im Falle eines Optouts diese sensiblen IDs sowohl im Tech & Data Stack der AdA, als auch bei Vendoren löschen zu lassen, muss einmalig die Methode clearIdentity aufgerufen werden:

 

1

2

3

4

5

6

7

<script type="text/javascript">  

        if(MoltenBundle !== undefined && MoltenBundle.cmd !== undefined) {  

            MoltenBundle.cmd.push(function() {  

                MoltenBundle.Identity.clearIdentity(string: id, string: idtype);

            });  

        }  

</script> 

Ab diesem Moment darf die setIdentity Methode erst wieder aufgerufen werden, wenn der User wieder/einen erneuten Optin gegeben hat.