So verfolgen Sie die Einnahmen aus Apple Search Ads mit Superwall

Superwall kann Ihnen sagen, was rund um die Paywall und das Abonnement passiert ist. Apple Ads kann Ihnen sagen, welche Kampagne und welcher Suchkontext zu einer kostenpflichtigen Installation geführt hat.

Um den Keyword-ROAS zu berechnen, verbinden Sie beide Systeme mit derselben AppSprint-Installation:

Apple Ads-Klick -> Zugeordnete Installation -> Superwall-Benutzer -> Testversion oder Kauf -> Umsatz

Die Apple-Seite bietet Beschaffung und Ausgaben. Superwall stellt den Paywall- und Abonnementkontext bereit. AppSprint bewahrt die Identität zwischen ihnen.

Was Superwall beiträgt

Superwall eignet sich für zwei verwandte Ansichten.

Innerhalb von Superwall können Sie Platzierungen, Paywall-Interaktionen, Angebote, Benutzer und Abonnementverhalten überprüfen. Über Webhooks meldet Superwall den Kauflebenszyklus, einschließlich:

• Erstkäufe im Testzeitraum.
• Normale Erstkäufe.
• Verlängerungen und Probeumbauten.
• Stornierungen und Stornierungen.
• Ablauf- und Abrechnungsprobleme.
• Produktänderungen.
• Käufe ohne Verlängerung.
• Rückerstattungswerte, sofern vorhanden.

Das aktuelle Superwall-Webhook-Mapping von AppSprint konzentriert sich auf den Abonnementlebenszyklus. Nutzen Sie das Superwall-Dashboard für eine tiefergehende Untersuchung der Paywall-Interaktion und nutzen Sie dann AppSprint, um zugeordnete Abonnementergebnisse mit Apple Ads zu verknüpfen.

Schritt 1: Erfassen Sie die Apple Ads-Installation

Konfigurieren Sie das AppSprint SDK, bevor die Kampagne startet.

Unter iOS 14.3 oder höher erfasst das SDK das Apple AdServices-Attributionstoken. AppSprint tauscht es gegen den verfügbaren Kampagnen-, Anzeigengruppen-, Keyword-, Land-, Conversion- und Anspruchskontext aus.

Attribution beim Start konfigurieren. Wenn eine kostenpflichtige Installation nicht übereinstimmt, überprüfen Sie das Targeting und die Implementierung: RevenueCat-Dokumente eine AdServices-Beschränkung vom September 2026 für Anzeigengruppen, die Alters- oder Geschlechts-Targeting verwenden.

Search Match-Conversions haben möglicherweise keine Keyword-ID. Behalten Sie Search Match als eigene Quelle bei, anstatt die fehlende ID als Implementierungsfehler zu behandeln.

Die Apple Search Ads-Integrationsleitfaden verfügt über die aktuellen SDK-Anforderungen.

Schritt 2: Apple Ads-Berichte verbinden

Der Attributionsdatensatz identifiziert die bezahlte Quelle. Die Berichts-API fügt die Kosten- und Liefermetriken hinzu.

Verbinden Sie in der AppSprint-Mac-App ein Apple-Konto mit der Rolle „API Account Manager“. Generieren Sie das Schlüsselpaar in AppSprint, fügen Sie seinen öffentlichen Schlüssel in den Apple Ads API-Einstellungen hinzu und kopieren Sie die Client-ID, Team-ID und Schlüssel-ID zurück in AppSprint. Folgen Sie dem Apple Ads-Verbindungsanleitung, wählen Sie dann Ihre App aus und öffnen Sie sie SDK und Umsatzverfolgung.

Nach der Validierung kann AppSprint Folgendes importieren:

• Ausgeben.
• Impressionen.
• Wasserhähne.
• Von Apple gemeldete Installationen.
• Kampagnen- und Anzeigengruppendetails.
• Schlüsselwortnamen, sofern verfügbar.

Ohne Ausgaben können Sie den zugeordneten Umsatz zählen, aber den ROAS nicht berechnen.

Schritt 3: Fügen Sie den signierten Superwall-Webhook hinzu

Erstellen Sie in Superwall einen Webhook mit dem in AppSprint angezeigten app-spezifischen Endpunkt:

https://api.appsprint.app/v1/integrations/superwall/webhooks/your-app-id

Superwall unterzeichnet Webhook-Lieferungen über Svix. Kopieren Sie das Signaturgeheimnis des Webhooks in die AppSprint Superwall-Integration.

AppSprint überprüft die Signaturheader, bevor die Nutzlast akzeptiert wird. Es besteht keine Notwendigkeit, in Superwall einen benutzerdefinierten gemeinsamen Header zu erfinden.

