So verfolgen Sie die Einnahmen aus Apple Search Ads mit RevenueCat

RevenueCat weiß, was mit einem Abonnement passiert ist. Apple Ads weiß, wohin die Ausgaben für die bezahlte Suche geflossen sind. Das Schlüsselwort ROAS wird erst angezeigt, nachdem Sie diese Datensätze mit derselben Installation verknüpft haben.

Für AppSprint besteht diese Verbindung aus drei Teilen:

1. Apple AdServices-Attribution, erfasst vom SDK.
2. Apple Ads-Berichtsdaten für Ausgaben, Klicks, Impressionen, Kampagnen, Anzeigengruppen und Schlüsselwörter.
3. RevenueCat-Webhooks, die über das Abonnentenattribut „appsprintId“ abgeglichen wurden.

Wenn Sie einen Teil verpassen, zeigt das Dashboard möglicherweise Installationen ohne Umsatz, Umsatz ohne Keyword oder Ausgaben ohne entsprechende Abonnementkohorte an.

Was RevenueCat zu Apple Ads hinzufügt

Apple Ads kann Auslieferungs- und Akquisitionskennzahlen melden. RevenueCat verfolgt den Kunden nach der Installation weiterhin.

Zu den nützlichen RevenueCat-Events gehören:

• Ein Erstkauf für einen Testzeitraum.
• Ein normaler Erstkauf.
• Testkonvertierung und -verlängerung.
• Stornierung oder Ablauf.
• Abrechnungsprobleme und Produktänderungen.
• Käufe ohne Verlängerung.
• Änderungen im Lebenszyklus im Zusammenhang mit Rückerstattungen.

Diese Ereignisse sind wichtig, da der Wert eines Apple Ads-Keywords selten mit dem Download endet.

RevenueCat ist nicht das System, das entscheidet, welche Anzeige die Installation verursacht hat. In der Dokumentation wird es als Abonnementplattform beschrieben, die Attributionsfelder speichern und Ereignisse mit Attributionsanbietern austauschen kann. Die Akquisitionsquelle muss weiterhin von Apple AdServices, einem MMP oder Ihrem eigenen Attributions-Backend stammen.

Wenn Sie entscheiden, ob RevenueCat allein ausreicht, lesen Sie Postbacks Leitfaden zur RevenueCat-Attribution im Vergleich zu einem MMP.

Schritt 1: Erfassen Sie die Apple Ads-Installation

Installieren und konfigurieren Sie das AppSprint SDK, bevor Sie Produktionskampagnendatenverkehr senden.

Bei unterstützten iOS-Versionen fordert das SDK das Apple AdServices-Attributionstoken an und sendet es an AppSprint. Die Antwort von Apple kann die Kampagne, die Anzeigengruppe, das Schlüsselwort, das Land, den Conversion-Typ und den Anspruchstyp identifizieren, sofern diese Felder verfügbar sind.

Search Match-Installationen enthalten möglicherweise keine Schlüsselwort-ID. Behalten Sie diese Conversions in einem separaten Search Match-Bucket, anstatt sie in ein benanntes Schlüsselwort zu zwingen.

Konfigurieren Sie die Attribution beim Start und überprüfen Sie das Ergebnis, bevor Sie sich auf die Keyword-Berichterstellung verlassen. Fehlende Attribution kann Ursachen außerhalb des SDK haben: RevenueCat-Dokumente , dass AdServices ab September 2026 zurückkehrt attribution: false für Installationen aus Anzeigengruppen mit Alters- oder Geschlechts-Targeting.

Der aktuelle Apple Search Ads-Integrationsleitfaden deckt SDK-Unterstützung und Fehlerbehebung ab.

Schritt 2: Apple Ads-Berichte verbinden

Attribution identifiziert die kostenpflichtige Installation. Die Apple Ads API-Verbindung fügt die für den ROAS erforderlichen Medienkosten- und Lieferdaten hinzu.

In AppSprint:

1. Öffnen Sie Apple Ads in der AppSprint Mac-App.
2. Verwenden Sie ein separates Apple-Konto mit der Rolle „API Account Manager“ in Apple Ads.
3. Generieren Sie ein Schlüsselpaar in AppSprint und fügen Sie den öffentlichen Schlüssel in die Apple Ads API-Einstellungen ein.
4. Kopieren Sie die resultierende Client-ID, Team-ID und Schlüssel-ID in AppSprint und stellen Sie dann eine Verbindung her.
5. Wählen Sie die App aus und öffnen Sie sie SDK und Umsatzverfolgung für die Installation und das Abonnement-Setup.

Der private Schlüssel verbleibt auf Ihrem Mac. Folgen Sie dem Apple Ads-Verbindungsanleitung für das genaue Konto und die wichtigsten Schritte.

Diese Verbindung liefert Ausgaben, Impressionen, Klicks und von Apple gemeldete Installationen. Stabile Apple-IDs aus dem Attributionsdatensatz können dann mit aktuellen Kampagnen-, Anzeigengruppen- und Keyword-Namen angereichert werden.

