Communitygithub.com

cameronalexander720/overseas-ad-attribution-link-skill

Une compétence d'agent pour concevoir et résoudre les problèmes liés aux liens d'attribution publicitaire à l'étranger, aux liens profonds, aux pages de destination, au timing des SDK, aux rappels PushAPI, aux flux de référence d'installation, au mappage des paramètres publicitaires et aux problèmes de routage post-installation.

Qu'est-ce que overseas-ad-attribution-link-skill ?

Cette compétence d'agent spécialisée permet aux développeurs et aux équipes produit de concevoir et diagnostiquer des systèmes complexes de liens d'attribution publicitaire pour les marchés internationaux, en couvrant l'ensemble du cycle de vie : clic publicitaire, page de destination, installation, première ouverture, rappels SDK, attribution pré et post, routage post-installation et rapports d'événements. Elle s'applique aux agents AI comme Claude Code, Cursor ou Codex, et fonctionne selon deux modes principaux : un mode de conception de solution (pour créer des architectures techniques intégrant des liens profonds, des pages de destination, l'attribution SDK, PushAPI, Google Install Referrer) et un mode Q&A (pour diagnostiquer des comportements inattendus, des défauts de paramètres, des problèmes de timing ou des incohérences de reporting). La compétence s'appuie sur des documents de référence structurés (template de solution technique, base de connaissances d'attribution, playbook Q&A) et impose des garde-fous stricts : distinction entre attribution complète et routage réussi, entre attribution pré et post, traitement correct de Google Install Referrer (uniquement pour la première installation), priorisation explicite des sources de données, et anonymisation des informations sensibles (noms de société, projets, campagnes, dates, tokens). Elle guide l'utilisateur à travers des workflows pas à pas, de la clarification du scénario à la validation par des cas de test, tout en évitant de divulguer des données confidentielles dans les recommandations générées.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence de Lien d'Attribution Publicitaire à l'Étranger

Mode de Fonctionnement

Utilisez cette compétence pour deux types de sorties :

  1. Conception de solution technique pour les capacités de lien d'attribution publicitaire à l'étranger.
  2. Q&A et dépannage pour l'attribution, les paramètres, le timing des SDK, PushAPI, les pages de destination, les liens profonds, les rappels d'événements, les contrôles de rapport et le comportement de routage post-installation.

Identifiez d'abord le mode. Utilisez le mode de conception de solution lorsque l'utilisateur demande une solution technique, un plan d'intégration, une revue produit/technique, une conception de fonctionnalité ou une architecture. Utilisez le mode Q&A lorsque l'utilisateur demande pourquoi une chaîne se comporte d'une certaine manière, comment juger une source, d'où vient un paramètre, comment fonctionne une étape de lien, ou comment résoudre un problème de métrique ou de comportement.

Chargement de Référence Requis

Chargez uniquement les références nécessaires à la demande :

  • Pour une solution technique ou une architecture fonctionnelle : lisez references/technical-solution-template.md.
  • Pour les règles d'attribution, la priorité des sources de données, le timing des interfaces, le mappage des paramètres ou les rappels d'événements : lisez references/attribution-knowledge.md.
  • Pour les questions d'utilisation, le diagnostic ou l'explication : lisez references/qa-playbook.md.

Ne chargez pas et ne citez pas de documents source spécifiques au client, sauf si l'utilisateur les fournit explicitement pour la tâche en cours.

Workflow de Conception de Solution