Der aktuelle Superwall-Integrationshandbuch zeigt, wo sich der Endpunkt und das Signaturgeheimnisfeld befinden.

Schritt 4: appsprintId auf dem Superwall-Benutzer speichern

Der Webhook muss die ursprüngliche Installation identifizieren.

Nachdem AppSprint das SDK konfiguriert hat, rufen Sie die AppSprint-Installations-ID ab und legen Sie sie als Superwall-Benutzerattribut mit dem Namen „appsprintId“ fest.

Verwenden Sie diese Reihenfolge:

1. AppSprint konfigurieren.
2. Lesen Sie die AppSprint-Installations-ID.
3. Legen Sie appsprintId über die Benutzerattribut-API von Superwall fest.
4. Weiter zu Platzierungen, Paywalls und Käufen.

Superwall schließt Benutzerattribute in Webhook-Nutzlasten ein. Wenn das Lebenszyklusereignis eintrifft, liest AppSprint appsprintId und hängt das Ereignis an die entsprechende Installation an.

Wenn Superwall bereits konfiguriert ist, lautet der Identitätsteil der Swift-Setup-Eingabeaufforderung der Mac-App:

await AppSprintAppleAds.configure(apiKey: "YOUR_APPSPRINT_SDK_KEY")
if let appsprintId = AppSprintAppleAds.getAppSprintId() {
    Superwall.shared.setUserAttributes(["appsprintId": appsprintId])
}

Verwenden Sie die generierte Eingabeaufforderung der ausgewählten App für die vollständige SDK-Einrichtung. Überprüfen Sie das tatsächliche Benutzerattribut, bevor Sie einen Kauf testen.

Ein signierter Webhook ohne appsprintId kann weiterhin akzeptiert werden. Es kann einfach nicht mit der Apple Ads-Quelle verknüpft werden.

Schritt 5: Verstehen Sie die Ereigniszuordnung

AppSprint ordnet die wichtigsten Superwall-Ereignisse einem konsistenten Attributionsmodell zu.

Die Webhook-Nutzlast von Superwall umfasst Transaktions- und Lebenszyklusfelder wie Produkt, Geschäft, Zeitraumtyp, Preis, Erlös, gekaufte Währung, ursprüngliche Transaktions-ID und Benutzerattribute, sofern verfügbar.

Behalten Sie den rohen Lebenszykluskontext bei. Ein Benutzer kann die automatische Verlängerung abbrechen, während der aktuelle bezahlte Zeitraum aktiv bleibt. Stornierung und Ablauf sollten nicht als derselbe Zeitpunkt betrachtet werden.

Schritt 6: Validieren, ohne Sandbox und Produktion zu verwechseln

Testen Sie den Fluss in Schichten.

Überprüfen Sie den Webhook

Speichern Sie zuerst die whsec_... Signaturgeheimnis in AppSprint und fahren Sie mit der SDK-Einrichtung fort. Warten Sie nicht auf eine Testschaltfläche: Der aktuelle AppSprint-Leitfaden erfordert keinen manuellen Superwall-Dashboard-Test-Webhook. Wenn ein Sandbox-Kauf ein Ereignis liefert, bestätigen Sie, dass die unterzeichnete Lieferung akzeptiert wird.

Überprüfen Sie die Benutzeridentität

Öffnen Sie den Superwall-Benutzerdatensatz und bestätigen Sie, dass „appsprintId“ den von AppSprint für diese Installation erstellten Wert enthält.

Überprüfen Sie die Apple-Namensnennung

Überprüfen Sie bei einer kontrollierten kostenpflichtigen Produktionsinstallation, ob AppSprint die Apple-Kampagne, die Anzeigengruppe, die Keyword- oder Search-Match-Quelle und das Land anzeigt.

Überprüfen Sie den Produktionsumsatz

Schließen Sie, wenn möglich, ein Abonnement für kontrollierte Produktion ab. Bestätigen Sie, dass der Lebenszyklus-Webhook ein zugeschriebenes Ereignis erstellt und der Umsatz in der erwarteten Apple Ads-Kohorte erscheint.

AppSprint fügt Superwall-Sandbox-Lieferungen nicht zur Produktionsattributionsberichterstattung hinzu. Ein erfolgreicher Sandbox-Webhook beweist die signierte Verbindung, nicht den endgültigen ROAS.

Erstellen Sie den Keyword-Trichter

Beginnen Sie mit einem Bericht, der dem Entscheidungspfad des Benutzers folgt.

AppSprint benötigt nicht jede Superwall-Interaktion im Apple Ads-Bericht. Verwenden Sie ausreichend Produktkontext, um die Einschränkung zu lokalisieren, und verwenden Sie dann die Benutzer- und Paywall-Ansichten von Superwall für die detaillierte Untersuchung.

