informatie
Beschrijving

[Eenheid] 1. consentmanager SDK-integratie

In dit document vindt u algemene informatie over hoe u onze SDK in uw project kunt integreren. Voor meer details verwijzen wij u naar onze API-referentie documentatie.

1. Installatie

consentmanager SDK is een uitgebreide oplossing voor het beheren van gebruikerstoestemming in mobiele applicaties. Deze SDK is ontworpen om GDPR-naleving, gebruikersprivacyvoorkeuren en transparantie bij het volgen van advertenties te verwerken en biedt een naadloze integratie voor iOS- en Android-platforms. Daarnaast biedt het wrapper-plugins/bruggen voor React Native, Flutter en Unity, waardoor het veelzijdig is in verschillende ontwikkelomgevingen.

Stappen - Beschrijving op hoog niveau

  1. Integratie en configuratie:

    • Integreer de SDK in uw app.
    • Configureer de SDK-instellingen volgens uw behoeften.
  2. Een instantie maken en de toestemmingslaag weergeven:

    • Maak bij het opstarten van de app een exemplaar van het CMPManager klas. Deze instantie zal het toestemmingsproces afhandelen.
    • De SDK geeft indien nodig automatisch het toestemmingsscherm weer.
  3. Verwerking van toestemmingsgegevens van gebruikers:

    • Zodra toestemmingen zijn verzameld, wordt informatie opgeslagen en is deze beschikbaar voor query's via verschillende eigenschappen en methoden die door onze SDK worden blootgesteld. U krijgt informatie over afgewezen of geaccepteerde toestemmingen, leveranciers en doeleinden.

Wat betreft compatibiliteit hebben we:

  • Eenheid 20XX.XX of later
  • iOS (via DllImport)
  • Android (via JNI)

1. Het SDK-pakket importeren

In slechts twee stappen hebt u alles ingesteld.

    • Download de nieuwste uitgave Van de plugin.
    • Importeer het pakket in uw Unity-project met behulp van Activa > Pakket importeren > Aangepast pakket.

JSON configureren

In CmpSdkConfig.json kunt u de native SDK-versie voor iOS en Android instellen die voor het bouwproces zal worden gebruikt: 

Vind de compatibele native SDK-versies hier

{
  "displayName": "Consentmanager SDK",
  "name": "CmpSdk",
  "androidBasePath": "net.consentmanager.sdk",
  "version": "3.0.0",
  "androidLibraryVersion": "x.xx.x",
  "iosLibraryVersion": "x.xx.x",
  "description": "Unity plugin helps you to use native Consentmanager functionality on Android and iOS."
}

Build-instellingen

Ga naar om de build-instellingen te wijzigen Window -> CmpSdk 

pluginwindow-unity.png

iOS Build-instellingen

  • Schakel iOS-buildscript in: Schakel dit in of uit om het buildscript dat verantwoordelijk is voor de integratie van de iOS SDK in het Unity-project in of uit te schakelen.
  • xcFramework-pad: Geef het pad op naar de xcFramework-map. Dit pad kan direct worden bewerkt of er kan naar worden gebladerd via de bijbehorende knop.
  • Versietag opnemen: Indien ingeschakeld, wordt de iOS SDK-versie toegevoegd aan het xcFramework-pad, waardoor versiespecifieke configuraties mogelijk zijn.
  • Resulterend raamwerkpad: Geeft het volledig opgeloste pad naar het xcFramework weer, inclusief de SDK-versie als de versietag is opgenomen.
  • Transparantie van app-tracking inschakelen: Schakel dit in om de App Tracking Transparency-functie voor iOS in te schakelen, wat nodig is voor toestemming van de gebruiker onder de privacyrichtlijnen van iOS.
  • Toestemmingsbericht voor transparantie van app-tracking: Een tekstveld waarin u het aangepaste bericht kunt invoeren dat aan gebruikers wordt weergegeven wanneer toestemming voor tracking wordt gevraagd. Deze boodschap moet duidelijk en beknopt zijn en uitleggen waarom de toestemming nodig is.

Android Build-instellingen

  • Android-buildscript inschakelen: Schakel tussen het in- of uitschakelen van het buildscript voor het integreren van de Android SDK in het Unity-project. 
  • Integreer aangepaste lay-out: Indien ingeschakeld, is het gebruik van een aangepaste lay-out voor de toestemmingslaag voor het fragment UIView mogelijk.

    Als u een aangepaste lay-out met fragmenten wilt gebruiken, zorg er dan voor dat uw Unity-project de volgende inhoud toevoegt: appcompat afhankelijkheid. Voeg een aangepaste hoofdsjabloon toe: 
    Activa/Plug-ins/Android/mainTemplate.gradle
    en voeg de afhankelijkheid toe:
    implementatie 'androidx.appcompat:appcompat:1.xx'

2. De SDK gebruiken

Bekijk het onderstaande voorbeeld om een ​​illustratie te zien van het gebruik van onze SDK. Voor meer informatie, zie de volledige API-referentie.

Houd er rekening mee dat de functionaliteiten die betrekking hebben op het bepalen of toestemming nodig is of niet, evenals de weergave van de toestemmingslaag, afhankelijk zijn van een betrouwbare netwerkverbinding. Als er geen verbinding beschikbaar is of als het mechanisme van opnieuw proberen onze server niet bereikt, retourneert de gebeurtenis didReceiveError een time-outfout en kan de SDK de noodzaak van toestemming dus helemaal niet bepalen, omdat de toestemmingslaag helemaal niet kan worden weergegeven. Zorg ervoor dat uw logica hiermee rekening houdt.

Voorbeeldscript

    private static void CheckConsentWithServer(){     
    	CmpManager.Instance.CheckWithServerAndOpenIfNecessary();}
    }  
        
    private static void SetCmpUrlConfig() {
      	const string id = "id";           
      	const string domain = "domain";           
      	const string language = "en";           
      	const string appName = "AppName";           
      
      	CmpManager.Instance.SetUrlConfig(id, domain, language, appName);       
    }         
    
    private void OpenConsentLayer() {            
      	CmpManager.Instance.OpenConsentLayer();        
    }        
    
    private void JumpToSettings() {            
      	CmpManager.Instance.JumpToSettings();        
    }        
    
    private void HasVendorConsent(string vendorId) {            
      	var hasConsent = CmpManager.Instance.HasVendorConsent(vendorId);            
      	Debug.Log($"Has vendor consent: {hasConsent}");        
    }        
    
    private void HasPurposeConsent(string purposeId) {            
      	var hasConsent = CmpManager.Instance.HasPurposeConsent(purposeId);            
      	Debug.Log($"Has purpose consent: {hasConsent}");        
    }

    Logging

    Wanneer u onze iOS SDK gebruikt, kan het nodig zijn om loginformatie te debuggen of analyseren voor verschillende doeleinden. De logs die door onze SDK worden gegenereerd, zijn getagd onder "CMP", zodat u eenvoudig de relevante logs kunt filteren en bekijken. Raadpleeg voor meer informatie deze sectie van onze documentatie.

     

    Terug naar boven