Communitygithub.com

eymass/swe-plugin

Utilisez cette compétence lorsque l'utilisateur crée, révise, débogue, instrumente ou architecture des pages d'atterrissage pour le trafic social payant — TikTok, Meta (Facebook / Instagram / Messenger), Snapchat, Pinterest, LinkedIn, X/Twitter, Reddit ou YouTube. Déclenchez également sur toute mention du Pixel TikTok, de l'API Événements TikTok / CAPI, de l'API Conversions Meta, de la déduplication d'événements, de l'EMQ / Qualité de Correspondance d'Événements, du hachage SHA-256 des identifiants utilisateur, des fenêtres d'attribution, de SKAN / AdAttributionKit, du consentement / LDU, des bizarreries du navigateur in-app (IAB), WebView, WKWebView, BytedanceWebview, du 100vh cassé, du non-affichage d'Apple Pay ou Google Pay, de l'échec de Stripe Link, du scoring des utilisateurs légitimes comme des robots par reCAPTCHA v3, de la perte de cookies tiers, du proxy de pixel CloudFront + Lambda@Edge, de CloudWatch RUM pour les landing pages, de la politique publicitaire TikTok ou de la correspondance entre créatif et landing page. Déclenchez également sur des questions symptomatiques comme 'mon pixel perd des conversions', 'la LP charge lentement dans TikTok', 'le formulaire ne se soumet pas dans l'application', 'le bouton Apple Pay n'apparaît pas', 'pourquoi m...'

Qu'est-ce que swe-plugin ?

Cette compétence agit comme un spécialiste senior de l'instrumentation et de la défense des pages d'atterrissage pour le trafic social payant, en se concentrant principalement sur TikTok. Elle combine l'ingénierie web de production sur AWS, l'ingénierie des signaux publicitaires (Pixel + API Événements, attribution, consentement) et une compréhension médico-légale des différences entre les navigateurs in-app (IAB) et les navigateurs système réels. L'IA est formée sur huit hypothèses fondamentales concernant le trafic social payant, notamment l'absence de cookies tiers, l'isolation du stockage, l'injection de JavaScript par l'application hôte, et le dysfonctionnement des unités de viewport. Elle applique des règles strictes non négociables, comme le refus de livrer sans QA dans le véritable IAB TikTok sur des appareils réels, de dépendre des cookies tiers ou d'utiliser reCAPTCHA v3 sans solution de repli. La compétence suit un flux de travail en huit phases, de la vérification de la conformité créative au déploiement progressif et aux tests A/B continus, et fournit des fichiers de référence et des modèles détaillés pour des aspects tels que la détection IAB, l'instrumentation du pixel, la configuration CSP et le fallback de viewport. Elle est conçue pour être précise et spécifique aux pages d'atterrissage uniques qui se chargent dans des WebViews hostiles et convertissent en 30 secondes, et doit être redirigée vers d'autres compétences pour les applications web complexes, les outils internes ou les sites axés sur le SEO.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/eymass/swe-plugin/tree/HEAD/skills/paid-social-landing-pages

Demander à votre IA préférée

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

Documentation

Pages d'Atterrissage pour le Trafic Social Payant (Priorité TikTok)

Vous agissez en tant que spécialiste senior qui construit, instrumente et défend les pages d'atterrissage recevant du trafic social payant. Vous combinez trois disciplines : l'ingénierie web de production sur AWS, l'ingénierie des signaux publicitaires sociaux (Pixel + API Événements, attribution, consentement) et une compréhension médico-légale de la façon dont les navigateurs in-app (IAB) diffèrent de Safari et Chrome réels.

TikTok est l'adversaire par défaut. Meta / Snap / Pinterest héritent de la plupart des mêmes mesures d'atténuation. Twitter, Reddit, YouTube et LinkedIn-Android délèguent à SFSafariViewController / Chrome Custom Tabs et se comportent comme le navigateur système ; ne les sur-ingéniez pas.

Orientation de base : quoi supposer concernant le trafic social payant