Schritt 3: Fügen Sie den RevenueCat-Webhook hinzu

Erstellen Sie einen Webhook in RevenueCat unter den Projektintegrationen.

Verwenden Sie die von AppSprint angezeigte app-spezifische URL:

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

Öffnen Sie die Mac-App Apple Ads > SDK & Umsatzverfolgung > RevenueCat für die ausgewählte App. Kopieren Sie die Webhook-URL und fügen Sie die angezeigte ein rc_... Fügen Sie das Token genau wie gezeigt in das Authorization-Header-Feld von RevenueCat ein, ohne etwas hinzuzufügen Bearer . Halten Sie dieses Token privat. Der Empfänger akzeptiert das Roh-Token; das entspricht dem AppSprint RevenueCat-Setup.

RevenueCat kann Produktionskäufe, Sandbox-Käufe oder beides senden. AppSprint kann eine Sandbox-Bereitstellung verwenden, um zu überprüfen, ob der Endpunkt und die Authentifizierung funktionieren, es fügt jedoch keine Sandbox-Transaktionen zur Produktionsattributionsberichterstattung hinzu.

Die RevenueCat-Integrationsleitfaden erklärt den Aufbau. Ihre app-spezifische URL und Ihr Token werden in der Mac-App angezeigt.

Schritt 4: appsprintId in RevenueCat speichern

Der Webhook benötigt eine gemeinsame Identität.

Nachdem das AppSprint SDK konfiguriert ist, lesen Sie die Installations-ID und speichern Sie sie in RevenueCat als Abonnentenattribut mit dem Namen „appsprintId“.

Auf die Reihenfolge kommt es an:

1. AppSprint konfigurieren.
2. Rufen Sie die AppSprint-Installations-ID ab.
3. Legen Sie das RevenueCat-Abonnentenattribut fest.
4. Lassen Sie den Kunden über die Paywall und den Kaufvorgang weitermachen.

Wenn RevenueCat später einen Test-, Kauf- oder Erneuerungs-Webhook sendet, ermöglicht dieses Attribut AppSprint, die ursprüngliche Installation und ihre Apple Ads-Zuordnung zu finden.

Füllen Sie das Attribut nicht mit einem Platzhalter, während Sie auf den tatsächlichen Wert warten. Speichern Sie die stabile Installations-ID, sobald sie vorhanden ist.

Wenn RevenueCat bereits konfiguriert ist, lautet der Identitätsteil der Swift-Einrichtungsaufforderung der Mac-App:

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

Verwenden Sie die von Ihrer ausgewählten App generierte Setup-Eingabeaufforderung für die vollständigen Installations- und Initialisierungsschritte. In diesem Beispiel wird der Join-Schlüssel erläutert. es ist kein Beweis dafür, dass ein Kauf zugeschrieben wurde.

Schritt 5: Validieren Sie den Pfad in Ebenen

Warten Sie nicht auf eine große Kampagne, um ein fehlendes Identitätsfeld zu entdecken.

Bestätigen Sie die Installation

Öffnen Sie die App auf einem neuen Testgerät und bestätigen Sie, dass eine neue AppSprint-Installation angezeigt wird. Überprüfen Sie bei einem kostenpflichtigen Produktionstest, ob die Apple-Kampagne oder die Search Match-Attribution vorhanden ist.

Bestätigen Sie das Abonnentenattribut

Öffnen Sie das RevenueCat-Kundenprofil und prüfen Sie, ob appsprintId mit dem erwarteten Wert vorhanden ist.

Bestätigen Sie den Webhook

Senden Sie einen RevenueCat-Test oder eine Sandbox-Zustellung, um die URL und den Autorisierungsheader zu überprüfen. Überprüfen Sie dann den AppSprint-Integrationsstatus.

Bestätigen Sie die Produktionszuordnung

Führen Sie, wenn möglich, einen kontrollierten Produktionseinkauf durch. Überprüfen Sie die vollständige Kette:

Apple Ads-Installation -> AppSprint-Installation -> RevenueCat-Abonnent -> Produktions-Webhook -> zugeschriebener Umsatz

Dieser letzte Schritt ist derjenige, der beweist, dass der Keyword-ROAS funktionieren kann. Ein grüner Webhook-Status allein beweist nur, dass AppSprint die Anfrage empfangen kann.

Lesen Sie die RevenueCat-Ereigniszuordnung

AppSprint ordnet die wichtigsten RevenueCat-Lebenszyklusereignisse einem kleineren Attributionsereignissatz zu.

Halten Sie das rohe Lebenszyklusereignis zur Untersuchung verfügbar. Eine Kündigung bedeutet nicht dasselbe wie ein Ablauf, und ein Abrechnungsproblem ist nicht gleichbedeutend mit einer freiwilligen Abwanderungsentscheidung.