Respektieren Sie die Testreife

Ein Probestart ist ein frühes Signal. Es handelt sich nicht um Einnahmen.

Separat:

• Aktive Testversionen, die noch laufen.
• Ausgereifte Studien, die ihre bezahlte Entscheidung getroffen haben.
• Kostenpflichtige Abonnements.
• Erstattete oder stornierte Ergebnisse.
• Erneuerungserlöse.

Vergleichen Sie Keyword-Kohorten im gleichen Alter. Eine Kampagne, die vor drei Tagen gestartet wurde, sollte nicht schlechter eingestuft werden als eine Kampagne mit einem vollständigen Erneuerungszyklus, nur weil der Umsatz noch nicht eintrifft.

Verwenden Sie die Abonnement-Kohorten-ROAS-Workflow zur Definition aktiver, reifer und umsatzreifer Kohorten.

Diagnostizieren Sie den Trichter, bevor Sie Gebote ändern

Taps ohne Installation

Die Anzeige hat Interesse geweckt, aber die Store-Seite hat den Download nicht abgeschlossen. Überprüfen Sie die ersten Screenshots, Untertitel, Bewertung und Übereinstimmung zwischen der Suche und der Auflistung.

Installation ohne Paywall-Reichweite

Verwenden Sie die Platzierungs- und User-Journey-Daten von Superwall, um zu sehen, ob das Onboarding zu lange dauert oder die entsprechende Platzierung nie ausgelöst wird.

Paywall-Reichweite ohne Testversionen

Das Angebot entspricht möglicherweise nicht dem Suchversprechen. Vergleichen Sie den Paywall-Text, die Produkte, die Testversion und den Preis mit der Absicht des Keywords.

Testversionen ohne bezahlte Konvertierungen

Sehen Sie sich die Testqualität, den Zeitpunkt der Kündigung, die Produktnutzung und das Versprechen vor der Installation an.

Bezahlte Benutzer ohne akzeptablen ROAS

Das Schlüsselwort kann konvertieren, kostet aber zu viel. Überprüfen Sie vor der Skalierung das Gebot, den Preis, den Erlös, das Rückerstattungsverhalten und den Verlängerungswert.

Superwall- und Apple-Gesamtsummen abgleichen

Einige Unterschiede sind zu erwarten.

Apple Ads und Superwall können unterschiedliche Daten verwenden. Apple meldet die Anzeigeninteraktion und -installation; Superwall berichtet über den Kauflebenszyklus. Spätere Einnahmen sollten der Akquisitionskohorte zur Amortisationsanalyse gutgeschrieben werden.

Währungen können ebenfalls abweichen. Superwall stellt USD-Preis- und Erlösfelder neben gekauften Währungsdaten zur Verfügung. Wählen Sie eine Umsatzdefinition aus und normalisieren Sie sie, bevor Sie den ROAS auf Kontoebene berechnen.

Organic-Abonnenten bleiben ohne Apple-Keyword ein echter Umsatz. Zwingen Sie nicht übereinstimmende Benutzer nicht zu bezahlten Kampagnen, um eine Übereinstimmung der Gesamtsummen zu erzielen.

Verwenden Sie den verbundenen Bericht

Das Ergebnis sollte Ihnen bei der Entscheidung helfen, wo die Einschränkung liegt.

Die Keyword-ROAS-Playbook deckt die Kampagnenentscheidungen ab, nachdem die Messung stabil ist.

Was als nächstes zu tun ist

Verbinden Sie die Apple Ads API, erstellen Sie den signierten Superwall-Webhook und bestätigen Sie appsprintId für einen Benutzer. Anschließend validieren Sie einen Produktionskauf von der zugeordneten Installation zum Umsatz, bevor Sie ein Keyword-Gebot ändern.

Verbinden Sie Superwall mit AppSprint zum Anhängen von Test-, Kauf-, Erneuerungs- und Lebenszyklusereignissen an die Apple Ads-Quelle, die den Benutzer erstellt hat.

Quellen

• Superwall-Webhooks – Aktuelle Ereignisnamen, Transaktionsfelder, Rückerstattungsverhalten, Geschäfte und Benutzerattribute
• Superwall-Benutzer – Aktuelle Benutzer-, Paywall-, Abonnement-, Platzierungs- und Ereignisansichten
• Apple AdServices – Apples Installationsattributions-Framework
• AppSprint Apple Search Ads-Integration – Aktuelle SDK-Attribution und Apple-Berichtseinrichtung
• AppSprint Superwall-Integration – Aktuelle appsprintId, Svix-Signatur, Sandbox-Verhalten und Ereigniszuordnung