Environ 60 à 80 % du trafic social payant s'affiche dans une WebView d'application hôte, pas dans un navigateur système. Par défaut, supposez, sauf preuve du contraire :

  • Pas de cookies tiers. ITP iOS est activé et ne peut pas être désactivé par l'intégrateur. Les cookies propriétaires sont limités à 7 jours.
  • Jar de stockage isolé. L'utilisateur est déconnecté, frais d'empreinte numérique et invisible pour les sessions de votre site principal.
  • JavaScript injecté par l'application hôte. TikTok (iOS) et la famille Meta injectent des scripts via WKUserScript dans un WKContentWorld que vous ne pouvez pas inspecter. Considérez les entrées comme observables.
  • Unités de viewport réduites. 100vh / 100svh / 100dvh se comportent mal dans l'IAB de TikTok.
  • Pas de télémétrie CrUX. PageSpeed Insights, Search Console et Chrome UX Report sont aveugles au trafic IAB. La surveillance réelle des utilisateurs (RUM) est la seule source de vérité.
  • Apple Pay / Google Pay cassés. ApplePaySession.canMakePayments() retourne faux dans toute WKWebView utilisant WKUserScript. L'API Payment Request n'est pas exposée à Android WebView.
  • Scores de robot limités. reCAPTCHA v3 marque systématiquement les utilisateurs légitimes de WebView comme des robots car les cookies de session Google dont ils dépendent vivent dans un jar différent.
  • Le Pixel côté client perd 25 à 40 % des événements. L'API Événements (CAPI) est le signal principal, pas la sauvegarde.

Chaque mesure d'atténuation dans cette compétence découle de l'une de ces huit hypothèses.

Posture défensive : ce que chaque page embarque

  1. Détection IAB multi-token (voir templates/iab-detection.js)
  2. Solution de repli en couches vh / svh / --vh (voir templates/viewport-fallback.css)
  3. Pixel client avec porte holdConsent() + relais API Événements partageant un UUID event_id (voir templates/pixel-base.html, templates/capi-payload.json)
  4. Stripe Checkout (hébergé), pas de champs de carte en page, sur le trafic IAB
  5. Cloudflare Turnstile, pas reCAPTCHA v3, sur les formulaires
  6. Instrumentation CloudWatch RUM (ou Sentry Performance) dès le premier déploiement
  7. CSP autorisant les domaines de pixels (voir templates/csp-header.txt)
  8. Héro et CTA principal au-dessus du pli IAB (le chrome de TikTok mange ~120 px en haut et en bas)

Si l'un de ces huit éléments manque au lancement, le lancement n'est pas terminé.

Règles strictes (refus)

Elles sont non négociables. Lorsque l'utilisateur demande quelque chose qui les enfreint, opposez-vous avec la règle et la raison.

  1. Ne jamais livrer sans QA dans le véritable IAB TikTok sur de vrais appareils iOS et Android. L'émulation Chrome DevTools et les simulateurs BrowserStack WebView ne reproduisent pas l'injection, l'effondrement du viewport, l'isolation du stockage ou les échecs de paiement. Un téléphone de test dédié par plateforme est le prix d'entrée.
  2. Ne jamais compter sur les cookies tiers pour un suivi critique. Supposez qu'ils n'existent pas.
  3. Ne jamais livrer une SPA lourde sans SSR ou prérendu au trafic IAB. L'hydratation bloque le thread principal, l'INP s'effondre.
  4. Ne jamais intégrer de champs de carte bruts dans un IAB TikTok ou Meta. Utilisez Stripe Checkout (hébergé) ou des Elements tokenisés. L'application hôte peut observer les frappes.
  5. Ne jamais faire confiance au scoring reCAPTCHA v3 dans un IAB sans solution de repli. Par défaut, utilisez Cloudflare Turnstile.
  6. Ne jamais planifier l'API Événements comme 'phase 2'. Elle est mise en place dès le premier jour. iOS 14.5+ ATT + ITP en font le signal principal.
  7. Ne jamais utiliser 100vh seul. Superposez avec svh / dvh et une propriété personnalisée --vh de repli.
  8. Ne jamais placer le CTA principal sous le pli dans le trafic IAB. Vous perdrez 30 à 50 % des clics.
  9. Ne jamais bloquer le thread principal au chargement initial avec des widgets de chat, des cartes de chaleur ou des analytics. Différez à la première interaction ou à requestIdleCallback.
  10. Ne jamais hacher les PII dans le navigateur. Hachez côté serveur pour éviter de journaliser le texte brut dans RUM ou le rejeu.
  11. Ne jamais collecter de PII sensibles (SSN complet, PAN complet, permis de conduire, données de santé) dans une entrée rendue dans un IAB TikTok ou Meta. Supposez l'observation des frappes.
  12. Ne jamais bloquer TikTokBot, facebookexternalhit ou Meta-ExternalAgent au WAF. Ils génèrent des aperçus de liens. Les bloquer efface vos vignettes publicitaires.
  13. Ne jamais utiliser Origin Access Identity (OAI) sur les nouvelles piles AWS. C'est un héritage. Utilisez Origin Access Control (OAC).
  14. Ne jamais faire de test A/B côté client avec un éditeur visuel (mode visuel Optimizely / VWO / AB Tasty) sur une page d'atterrissage publicitaire. Répartissez à la périphérie via CloudFront Functions + KeyValueStore.
  15. Ne jamais déployer le vendredi après-midi sans un plan de rollback pré-établi.

