Composants Lieu

Contrairement aux autres composants, les composants Lieu sont créés automatiquement par l'API Google Ads après la création d'un groupe de composants. Commencez par créer un ensemble de composants de synchronisation des lieux et à l'associer au client. Ensuite, si vous devez sélectionner un sous-ensemble de composants Lieu dans l'ensemble de composants pour une campagne ou un groupe d'annonces, créez un ensemble de composants Groupe de zones géographiques et associez-le à la campagne ou au groupe d'annonces.

Créer un ensemble de composants de synchronisation des lieux et l'associer au client

1. Créez un ensemble de composants de synchronisation des établissements.
2. Associez-le à un client à l'aide de CustomerAssetSetService.

Créer un ensemble de composants de synchronisation des lieux

1. Créez un AssetSet.
   1. Définissez type sur LOCATION_SYNC.
   2. Définissez location_set sur un nouveau LocationSet.
2. Dans la nouvelle LocationSet,
   1. Définissez location_ownership_type en fonction de votre cas d'utilisation :
      • Définissez-le sur BUSINESS_OWNER si vous êtes propriétaire de l'établissement.
      • Définissez-le sur AFFILIATE si vous ne possédez pas l'établissement, mais que vous y vendez vos produits.
   2. Définissez le champ "oneof" source en fonction de votre cas d'utilisation :
      • Définissez business_profile_location_set si vous souhaitez synchroniser vos établissements dans votre compte Fiche d'établissement Google.
      • Définissez chain_location_set si vous souhaitez synchroniser les données avec les établissements dont les ID de chaîne sont spécifiés.
      • Définissez maps_location_set si vous souhaitez ajouter manuellement des lieux à l'aide d'ID de lieu.

Une fois ces étapes terminées, l'API Google Ads génère des composants Lieu et les ajoute à l'ensemble de composants de synchronisation de lieu créé pour vous, comme lorsque vous le faites manuellement à l'aide de AssetSetAssetService. Vous n'avez pas besoin de les manipuler, sauf si vous souhaitez les ajouter manuellement à des ensembles de composants de groupe de lieux statiques.

Un seul ensemble de composants de synchronisation des lieux actifs avec (status sur ENABLED) peut exister pour un client. Si vous devez créer un autre type d'ensemble de composants de synchronisation des lieux, supprimez d'abord celui qui existe.

Associer l'ensemble de composants de synchronisation des établissements à un client

Utilisez CustomerAssetSetService.MutateCustomerAssetSets pour associer l'ensemble de composants de synchronisation des lieux créé dans la section précédente à votre client.

(Facultatif) Créez un ensemble de composants Groupe de zones géographiques et associez-le à une campagne ou à un groupe d'annonces.

Un ensemble de composants Groupe de zones géographiques n'est nécessaire que si vous devez sélectionner un sous-ensemble de composants Lieu. Cela est dû au fait que les campagnes et les groupes d'annonces héritent des composants Lieu au niveau du client.

Les ensembles de composants de groupe d'établissements contiennent un sous-ensemble de composants d'établissement de l'ensemble de composants Synchronisation des établissements. Vous pouvez créer dynamiquement un ensemble de composants de groupe d'établissements en tirant parti de certaines fonctionnalités de la fiche d'établissement Google (comme le filtrage par libellés) ou des ID et établissements de chaînes. Vous pouvez également créer statiquement un ensemble de composants de groupe de lieux.

1. Créez un ensemble de composants de groupe d'établissements. L'ensemble de composants du groupe de zones géographiques peut être dynamique ou statique.
2. Associez l'ensemble de composants à une campagne ou à un groupe d'annonces, selon vos besoins.
3. (Facultatif) Ajoutez les composants générés précédemment au nouvel ensemble de composants du groupe de lieux statiques.

Pour un client donné, vous pouvez créer plusieurs ensembles de composants de groupe d'établissements dynamiques ou statiques.

Créer un ensemble de composants de groupe d'établissements

Créez un AssetSet et définissez location_group_parent_asset_set_id sur l'ID de l'ensemble de composants de synchronisation des lieux créé précédemment.

Ensuite, définissez certains champs selon que vous souhaitez créer un ensemble de composants Groupe de zones géographiques dynamique ou statique.

Ensembles de composants dynamiques

En fonction du champ que vous définissez dans LocationSet, définissez les champs selon la règle suivante :

Si vous définissez le champ suivant	Définissez ensuite type sur	Définissez ce champ comme champ "oneof" asset_set_source.
business_profile_location_set	BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP	business_profile_location_group
chain_location_set	CHAIN_DYNAMIC_LOCATION_GROUP	chain_location_group

Si vous définissez maps_location_set lorsque vous créez l'ensemble de composants de synchronisation des lieux, vous ne pourrez pas créer d'ensemble de composants de groupe de lieux dynamiques. En effet, vous avez ajouté manuellement des lieux à l'aide d'ID de lieu. Aucune fonctionnalité de filtrage n'est disponible pour ce type de lieux.

Ensembles de composants statiques

Définissez type sur STATIC_LOCATION_GROUP. Vous pouvez créer des ensembles de composants de groupe de lieux statiques pour tous les types d'ensembles de composants de synchronisation des lieux, quels que soient les champs (business_profile_location_set, chain_location_set ou maps_location_set) que vous définissez dans LocationSet.

Pour les ensembles de composants de groupe d'établissements statiques, vous devez ajouter manuellement les composants Lieu générés aux ensembles de composants de groupe d'établissements.

Associez l'ensemble de composants à une campagne ou à un groupe d'annonces.

Utilisez CampaignAssetSetService.MutateCampaignAssetSets pour associer l'ensemble de composants Groupe de zones géographiques à votre campagne.

Vous pouvez également utiliser AdGroupAssetSetService.MutateAdGroupAssetSets si vous souhaitez associer l'ensemble de composants Groupe de zones géographiques à un groupe d'annonces.

(Facultatif) Ajoutez les composants Lieu à l'ensemble de composants du groupe de lieux statique.

Cette étape n'est obligatoire que si vous avez déjà créé un ensemble de composants de groupe d'établissements statique.

1. Utilisez le rapport asset_set_asset pour récupérer les noms de ressources des composants générés automatiquement pour l'ensemble de composants de synchronisation des établissements créé précédemment. Utilisez le filtrage pour ne récupérer que les composants souhaités.
2. Ajoutez-les à l'ensemble de composants du groupe de zones géographiques statiques à l'aide de AssetSetAssetService.MutateAssetSetAssets.