Composants Lieu

Contrairement aux autres composants, les composants Lieu sont créés automatiquement par l'API Google Ads une fois que vous avez créé un ensemble de composants. Commencez par créer un ensemble d'éléments de synchronisation d'établissements et associez-le au client. Ensuite, si vous devez sélectionner un sous-ensemble de composants Lieu dans l'ensemble d'assets d'une campagne ou d'un groupe d'annonces, créez un ensemble d'assets de groupe de zones géographiques et associez-le à la campagne ou au groupe d'annonces.

Créer un ensemble d'éléments de synchronisation de lieux et l'associer au client

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

Créer un ensemble d'éléments de synchronisation de lieux

1. Créez un AssetSet.
   1. Définissez type sur LOCATION_SYNC.
   2. Définissez location_set sur un nouveau LocationSet.
2. Dans le nouveau LocationSet :
   1. Définissez location_ownership_type en fonction de votre cas d'utilisation :
      • Définissez-le sur BUSINESS_OWNER si vous êtes le propriétaire de l'établissement.
      • Définissez-la sur AFFILIATE si vous n'êtes pas le propriétaire de 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 avec votre compte de fiche d'établissement Google.
      • Définissez chain_location_set si vous souhaitez effectuer une synchronisation avec les établissements se trouvant dans les ID de chaîne spécifiés.
      • Définissez maps_location_set si vous souhaitez ajouter manuellement des établissements à l'aide d'ID de lieu.

Une fois les étapes ci-dessus effectuées, l'API Google Ads génère des composants Lieu et les ajoute à l'ensemble de composants Lieu de synchronisation créé pour vous, de la même manière que 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 d'éléments de groupe d'établissements statiques.

Un seul élément de synchronisation d'établissement actif défini avec (status sur ENABLED) peut exister pour un client. Si vous devez créer un autre type d'ensemble d'éléments de synchronisation d'établissements, supprimez d'abord l'ensemble existant.

Associer l'ensemble de composants de synchronisation de position à un client

Utilisez CustomerAssetSetService.MutateCustomerAssetSets pour associer à votre client l'ensemble d'éléments de synchronisation d'établissements de la section précédente.

(Facultatif) Créer un ensemble de composants pour le groupe de zones géographiques et l'associer à une campagne ou à un groupe d'annonces

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

Les ensembles de composants de groupe de zones géographiques contiennent un sous-ensemble de composants Lieu de l'ensemble de composants Synchronisation de lieu. Vous pouvez créer dynamiquement un ensemble de composants de groupe de zones géographiques en utilisant certaines fonctionnalités des fiches d'établissement Google (comme le filtrage par libellé), ou des ID de chaînes et des établissements des chaînes. Vous pouvez aussi créer un ensemble d'éléments pour un groupe d'établissements de manière statique.

1. Créez un ensemble de composants de groupe de zones géographiques. L'ensemble d'éléments du groupe de zones géographiques peut être dynamique ou statique.
2. Associez l'ensemble d'assets à une campagne à l'aide ou à un groupe d'annonces, selon vos besoins.
3. (Facultatif) Ajoutez les éléments générés précédemment à l'ensemble d'éléments statique du groupe de zones géographiques que vous venez de créer.

Pour un client donné, vous pouvez créer plusieurs ensembles d'éléments de groupe de zones géographiques dynamiques ou statiques.

Créer un ensemble de composants pour le groupe de zones géographiques

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

Ensuite, définissez certains champs selon que vous souhaitez créer un ensemble d'éléments de groupe d'établissements dynamique ou statique.

Ensembles de composants dynamiques

Selon le champ que vous avez défini dans LocationSet, définissez les champs en fonction de la règle suivante:

Si vous définissez le champ suivant	Définissez ensuite type sur	Et définissez ce champ en tant que 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 lors de la création de l'ensemble d'éléments de synchronisation d'établissements, vous ne pourrez pas créer d'ensemble d'éléments de groupe d'établissements dynamique. En effet, vous avez ajouté manuellement des lieux par ID de lieu et il n'existe aucune fonctionnalité de filtrage que vous pouvez utiliser pour ce type d'établissement.

Ensembles d'éléments statiques

Définissez type sur STATIC_LOCATION_GROUP. Vous pouvez créer des ensembles d'assets de groupe de zones géographiques statiques pour tous les types d'ensembles d'assets de synchronisation d'établissements, quels que soient les champs (business_profile_location_set, chain_location_set ou maps_location_set) que vous avez définis dans le LocationSet.

Pour les ensembles de composants de groupe de zones géographiques statiques, vous devez ajouter manuellement les composants Lieu générés aux ensembles de composants du groupe de zones géographiques.

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

Utilisez CampaignAssetSetService.MutateCampaignAssetSets pour associer l'ensemble d'assets du groupe de zones géographiques à votre campagne.

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

(Facultatif) Ajoutez les composants Lieu à l'ensemble de composants static du groupe de zones géographiques.

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

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