DokumentationExperience PlatformTutorial für Mobile Apps

Implementieren der Zustimmung

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Entwickler

Erfahren Sie, wie Sie die Zustimmung in eine Mobile App implementieren.

Die mobile Adobe Experience Platform-Erweiterung "Einverständnis"ermöglicht die Erfassung von Zustimmungsvoreinstellungen von Ihrer mobilen App bei Verwendung des Adobe Experience Platform Mobile SDK und der Edge Network-Erweiterung. Weitere Informationen zur Erweiterung Einverständnis finden Sie in der Dokumentation.

Voraussetzungen

  • App erfolgreich erstellt und ausgeführt, wobei SDKs installiert und konfiguriert sind.

Lernziele

In dieser Lektion werden Sie:

  • Fordern Sie den Benutzer zur Zustimmung auf.
  • Aktualisieren Sie die Erweiterung basierend auf der Benutzerantwort.
  • Erfahren Sie, wie Sie den aktuellen Status der Zustimmung erhalten.

Einverständnisersuchen

Wenn Sie das Tutorial von Anfang an befolgt haben, können Sie sich daran erinnern, dass Sie die standardmäßige Zustimmung in der Erweiterung "Einverständnis"auf Ausstehend - Queue-Ereignisse festgelegt haben, die auftreten, bevor der Benutzer Zustimmungsvoreinstellungen bereitstellt.

Um mit der Datenerfassung zu beginnen, müssen Sie die Zustimmung des Benutzers einholen. In einer realen App möchten Sie die Best Practices für die Zustimmung für Ihre Region konsultieren. In diesem Tutorial erhalten Sie das Einverständnis des Benutzers, indem Sie ihn einfach mit einem Warnhinweis anfordern:

  1. Sie möchten den Benutzer nur einmal um Zustimmung bitten. Dazu können Sie die Mobile SDK-Zustimmung mit der erforderlichen Autorisierung für das Tracking mit dem App Tracking Transparency Framework von Apple kombinieren. In dieser App gehen Sie davon aus, dass Benutzer, wenn sie die Verfolgung zulassen, der Erfassung von Ereignissen zustimmen.

  2. Navigieren Sie im Xcode Project-Navigator zu Luma > Luma > Utils > MobileSDK .

    Fügen Sie diesen Code zur Funktion updateConsent hinzu.

    code language-swift 
    // Update consent
let collectConsent = ["collect": ["val": value]]
let currentConsents = ["consents": collectConsent]
Consent.update(with: currentConsents)
MobileCore.updateConfigurationWith(configDict: currentConsents)

  3. Navigieren Sie im Projektnavigator von Xcode zu Luma > Luma > Views > General > DisclaimerView. Dies ist die Ansicht, die angezeigt wird, nachdem Sie die Anwendung installiert oder neu installiert und die App zum ersten Mal gestartet haben. Der Benutzer wird aufgefordert, das Tracking gemäß dem App Tracking Transparency Framework von Apple zu genehmigen. Wenn der Benutzer autorisiert, aktualisieren Sie auch die Zustimmung.

    Fügen Sie den folgenden Code zum ATTrackingManager.requestTrackingAuthorization { status in -Schließen hinzu.

    code language-swift 
    // Add consent based on authorization
if status == .authorized {
   // Set consent to yes
   MobileSDK.shared.updateConsent(value: "y")
}
else {
   // Set consent to yes
   MobileSDK.shared.updateConsent(value: "n")
}

Aktuellen Zustimmungsstatus abrufen

Die mobile Erweiterung "Einverständnis"unterdrückt/sticht/ermöglicht das Tracking basierend auf dem aktuellen Zustimmungswert automatisch. Sie können auch selbst auf den aktuellen Zustimmungsstatus zugreifen:

  1. Navigieren Sie im Projektnavigator von Xcode zu Luma > Luma > Utils > MobileSDK .

    Fügen Sie der Funktion getConsents den folgenden Code hinzu:

    code language-swift 
    // Get consents
Consent.getConsents { consents, error in
   guard error == nil, let consents = consents else { return }
   guard let jsonData = try? JSONSerialization.data(withJSONObject: consents, options: .prettyPrinted) else { return }
   guard let jsonStr = String(data: jsonData, encoding: .utf8) else { return }
   Logger.aepMobileSDK.info("Consent getConsents: \(jsonStr)")
}

  2. Navigieren Sie im Projektnavigator von Xcode zu Luma > Luma > Views > General > HomeView .

    Fügen Sie dem Modifikator .task den folgenden Code hinzu:

    code language-swift 
    // Ask status of consents
MobileSDK.shared.getConsents()

Im obigen Beispiel protokollieren Sie einfach den Zustimmungsstatus in Xcode in der Konsole. In einem realen Szenario können Sie damit ändern, welche Menüs oder Optionen dem Benutzer angezeigt werden.

Mit Assurance validieren

  1. Löschen Sie die Anwendung von Ihrem Gerät oder Simulator, um das Tracking und die Zustimmung ordnungsgemäß zurückzusetzen und zu initialisieren.
  2. Um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden, lesen Sie den Abschnitt Einrichtungsanweisungen .
  3. Wenn Sie in der App vom Bildschirm Startseite auf den Bildschirm Produkte und wieder auf den Bildschirm Startseite wechseln, sollte in der Assurance-Benutzeroberfläche ein Ereignis vom Typ Antwort auf Zustimmungen abrufen angezeigt werden.
    validate consent
SUCCESS
Sie haben Ihre App jetzt aktiviert, um den Benutzer beim ersten Start nach der Installation (oder Neuinstallation) aufzufordern, die Verwendung des Adobe Experience Platform Mobile SDK zu genehmigen.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeine Rückmeldungen oder Anregungen zu künftigen Inhalten teilen möchten, teilen Sie diese auf diesem Experience League Community-Diskussionbeitrag mit.

Weiter: Lebenszyklusdaten erfassen

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b