Date de création : 2026-06-06
Auteur : Claude Code (Analyse architecturale sur demande de Raphaël)
Statut : VALIDÉ — Remplace la méthode CDP+Vision pour les extractions analytiques
Extraire les données d'analyse Meta Ads ET Shopify Analytics en mode 100% backend (aucun navigateur, aucune capture d'écran) via des APIs natives. Vitesse : 5-10 secondes au lieu de 2-3 minutes.
| Ancienne Méthode | Nouvelle Méthode |
|---|---|
| CDP Port 9222 + DOM scraping Meta | Meta Marketing API (Graph v20) |
| CDP Port 9222 + Screenshot + Vision IA | Shopify ShopifyQL via GraphQL Admin |
| 2-3 minutes, fragile aux updates UI | 5-10 secondes, stable |
| Chrome obligatoirement ouvert | Aucun navigateur requis |
La méthode CDP+Vision reste valide comme FALLBACK si les tokens API ne sont pas configurés.
https://developers.facebook.com/tools/explorerads_read, ads_managementGET https://graph.facebook.com/oauth/access_token
?grant_type=fb_exchange_token
&client_id={APP_ID}
&client_secret={APP_SECRET}
&fb_exchange_token={SHORT_TOKEN}
META_ACCESS_TOKENread_analytics (critique — absent par défaut)SHOPIFY_ADMIN_TOKENGET https://graph.facebook.com/v20.0/act_{AD_ACCOUNT_ID}/campaigns
?fields=id,name,start_time,stop_time,status,daily_budget
&effective_status=["ACTIVE","PAUSED"]
&access_token={META_ACCESS_TOKEN}
Données retournées : id, name, start_time (date de lancement = critique pour règle test jours 1-3), status
GET https://graph.facebook.com/v20.0/{CAMPAIGN_ID}/insights
?fields=spend,ctr,cpc,cpm,impressions,clicks,actions,cost_per_action_type
&level=campaign
&time_range={"since":"YYYY-MM-DD","until":"YYYY-MM-DD"}
&access_token={META_ACCESS_TOKEN}
Extraction des achats : dans actions[], filtrer action_type == "purchase" → value = nombre d'achats
CPA réel : dans cost_per_action_type[], filtrer action_type == "purchase" → value = CPA en €
GET https://graph.facebook.com/v20.0/{CAMPAIGN_ID}/insights
?fields=ad_id,ad_name,spend,ctr,cpc,impressions,actions
&level=ad
&time_range={"since":"YYYY-MM-DD","until":"YYYY-MM-DD"}
&access_token={META_ACCESS_TOKEN}
Usage : Identifier les créatives Sangsues (CPC > 2€, CTR < 1%) vs Gagnantes.
POST https://{STORE}.myshopify.com/admin/api/2024-01/graphql.json
Header: X-Shopify-Access-Token: {SHOPIFY_ADMIN_TOKEN}
Header: Content-Type: application/json
mutation shopifyqlQuery($query: String!) {
shopifyqlQuery(query: $query) {
tableData {
unformattedData
columnMeta { name dataType }
}
parseErrors { code message }
}
}
FROM sessions
SHOW sessions, added_to_carts, orders_placed, conversion_rate
SINCE {SINCE_DATE}
UNTIL {UNTIL_DATE}
Métriques disponibles : sessions, added_to_carts, orders_placed, conversion_rate, returning_customer_rate
Format dates : YYYY-MM-DD — utiliser start_time[:10] de la campagne Meta comme SINCE_DATE
| Signal | Décision |
|---|---|
| Spend > CPA_seuil × 1.5 ET 0 achat | KILL campagne |
| Spend > CPA_seuil × 0.5 ET 0 ATC | KILL campagne |
| CPC > 2€ ET CTR < 0.8% | KILL créative |
| CPA < seuil ET ≥ 3 achats ET ≥ 3 jours | SCALE +20% budget |
| Jours 1-3 : CPC > 2€ sur certaines pubs | OPTIMIZE : Kill les Sangsues uniquement |
| Bon CTR mais peu de sessions Shopify | TROUBLESHOOT : tracking / vitesse site |
Fichier : C:\ASSISTANT_IA\meta_shopify_analytics.py
Lancement :
python "meta_shopify_analytics.py"
# Ou avec filtre par nom de campagne :
python "meta_shopify_analytics.py" "Robe"
Ce script implémente : les 3 modules ci-dessus + la matrice de décision complète en un seul fichier autonome.
META_ACCESS_TOKEN et SHOPIFY_ADMIN_TOKEN sont disponiblesget_meta_campaigns() → récupérer campagnes actives + datesget_meta_campaign_insights(campaign_id, since, until)days_running depuis start_time → détermine règle Test vs Croisièreget_shopify_analytics(since_date, until_date) avec les mêmes datesapply_decision_matrix(meta_data, shopify_data, days_running)Si SHOPIFY_ADMIN_TOKEN non configuré → basculer sur l'ancienne méthode :
- Lancer capture_shopify_vision.py via CDP port 9222
- Lire la capture d'écran avec la vision multimodale
- Référence : Section R de SKILL_Global_Advanced_Automation.md
SOP_Analyse_Meta_Shopify.md — SOP principale (Phase 3 = ce SKILL remplace)SKILL_Global_Advanced_Automation.md — Section R (méthode fallback CDP+Vision)C:\ASSISTANT_IA\meta_shopify_analytics.py