Composants Lieu

Contrairement aux autres composants, les composants Lieu sont automatiquement créés 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'établissement et associez-le au client. Ensuite, si vous devez sélectionner un sous-ensemble de composants Lieu dans l'ensemble de composants d'une campagne ou d'un groupe d'annonces, créez un ensemble de composants de groupe de zones géographiques et associez-le à la campagne ou au groupe d'annonces.

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

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

Créer un ensemble de composants de synchronisation de lieu

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-le 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 dans votre compte de fiche d'établissement Google.
      • Définissez chain_location_set si vous souhaitez effectuer la synchronisation avec des établissements 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 que vous avez effectué les étapes ci-dessus, l'API Google Ads génère des composants Lieu et les ajoute à l'ensemble de composants Lieu créé pour la synchronisation, comme lorsque vous le faites manuellement avec 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.

Il ne peut exister qu'un seul ensemble de composants de synchronisation d'établissements actif (status défini sur ENABLED) pour un client. Si vous devez créer un autre type d'ensemble de composants de synchronisation de lieu, commencez par supprimer l'ensemble existant.

Associer le composant de synchronisation de lieu défini à un client

Utilisez CustomerAssetSetService.MutateCustomerAssetSets pour joindre à votre client le composant de synchronisation de l'établissement défini dans la section précédente.

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

Un ensemble de composants de type 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 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 de synchronisation de l'établissement. Vous pouvez créer dynamiquement un ensemble de composants de groupe de zones géographiques à l'aide de certaines fonctionnalités de la fiche d'établissement Google (comme le filtrage par libellé), ou des ID de chaîne et des établissements appartenant à une chaîne. Vous pouvez également créer un ensemble d'éléments de groupe de zones géographiques 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 de composants à une campagne utilisant ou à un groupe d'annonces, selon vos besoins.
3. (Facultatif) Ajoutez les éléments générés précédemment au nouvel ensemble de composants du groupe d'établissements statique.

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

Créer un ensemble de composants de 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 de l'établissement créé précédemment.

Définissez ensuite des champs selon que vous souhaitez créer un ensemble d'éléments de groupe d'établissements dynamique ou statique.

Ensembles de composants dynamiques

En fonction du champ que vous avez défini dans LocationSet, définissez-les en fonction de la règle suivante:

Si vous définissez le champ suivant	Définissez ensuite type sur	Définissez ce champ comme le 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 de composants de synchronisation de l'établissement, vous ne pourrez pas créer d'ensemble de composants de groupe de zones géographiques dynamique. En effet, vous avez ajouté manuellement des établissements par ID de lieu et vous ne pouvez utiliser aucune fonctionnalité de filtrage pour ce type d'établissements.

Ensembles de composants statiques

Définissez type sur STATIC_LOCATION_GROUP. Vous pouvez créer des ensembles de composants de groupes de zones géographiques statiques pour tout type d'ensembles de composants de synchronisation des é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 de composants de groupe de zones géographiques à votre campagne.

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

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

Cette étape n'est requise 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 de lieu créé précédemment. Utilisez le filtrage pour ne récupérer que les éléments de votre choix.
2. Ajoutez-les à l'ensemble de composants du groupe de zones géographiques statique à l'aide de AssetSetAssetService.MutateAssetSetAssets.