Lors de la rédaction d'une solution de lien d'attribution publicitaire à l'étranger :

  1. Clarifiez le scénario : lien profond, page de destination, attribution SDK, PushAPI, Google Install Referrer ou chaîne mixte.
  2. Identifiez l'objectif métier : achèvement de l'attribution, remontée de la hiérarchie publicitaire, rappel d'événement, routage post-installation vers du contenu promu, signal d'apprentissage du modèle, contrôle de rapport ou réconciliation de métriques.
  3. Définissez les acteurs et les modules : plateforme média, générateur de lien publicitaire, script intelligent de page de destination, application client, SDK/MMP, service d'attribution backend, service de rapport, configuration d'administration et entrepôt de données.
  4. Spécifiez les sources de données et leur priorité. Documentez le timing, la fiabilité, la clé de correspondance, le comportement de repli et l'utilisation autorisée de chaque source.
  5. Spécifiez le timing côté client : démarrage à froid, première ouverture après installation, consentement de confidentialité, timing du rappel SDK, délai d'expiration de repli, sondage court, démarrage à chaud et limites au niveau de la session.
  6. Spécifiez le comportement backend : correspondance, déduplication, mappage de propagation, remontée de la hiérarchie publicitaire, éligibilité des événements et routage des rappels.
  7. Spécifiez le comportement côté utilisateur : routage automatique, invite de routage, suppression du routage lorsque l'utilisateur consomme déjà du contenu, ou retard jusqu'à l'arrivée du résultat d'attribution.
  8. Spécifiez la validation : cas par source/canal, exemples de paramètres, journaux attendus, rappels d'événements, vérifications de métriques, déploiement progressif et interrupteurs de retour arrière.

Utilisez references/technical-solution-template.md comme structure. Supprimez les sections non pertinentes pour une demande spécifique.

Workflow Q&A

Lorsque vous répondez à des questions d'utilisation :

  1. Reformulez le symptôme observé ou le point de décision.
  2. Nommez l'étape de chaîne pertinente : clic publicitaire, page de destination, installation, première ouverture, rappel SDK, pré-attribution, post-attribution, demande d'info publicitaire, rappel d'événement ou réconciliation d'analyse.
  3. Mappez-la aux règles connues dans references/attribution-knowledge.md.
  4. Expliquez la cause probable avec la priorité des sources et le timing, en particulier lorsque PushAPI, Google Install Referrer ou les données SDK arrivent tardivement.
  5. Donnez une liste de vérification : journaux, champs, timing des requêtes, état de l'utilisateur, champs de propagation/hiérarchie publicitaire, éligibilité des événements et interrupteur de rapport.
  6. Séparez les faits confirmés des hypothèses. Si le projet actuel a ses propres règles, demandez à l'utilisateur la règle ou l'extrait de document pertinent avant d'ignorer le modèle générique.

Garde-fous de Domaine

  • Distinguez l'achèvement de l'attribution du succès du routage/lecture post-installation ; un utilisateur peut être attribué sans être routé vers du contenu promu.
  • Distinguez la pré-attribution et la post-attribution. La pré-attribution affecte le comportement immédiat de l'application ; la post-attribution peut terminer l'attribution plus tard mais peut nécessiter un sondage ou une compensation de routage.
  • Traitez Google Install Referrer comme orienté vers la première ouverture après installation. Ne supposez pas qu'il se met à jour pour chaque nouveau clic publicitaire après l'installation.
  • Préférez les règles explicites de priorité des sources au principe « le dernier champ gagne », sauf si l'utilisateur énonce une règle spécifique au projet.
  • Lorsque vous discutez d'un rappel d'événement, séparez le mappage des événements média, les règles d'éligibilité, la déduplication et les interrupteurs de rapport.
  • Lorsqu'un problème de métrique apparaît, inspectez à la fois le timing de l'attribution et l'expérience de l'application avant de conclure que la logique d'attribution est erronée.

Garde-fous de Contexte Sensible

  • N'incluez pas de noms d'entreprise, de noms de projet, de noms de documents, de dates historiques, de noms de personnes, de chemins de fichiers locaux, de jetons, d'URL, de noms de paquets, de noms de campagne ou d'exemples de journaux bruts dans les conseils réutilisables générés.
  • Les noms de plateformes/publications publiques tels que Facebook, TikTok, Snapchat et Google peuvent être conservés lorsqu'ils sont pertinents pour la conception de la solution ou le dépannage.
  • Les noms d'entreprise internes, les noms de projet, les titres de documents, les noms de campagne, les noms de paquets et les identifiants de compte bruts doivent être supprimés ou généralisés.
  • Utilisez des catégories génériques telles que « SDK média », « SDK MMP », « canal de réseau social », « réseau publicitaire », « journal de page de destination » ou « API de source d'installation » lorsque la source est interne, spécifique au client ou non nécessaire à la réponse.
  • Utilisez une terminologie relative comme « demande initiale », « délai d'expiration de repli » et « fenêtre de sondage court » ; évitez les dates historiques, sauf si l'utilisateur fournit des dates pour le livrable en cours.

Skills associés