Communitygithub.com

cameronalexander720/overseas-ad-attribution-link-skill

Ein Agenten-Skill zur Konzeption und Fehlerbehebung von Übersee-Werbe-Attributionslinks, Deep Links, Landing Pages, SDK-Timing, PushAPI-Callbacks, Install-Referrer-Flows, Ad-Parameter-Mapping und Post-Install-Routing-Problemen.

Was ist overseas-ad-attribution-link-skill?

Dieser Skill befähigt KI-Agenten, Werbe-Attributionslinks für Übersee-Kampagnen zu entwerfen und zu debuggen. Er deckt zwei Hauptmodi ab: technische Lösungsdesigns (wie Integration von Deep Links, Landing Pages, SDKs und PushAPI) sowie Q&A und Fehlerbehebung (z.B. warum ein Attributions-Event nicht feuert, wie Parameter gemappt werden oder wie das Post-Install-Routing funktioniert). Der Skill lädt je nach Anfrage gezielt Referenzdokumente (technische Lösungsvorlage, Attributionswissen, Q&A-Playbook) und folgt einem strukturierten Workflow, der Szenarien, Geschäftsziele, beteiligte Akteure, Datenquellen und deren Prioritäten, Client-Timing und Backend-Verhalten spezifiert. Domain-Guardrails stellen sicher, dass Attributionsabschluss von Post-Install-Routing getrennt wird, Google Install Referrer korrekt behandelt wird und keine sensiblen internen Daten (Projektnamen, URLs, Token) in generierten Leitfäden erscheinen. Der Skill ist für Plattformen wie Claude Code, Cursor und Codex optimiert und hilft Entwicklern, valide, fehlertolerante Attributionsketten aufzubauen und zu analysieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add cameronalexander720/overseas-ad-attribution-link-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Skill für Übersee-Werbe-Attributionslinks

Betriebsmodus

Verwenden Sie diesen Skill für zwei Ausgabetypen:

  1. Technische Lösungskonzeption für Fähigkeiten von Übersee-Werbe-Attributionslinks.
  2. 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:

  1. Klären Sie das Szenario: Deep Link, Landing Page, SDK-Attribution, PushAPI, Google Install Referrer oder gemischte Kette.
  2. Identifizieren Sie das Geschäftsziel: Attributionsabschluss, Ad-Hierarchy-Backfill, Event-Callback, Post-Install-Routing zu beworbenen Inhalten, Modell-Lernsignal, Reporting-Steuerung oder Metrikabgleich.
  3. 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.
  4. 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.
  5. 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.
  6. Geben Sie das Backend-Verhalten an: Matching, Deduplizierung, Spread-Mapping, Ad-Hierarchy-Backfill, Event-Berechtigung und Callback-Routing.
  7. 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.
  8. 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:

  1. Wiederholen Sie das beobachtete Symptom oder den Entscheidungspunkt.
  2. 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.
  3. Ordnen Sie es bekannten Regeln in references/attribution-knowledge.md zu.
  4. Erklären Sie die wahrscheinliche Ursache mit Quellenpriorität und Timing, insbesondere wenn PushAPI, Google Install Referrer oder SDK-Daten spät eintreffen.
  5. Geben Sie eine Überprüfungs-Checkliste: Logs, Felder, Anfrage-Timing, Benutzerstatus, Spread/Ad-Hierarchy-Felder, Event-Berechtigung und Reporting-Schalter.
  6. 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.

Verwandte Skills