Skill für Übersee-Werbe-Attributionslinks
Betriebsmodus
Verwenden Sie diesen Skill für zwei Ausgabetypen:
- Technische Lösungskonzeption für Fähigkeiten von Übersee-Werbe-Attributionslinks.
- Q&A und Fehlerbehebung für Attribution, Parameter, SDK-Timing, PushAPI, Landing Pages, Deep Links, Event-Callbacks, Reporting-Steuerungen und Post-Install-Routing-Verhalten.
Identifizieren Sie zuerst den Modus. Verwenden Sie den Lösungskonzeptions-Modus, wenn der Benutzer nach einer technischen Lösung, einem Integrationsplan, einer Produkt-/Technikprüfung, einem Feature-Design oder einer Architektur fragt. Verwenden Sie den Q&A-Modus, wenn der Benutzer fragt, warum sich eine Kette auf eine bestimmte Weise verhält, wie eine Quelle beurteilt wird, woher ein Parameter stammt, wie eine Link-Stufe funktioniert oder wie eine Metrik oder ein Verhaltenssymptom behoben wird.
Erforderliches Referenzladen
Laden Sie nur die für die Anfrage benötigten Referenzen:
- Für technische Lösung oder funktionale Architektur: Lesen Sie
references/technical-solution-template.md. - Für Attributionsregeln, Datenquellenpriorität, Schnittstellentiming, Parametermapping oder Event-Callbacks: Lesen Sie
references/attribution-knowledge.md. - Für Nutzungsfragen, Diagnose oder Erklärung: Lesen Sie
references/qa-playbook.md.
Laden oder zitieren Sie keine kundenspezifischen Quelldokumente, es sei denn, der Benutzer stellt sie explizit für die aktuelle Aufgabe bereit.
Workflow zur Lösungskonzeption
Beim Entwerfen einer Lösung für einen Übersee-Werbe-Attributionslink:
- Klären Sie das Szenario: Deep Link, Landing Page, SDK-Attribution, PushAPI, Google Install Referrer oder gemischte Kette.
- Identifizieren Sie das Geschäftsziel: Attributionsabschluss, Ad-Hierarchy-Backfill, Event-Callback, Post-Install-Routing zu beworbenen Inhalten, Modell-Lernsignal, Reporting-Steuerung oder Metrikabgleich.
- Definieren Sie Aktoren und Module: Medienplattform, Ad-Link-Generator, Landing-Page-Smart-Script, App-Client, SDK/MMP, Backend-Attributionsdienst, Reporting-Dienst, Admin-Konfiguration und Data Warehouse.
- Geben Sie Datenquellen und deren Priorität an. Dokumentieren Sie für jede Quelle das Timing, die Zuverlässigkeit, den Matching-Key, das Fallback-Verhalten und die erlaubte Verwendung.
- Geben Sie das Client-Timing an: Kaltstart, erster App-Start nach Installation, Datenschutzeinwilligung, SDK-Callback-Timing, Fallback-Timeout, kurzes Polling, Warmstart und Session-Level-Grenzen.
- Geben Sie das Backend-Verhalten an: Matching, Deduplizierung, Spread-Mapping, Ad-Hierarchy-Backfill, Event-Berechtigung und Callback-Routing.
- Geben Sie das benutzerseitige Verhalten an: automatisches Routing, Routing-Aufforderung, Routing-Unterdrückung, wenn der Benutzer bereits Inhalte konsumiert, oder Verzögerung bis zum Eintreffen des Attributionsergebnisses.
- Geben Sie die Validierung an: Fälle nach Quelle/Kanal, Parameterbeispiele, erwartete Logs, Event-Callbacks, Metrikprüfungen, Gray-Release und Rollback-Schalter.
Verwenden Sie references/technical-solution-template.md als Struktur. Entfernen Sie Abschnitte, die für eine enge Anfrage irrelevant sind.
Q&A-Workflow
Bei der Beantwortung von Nutzungsfragen:
- Wiederholen Sie das beobachtete Symptom oder den Entscheidungspunkt.
- Nennen Sie die relevante Kettenstufe: Ad-Click, Landing Page, Installation, erster App-Start, SDK-Callback, Pre-Attribution, Post-Attribution, Ad-Info-Anfrage, Event-Callback oder Analyse-Abgleich.
- Ordnen Sie es bekannten Regeln in
references/attribution-knowledge.mdzu. - Erklären Sie die wahrscheinliche Ursache mit Quellenpriorität und Timing, insbesondere wenn PushAPI, Google Install Referrer oder SDK-Daten spät eintreffen.
- Geben Sie eine Überprüfungs-Checkliste: Logs, Felder, Anfrage-Timing, Benutzerstatus, Spread/Ad-Hierarchy-Felder, Event-Berechtigung und Reporting-Schalter.
- Trennen Sie bestätigte Fakten von Annahmen. Wenn das aktuelle Projekt eigene Regeln hat, fragen Sie den Benutzer nach der relevanten Regel oder dem Dokumentauszug, bevor Sie das generische Muster überschreiben.
Domain-Schutzmaßnahmen
- Unterscheiden Sie Attributionsabschluss vom Post-Install-Routing/Wiedergabeerfolg; ein Benutzer kann attribuiert, aber nicht zu beworbenen Inhalten geroutet werden.
- Unterscheiden Sie Pre-Attribution und Post-Attribution. Pre-Attribution beeinflusst das unmittelbare App-Verhalten; Post-Attribution kann die Attribution später abschließen, erfordert aber möglicherweise Polling oder Routing-Kompensation.
- Behandeln Sie Google Install Referrer als orientiert am ersten App-Start nach Installation. Gehen Sie nicht davon aus, dass es sich bei jedem neuen Ad-Click nach der Installation aktualisiert.
- Bevorzugen Sie explizite Quellenprioritätsregeln gegenüber „letztes Feld gewinnt“, es sei denn, der Benutzer gibt eine projektspezifische Regel an.
- Trennen Sie bei Event-Callbacks das Medien-Event-Mapping, die Berechtigungsregeln, die Deduplizierung und die Reporting-Schalter.
- Wenn ein Metrikproblem auftritt, überprüfen Sie sowohl das Attributions-Timing als auch das App-Erlebnis, bevor Sie schlussfolgern, dass die Attributionslogik falsch ist.
Schutzmaßnahmen für sensible Kontexte
- Fügen Sie keine Firmennamen, Projektnamen, Dokumentnamen, historischen Daten, Personennamen, lokalen Dateipfade, Token, URLs, Paketnamen, Kampagnennamen oder rohen Logbeispiele in generierte wiederverwendbare Anleitungen ein.
- Öffentliche Medien-/Plattformnamen wie Facebook, TikTok, Snapchat und Google können beibehalten werden, wenn sie für die Lösungskonzeption oder Fehlerbehebung relevant sind.
- Interne Firmennamen, Projektnamen, Dokumenttitel, Kampagnennamen, Paketnamen und rohe Kontoidentifikatoren müssen entfernt oder verallgemeinert werden.
- Verwenden Sie allgemeine Kategorien wie „Medien-SDK“, „MMP-SDK“, „Social-Media-Kanal“, „Werbenetzwerk“, „Landing-Page-Log“ oder „Install-Source-API“, wenn die Quelle intern, kundenspezifisch oder für die Antwort nicht erforderlich ist.
- Verwenden Sie relative Zeitangaben wie „Erstanfrage“, „Fallback-Timeout“ und „kurzes Polling-Fenster“; vermeiden Sie historische Daten, es sei denn, der Benutzer liefert Daten für das aktuelle Arbeitsergebnis.