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 :
- Les composants sont créés.
- Des objets
CampaignAsset
,AdGroupAsset
ouCustomerAsset
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
.