Google Ads API et Performance Max : automatisation, exclusions et contrôle avancé

Les campagnes Performance Max représentent aujourd’hui la majorité des dépenses Google Ads pour les annonceurs avancés. Pourtant, leur gestion via l’interface Google Ads est frustrante : peu de contrôle, peu de transparence. La Google Ads API change la donne — à condition de savoir ce qu’elle permet réellement.

Ce guide couvre tout ce que vous pouvez automatiser et contrôler sur PMax via l’API en 2026.

Ce que la Google Ads API permet sur Performance Max

Depuis les versions récentes de l’API, les développeurs et agences peuvent :

• Créer et modifier des campagnes PMax via le service CampaignService
• Gérer les Asset Groups (textes, images, vidéos) via AssetGroupService
• Configurer les signaux d’audience via AssetGroupSignalService
• Définir les objectifs de conversion et les valeurs cibles
• Gérer les flux de produits pour les campagnes Shopping PMax
• Lire les rapports par asset group, catégorie de produit et canal

Créer une campagne Performance Max via l’API

Voici la structure minimale pour créer une campagne PMax :

campaign = {
    "name": "PMax — Produits Belgique",
    "advertising_channel_type": "PERFORMANCE_MAX",
    "status": "PAUSED",
    "bidding_strategy_type": "MAXIMIZE_CONVERSION_VALUE",
    "target_roas": 400,  # 400% ROAS cible
    "campaign_budget": budget_resource_name
}

Points importants :

• Le type de canal doit être PERFORMANCE_MAX — non modifiable après création
• Les stratégies d’enchères disponibles : MAXIMIZE_CONVERSIONS, MAXIMIZE_CONVERSION_VALUE (avec ou sans cible)
• Le budget doit être de type DAILY et non partagé

Gérer les Asset Groups

Les Asset Groups sont l’unité créative de PMax. Via l’API, vous pouvez en créer plusieurs par campagne et les cibler différemment.

Structure d’un Asset Group

asset_group = {
    "name": "Asset Group — Smartphones",
    "campaign": campaign_resource_name,
    "status": "ENABLED",
    "final_urls": ["https://example.be/smartphones/"],
    "final_mobile_urls": ["https://example.be/smartphones/"]
}

Ajouter des assets (textes, images, vidéos)

Chaque asset est d’abord créé via AssetService, puis lié à l’asset group via AssetGroupAssetService avec un field_type :

• HEADLINE (max 30 car.) — minimum 3, maximum 15
• LONG_HEADLINE (max 90 car.) — minimum 1
• DESCRIPTION (max 90 car.) — minimum 2
• MARKETING_IMAGE — ratio 1.91:1, min 600×314px
• SQUARE_MARKETING_IMAGE — ratio 1:1, min 300×300px
• YOUTUBE_VIDEO — minimum 10 secondes

Configurer les signaux d’audience

Les signaux d’audience guident l’algorithme PMax sans le contraindre. Via l’API, vous pouvez attacher :

• Audiences de remarketing (Customer Match, listes de visiteurs)
• Audiences similaires (si disponibles)
• Segments d’intérêt personnalisés

signal = {
    "asset_group": asset_group_resource_name,
    "audience": {
        "audience": "customers://audience/REMARKETING_LIST_ID"
    }
}

Important : les signaux d’audience ne sont pas des ciblages stricts. L’algorithme peut aller au-delà si cela améliore les performances.

Exclusions dans les campagnes Performance Max

C’est le point le plus demandé — et le plus limité. Voici ce qui est possible via l’API en 2026 :

Exclusions de mots-clés (négatifs au niveau campagne)

Disponible depuis la v15 via CampaignCriterionService :

criterion = {
    "campaign": campaign_resource_name,
    "negative": True,
    "keyword": {
        "text": "gratuit",
        "match_type": "BROAD"
    }
}

⚠️ Limite : maximum 100 négatifs exacts/expression par campagne PMax. Les listes de mots-clés négatifs partagées ne s’appliquent pas automatiquement aux campagnes PMax.

Exclusions de placements

Disponible via CustomerNegativeCriterionService au niveau compte (s’applique à toutes les campagnes) :

criterion = {
    "placement": {
        "url": "youtube.com/channel/CHANNEL_ID"
    }
}

Ce qui n’est PAS possible via l’API

• ❌ Voir les termes de recherche déclencheurs (non exposés en 2026)
• ❌ Exclure des catégories de produits spécifiques de l’inventaire Display
• ❌ Désactiver un canal spécifique (Search, Display, YouTube) au sein d’une campagne PMax

Rapports Performance Max via l’API

Rapport par Asset Group

SELECT
  asset_group.name,
  metrics.cost_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.impressions
FROM asset_group
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
AND segments.date DURING LAST_30_DAYS

Rapport par catégorie de produit (Shopping PMax)

SELECT
  asset_group_product_group_view.resource_name,
  metrics.cost_micros,
  metrics.conversions_value,
  metrics.impressions
FROM asset_group_product_group_view
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'

Performance par canal (depuis v16)

Depuis la v16, il est possible d’obtenir une ventilation approximative des performances par canal :

SELECT
  campaign.name,
  segments.ad_network_type,
  metrics.cost_micros,
  metrics.impressions
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'

Limitations connues et workarounds

FAQ — Google Ads API et Performance Max

Peut-on créer des campagnes PMax complètes via l’API ?

Oui, entièrement : campagne, budget, asset groups, assets, signaux d’audience et listing groups pour les flux Shopping peuvent tous être créés et modifiés via l’API.

Les exclusions de mots-clés PMax via l’API fonctionnent-elles vraiment ?

Oui, depuis la v15. Vous pouvez ajouter jusqu’à 100 mots-clés négatifs en exact ou expression par campagne PMax via CampaignCriterionService. Les listes partagées ne s’appliquent pas automatiquement.

Comment récupérer les performances par asset dans PMax ?

Via le rapport asset_group_asset qui retourne le performance_label (BEST, GOOD, LOW, LEARNING). Les métriques détaillées par asset ne sont pas disponibles — seul le label de performance est exposé.

Quelle version de l’API utiliser pour PMax en 2026 ?

La v17 ou v18 (selon disponibilité). La v24 apporte des améliorations sur les rapports PMax. Évitez les versions < v14 qui ont des fonctionnalités PMax très limitées.

Pour aller plus loin

• Toutes les nouveautés de la Google Ads API v24 — les derniers changements qui impactent PMax
• Obtenir son accès à la Google Ads API — developer token et OAuth2
• Conversions offline via la Google Ads API — importer vos leads qualifiés