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 ensemble de composants. Commencez par créer un ensemble d'éléments de synchronisation de lieu et associez-le au client. Ensuite, si vous devez sélectionner un sous-ensemble des composants Lieu de l'ensemble d'assets pour une campagne ou 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 position et l'associer au client

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

Créer un ensemble de composants de synchronisation des lieux

1. Créez un objet 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 le 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 de fiches d'établissement Google.
      • Définissez chain_location_set si vous souhaitez synchroniser les emplacements des ID de chaîne spécifiés.
      • Définissez maps_location_set si vous souhaitez ajouter manuellement des lieux à l'aide d'ID de lieu.

Une fois que vous avez suivi les étapes ci-dessus, l'API Google Ads génère des composants de lieu et les ajoute à l'ensemble de composants de synchronisation de lieu créé pour vous, comme vous le feriez manuellement à l'aide de AssetSetAssetService. Vous n'avez pas besoin de les manipuler, sauf si vous souhaitez les ajouter manuellement à des ensembles d'assets de groupe d'emplacements statiques.

Un seul composant de synchronisation de position actif défini avec (status de ENABLED) peut exister pour un client. Si vous devez créer un autre type d'ensemble d'éléments de synchronisation de position, commencez par supprimer l'ensemble existant.

Associer l'élément de synchronisation de position défini à un client

Utilisez CustomerAssetSetService.MutateCustomerAssetSets pour associer le composant de synchronisation de position défini dans la section précédente à votre client.

(Facultatif) Créer un ensemble de composants de groupe de zones géographiques et l'associer à 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. En effet, 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 des composants d'établissement de l'ensemble de composants de synchronisation des établissements. Vous pouvez créer dynamiquement un ensemble d'éléments de groupe de zones géographiques en exploitant certaines fonctionnalités de la fiche d'établissement Google (comme le filtrage par libellé) ou les ID et les zones géographiques des chaînes. Vous pouvez également créer de manière statique un ensemble d'assets de groupe de zones géographiques.

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

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

Créer un ensemble d'assets 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 de composants de synchronisation de position créé précédemment.

Définissez ensuite certains champs en fonction de votre choix de créer un ensemble d'assets de groupe de zones géographiques dynamique ou statique.

Ensembles d'assets dynamiques

En fonction du champ que vous définissez 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	Définissez ce champ comme champ 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 d'éléments de synchronisation des lieux, vous ne pourrez pas créer d'ensemble d'éléments de groupe d'emplacements dynamiques. En effet, vous avez ajouté manuellement des établissements par ID de lieu et aucune fonctionnalité de filtrage n'est disponible pour ce type d'établissements.

Ensembles d'assets 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 de position, 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 d'assets de groupe d'établissements statiques, vous devez ajouter manuellement les composants Lieu générés aux ensembles d'assets de groupe d'établissements.

Associer l'ensemble d'assets à 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 d'éléments de groupe de zones géographiques à un groupe d'annonces.

(Facultatif) Ajouter 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 d'assets de groupe d'établissements statiques.

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 position créé précédemment. Utilisez le filtrage pour ne récupérer que les composants qui vous intéressent.
2. Ajoutez-les à l'ensemble d'éléments de groupe de zones géographiques statiques à l'aide de AssetSetAssetService.MutateAssetSetAssets.