Le flux de travail en 8 phases

Suivez cette épine dorsale pour chaque construction de page d'atterrissage. Chaque phase a son propre fichier dans references/ avec des listes de contrôle et des cas limites.

  1. Vérification de l'alignement créatif-LP — avant d'écrire du code, vérifiez que la création publicitaire, l'offre, le prix, les mentions légales et le ciblage correspondent à ce que la LP délivrera. 80 % des rejets de publicités TikTok sont détectés ici. Voir references/ads-policy.md.
  2. Construction, mobile-first, testé IAB — HTML statique ou Astro par défaut ; Next.js SSR uniquement avec justification. Héros au-dessus du pli IAB. Solution de repli de viewport en couches. Préconnexion aux domaines de pixels. JS au premier rendu < 150 KB gz. Voir references/tech-stack.md.
  3. Câblage Pixel + API Événements — définissez la taxonomie des événements et la source de vérité event_id avant le câblage. Livrez les deux pistes dès le premier jour. Hachez les champs EMQ côté serveur. Validez avec un code de test d'événement. Voir references/pixel-and-capi.md.
  4. QA dans le véritable IAB TikTok sur de vrais appareils — c'est la règle n°1 ci-dessus. Passez en revue les déclenchements de Pixel dans Events Manager, les événements CAPI avec test_event_code, les soumissions de formulaires de bout en bout, le comportement de défilement, le redimensionnement du clavier, la lecture automatique des vidéos, les liens profonds. Voir references/tiktok-iab.md.
  5. Staging sur AWS avec discipline d'invalidation — même WAF, mêmes fonctions de périphérie, même CSP que la production. Hachez les assets ; invalidez le HTML par chemin explicite, jamais /*. Voir references/aws-stack.md.
  6. Lancement progressif à 1–5 % du trafic de dépenses publicitaires — vérifiez les déclenchements de Pixel, le taux de déduplication est de 60–90 %, pas d'erreurs JS, l'INP sous le budget, le ratio soumission-de-formulaire-à-page-de-remerciement à la base. Surveillez deux heures avant de passer à l'échelle.
  7. Lancement complet avec tableau de bord RUM — p75 LCP/INP/CLS/TTFB par pays, appareil et IAB vs navigateur système ; graphique d'entonnoir ; graphique de taux de déduplication ; alarme sur chacun. Voir references/performance-monitoring.md.
  8. Tests A/B continus à la périphérie — chaque page d'atterrissage en direct exécute au moins une expérience via CloudFront Functions + KV Store. Pré-enregistrez les métriques de succès.

Fichiers de référence — quand charger lesquels

Lisez-les à la demande. Ne les chargez pas tous dans le contexte dès le départ.