RevenueCat-Webhooks umfassen auch Transaktions- und Abonnentenkontext, sofern verfügbar, wie Produkt, Geschäft, Preis, Währung, Kaufzeit, Ablaufzeit, Aliase und Abonnentenattribute.

Erstellen Sie einen Keyword-Bericht, der die Testreife berücksichtigt

Der erste Bericht sollte klein bleiben:

Halten Sie aktive Testversionen aus dem Nenner zwischen ausgereifter Testversion und bezahlter Testversion heraus. Eine gestern erworbene siebentägige Testversion ist nicht gescheitert.

Die Abonnement-Kohorten-ROAS-Leitfaden zeigt, wie man Kohorten im gleichen Alter vergleicht.

Diagnostizieren Sie nicht übereinstimmende Nummern

RevenueCat, Apple Ads und AppSprint zeigen nicht immer die gleichen Gesamtwerte an.

Überprüfen Sie diese Ursachen, bevor Sie davon ausgehen, dass die Integration unterbrochen ist:

Verschiedene Daten

Apple kann Medienaktivitäten nach Anzeigeninteraktion oder Berichtsdatum melden. RevenueCat-Ereignisse treffen zu Kauf- und Lebenszyklusdaten ein. Bei der Kohortenberichterstattung werden spätere Einnahmen der Akquisitionsgruppe gutgeschrieben.

Verschiedene Währungen

Apple-Ausgaben- und RevenueCat-Transaktionswerte können unterschiedliche Währungen oder Umrechnungsmethoden verwenden. Normalisieren Sie, bevor Sie den ROAS auf Kontoebene berechnen.

Search Match hat kein Schlüsselwort

Apple kann eine Installation Search Match ohne eine Schlüsselwort-ID zuordnen. Möglicherweise sind die Kampagne und die Anzeigengruppe noch bekannt.

Die Installation wurde nie zugeordnet

Eine organische oder nicht abgeglichene Installation kann dennoch ein RevenueCat-Abonnent werden. Der Umsatz ist real, gehört aber nicht zu einem Apple-Keyword.

appsprintId fehlt

Der Webhook erreicht AppSprint, aber das Ereignis kann seine Installation nicht finden. Bestätigen Sie, dass das Attribut für den genauen RevenueCat-Kunden vorhanden ist, der den Kauf getätigt hat.

Das Ereignis ist eine Sandbox

Sandbox-Transaktionen überprüfen die Installation. Sie gehen nicht in die Produktionsattributionsberichte von AppSprint ein.

Die Kohorte ist noch aktiv

Ein Apple-Dashboard kann eine abgeschlossene Installation anzeigen, während die RevenueCat-Testversion ihre Zahlungsentscheidung noch nicht erreicht hat.

Wandeln Sie den Bericht in Keyword-Entscheidungen um

Nutzen Sie den gesamten Trichter, bevor Sie Gebote ändern.

Die Keyword-ROAS-Playbook deckt die Gebots- und Kampagnenstruktur ab, sobald die Messung vertrauenswürdig ist.

Historische Daten haben ein festes Limit

Ein neuer Webhook kann aktuelle Abonnementereignisse für einen bestehenden Kunden bereitstellen, aber er kann keine Apple Ads-Quelle rekonstruieren, die bei der Installation nie erfasst wurde.

Markieren Sie das Datum, an dem alle drei Komponenten live gingen:

• Apple-Attributionserfassung.
• appsprintId in RevenueCat.
• Authentifizierte Produktions-Webhooks.

Behandeln Sie Kohorten, die nach diesem Datum erfasst wurden, als saubere Messperiode. Behalten Sie ältere Einnahmen für Unternehmenssummen bei, ohne vorzutäuschen, dass die Keyword-Zuordnung vollständig ist.

Was als nächstes zu tun ist

Verbinden Sie die Apple Ads API, fügen Sie den RevenueCat-Webhook hinzu und bestätigen Sie appsprintId auf einem Testabonnenten. Führen Sie dann einen kontrollierten Produktionspfad durch, bevor Sie den Bericht für eine Angebotsentscheidung verwenden.

Verbinden Sie RevenueCat mit AppSprint , um Testversionen, Abonnements, Verlängerungen und Einnahmen mit der Apple Ads-Installation und dem Keyword zu verknüpfen, das sie generiert hat.

Quellen

• RevenueCat-Webhook-Ereignistypen und -Felder – Aktuelle Abonnementlebenszyklusereignisse, Transaktionsfelder und Abonnentenidentität
• RevenueCat-Webhooks – Aktuelles Autorisierungs-, Produktions-, Sandbox- und Testverhalten
• RevenueCat-Kundenattribute – Aktuelles Abonnentenattributverhalten und reservierte Attributionsfelder
• Apple AdServices – Apples Installationsattributions-Framework
• AppSprint Apple Search Ads-Integration – Aktuelles SDK- und Reporting-API-Setup
• AppSprint RevenueCat-Integration – Aktuelle AppsprintId, Webhook und Ereigniszuordnung