Compléments automatiques

L'API Google Ads est compatible avec les composants automatiques gérés directement par Google Ads. La portée de l'API est limitée à la mise en veille ou à la suppression de composants individuels, ainsi qu'à la récupération de statistiques. Vous pouvez activer ou désactiver les composants automatiques dans l'interface Web Google Ads.

Création et mise à jour

Une fois qu'un compte a activé cette fonctionnalité, Google Ads crée des composants automatiques comme suit :

  1. Les composants sont créés.
  2. Des objets CampaignAsset, AdGroupAsset ou CustomerAsset sont créés pour associer le composant aux ressources de campagne, de groupe d'annonces ou de client, respectivement.

Vous ne pouvez pas créer ni mettre à jour de composants automatiques à l'aide de l'API Google Ads. Vous ne pouvez pas non plus créer de CampaignAsset, AdGroupAsset ni CustomerAsset pour les composants automatiques à l'aide de l'API Google Ads.

Vous pouvez mettre en veille ou supprimer les entités CampaignAsset, AdGroupAsset ou CustomerAsset qui associent le composant automatique à la ressource correspondante.

Suspendre ou supprimer l'association

Si vous mettez en veille l'association, le composant ne sera plus diffusé temporairement pour l'entité correspondante. Une fois l'association suspendue, Google Ads ne réactivera pas automatiquement le composant correspondant ni ne le diffusera pour cette ressource tant qu'il n'aura pas été réactivé dans l'interface Web ou l'API. Pour désactiver définitivement l'association entre un composant et une ressource, supprimez-la.

Google Ads applique une limite au nombre de composants automatiques d'un type donné pouvant être associés à une entité donnée (par exemple, le nombre de liens annexes automatiques par campagne). Une association suspendue est comptabilisée dans cette limite, contrairement à une association supprimée. Les composants créés automatiquement ne sont pas comptabilisés dans les limites pour les composants ajoutés manuellement.

Récupérer les composants automatiques

Vous pouvez récupérer les données des composants automatiques en filtrant sur AssetSource = AUTOMATICALLY_CREATED. Pour les composants pouvant être associés à des annonces, vérifiez leur source. Consultez AssetType pour obtenir la liste des types de composants pouvant être associés à des annonces.

Voici un exemple de requête pour les composants d'une annonce :

SELECT
  ad_group.name,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.ad_group_ad
FROM ad_group_ad_asset_view
WHERE asset.source = 'AUTOMATICALLY_CREATED'

Pour les autres types de composants, interrogez directement la ressource Asset :

SELECT
  asset.id,
  asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'

Rapports

Vous pouvez demander des statistiques sur les performances des composants dans le rapport asset_field_type_view. Ce rapport inclut les statistiques agrégées pour les composants ajoutés automatiquement et manuellement.

Vous pouvez récupérer les statistiques de performances pour chaque composant dans les rapports campaign_asset, customer_asset et ad_group_asset.