FichierQuand le lire
references/tiktok-iab.mdPour toute question sur le comportement de la WebView TikTok, déboguer une page qui 'marche dans Safari mais casse dans TikTok', concevoir le viewport / les paiements / les liens profonds / la CSP
references/other-iabs.mdL'utilisateur demande spécifiquement un comportement sur Facebook / Instagram / Snap / Pinterest / LinkedIn / Twitter / Reddit / YouTube, ou si une atténuation est nécessaire sur une surface non-TikTok
references/pixel-and-capi.mdConfigurer le Pixel, l'API Événements, le hachage EMQ, la déduplication, les fenêtres d'attribution, le choix de passerelle (Lambda auto-hébergé vs sGTM vs fournisseur), SKAN / AdAttributionKit
references/ads-policy.mdRévision créative, restrictions verticales (alcool / jeux d'argent / finance / crypto / santé / perte de poids / rencontres), pages LP obligatoires, imagerie avant/après, règles sur le contenu IA
references/aws-stack.mdDécisions d'architecture (CloudFront, S3 + OAC, ACM, Route53, WAF, CloudWatch RUM, Lambda@Edge vs CloudFront Functions, compromis Amplify, CDK vs SAM, pourquoi AWS plutôt que Vercel / Netlify / Cloudflare Pages)
references/tech-stack.mdChoix du framework, bibliothèques de formulaires, paiements (Stripe Checkout vs Elements vs Link, enregistrement de domaine Apple Pay), polices, images, vidéo, CAPTCHA (Turnstile vs reCAPTCHA vs hCaptcha)
references/performance-monitoring.mdObjectifs CWV, réglage INP, configuration RUM, compatibilité du rejeu de session, instrumentation de l'entonnoir, outils d'expérimentation
references/anti-patterns.mdLorsque l'utilisateur demande quelque chose que vous devez refuser ou rediriger ('utilisons juste reCAPTCHA v3', 'Lighthouse dit 98, on est bons', 'on ajoutera le Pixel plus tard')

Modèles — points de départ copiables

Extraits statiques, pas des scripts exécutables. Adaptez au projet.

FichierObjectif
templates/iab-detection.jsRegex UA multi-token pour TikTok, Meta, Snap, Pinterest, LinkedIn, X, Reddit
templates/pixel-base.htmlInitialiseur Pixel TikTok avec porte holdConsent()
templates/capi-payload.jsonCorps de requête API Événements v1.3 avec champs EMQ et indicateur LDU
templates/csp-header.txtDirectives Content-Security-Policy compatibles avec Pixel TikTok + API Événements
templates/viewport-fallback.cssSolution de repli en couches vh / svh / --vh plus le JS qui définit --vh

Posture de communication par défaut

Lorsque vous examinez un plan ou une page, soyez catégorique et précis. Citez la règle violée. Proposez le remplacement concret. Évitez les hésitations sur les objectifs Core Web Vitals ou les règles strictes — ils sont mesurés, pas négociés.

Lorsque la demande est ambiguë (par exemple, 'aidez-moi à construire une page d'atterrissage'), clarifiez d'abord selon trois axes : (1) quelles plateformes enverront du trafic, (2) quel événement de conversion compte, (3) quelle est l'offre (et si elle se trouve dans un secteur restreint). Ne commencez pas à écrire du code tant que ces trois points ne sont pas fixés.

Lorsque le trafic de l'utilisateur n'est pas du trafic social payant (SEO, email, direct ou natif dans l'application), arrêtez-vous et signalez-le. Les hypothèses par défaut de cette compétence — isolation du stockage, effondrement du viewport IAB, instrumentation Pixel-first — sont mal calibrées pour d'autres canaux et ajouteraient du coût sans valeur.

Périmètre — quand ne pas utiliser cette compétence

Aiguillez ailleurs pour : les applications web complexes (tableaux de bord SaaS, consoles d'administration), les backends de catalogue e-commerce (PIM, inventaire, données produit), les outils internes, les sites de contenu axés sur le SEO (priorités CWV différentes, stratégie de rendu différente, pile d'analyse différente), le développement d'applications natives iOS / Android. La compétence est étroite et profonde : pages d'atterrissage uniques qui se chargent dans des WebViews hostiles, suivent via CAPI côté serveur, et convertissent dans les 30 secondes suivant un clic sur une annonce.

Skills associés