Campagnes Local Services

Les campagnes Local Services vous permettent de promouvoir votre établissement sur Google et de recevoir des prospects directement de la part de vos clients potentiels. Ce guide récapitule les opérations et les restrictions acceptées dans la version actuelle de l'API Google Ads.

Opérations prises en charge

L'API Google Ads est compatible avec les opérations suivantes pour les campagnes Local Services.

Récupérer les campagnes et budgets Local Services

Vous pouvez récupérer les campagnes et les budgets Local Services à l'aide de la méthode GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger les ressources Campaign où advertising_channel_type = 'LOCAL_SERVICES'. Voici un exemple :

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Modifier les campagnes Local Services

Vous pouvez modifier les champs status et amount_micros associés au budget de la campagne.

Définir la stratégie d'enchères des campagnes Local Services

Vous pouvez définir les stratégies d'enchères suivantes comme stratégie d'enchères standard pour les campagnes Services de proximité :

Définir un calendrier de diffusion des annonces comme critère de campagne

Vous pouvez définir un calendrier de diffusion des annonces pour une campagne Local Services en tant que critère de campagne.

Créez un AdScheduleInfo et définissez-le sur le ad_schedule du CampaignCriterion envoyé à l'API Google Ads à l'aide de CampaignCriterionService.MutateCampaignCriteria.

Définir le ciblage géographique

Pour activer le ciblage géographique pour une campagne Local Services, ajoutez un LocationInfo et définissez-le sur le champ location du CampaignCriterion envoyé à l'API Google Ads, à l'aide de CampaignCriterionService.MutateCampaignCriteria. Pour en savoir plus, consultez Ciblage géographique.

Cibler des types de services spécifiques

Pour activer le ciblage pour un type de service spécifique, créez un LocalServiceIdInfo avec l'un des ID de catégorie de services locaux, définissez-le sur le champ local_service_id d'un CampaignCriterion, puis envoyez-le à l'aide de CampaignCriterionService.MutateCampaignCriteria.

Vous devez utiliser un ID de service qui correspond à la zone géographique et à la catégorie de ciblage de votre campagne.

Envoyer des commentaires sur les prospects

Utilisez la méthode ProvideLeadFeedback de LocalServicesLeadService pour envoyer une note et des commentaires sur un prospect. Vous pouvez également inspecter le champ lead_feedback_submitted de LocalServicesLead pour déterminer si un prospect a été évalué et si des commentaires ont été envoyés.

Opérations non acceptées

Les restrictions listées dans le tableau ci-dessous peuvent changer dans les futures versions de l'API Google Ads.

Opérations non acceptées
Créer et supprimer des campagnes L'API Google Ads bloque la création de campagnes Local Services.
Opérations sur les sous-entités d'une campagne L'API Google Ads ne permet pas de créer, de modifier, de supprimer ni de récupérer des groupes d'annonces, des annonces ou des critères dans les campagnes Local Services.

Ressources Local Services

Certaines données des annonces Local Services sont directement exposées dans l'API Google Ads via les ressources de rapport en lecture seule suivantes :

Pour que ces ressources renvoient des données, le compte client qui envoie la demande doit comporter une campagne Services de proximité. Comme il ne peut y avoir qu'une seule campagne Services de proximité par compte client, ces ressources ne spécifient pas de campagne. Pour identifier la campagne à laquelle ces ressources sont affiliées, utilisez la requête suivante :

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Prospect Local Services

LocalServicesLead expose les détails d'un prospect générés lorsqu'un consommateur appelle, envoie un message ou réserve un service auprès de l'annonceur.

Les données sur les prospects pour les services locaux peuvent être récupérées à partir de la ressource local_services_lead. Voici un exemple de requête :

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead

Limites

  • Le champ contact_details est nul si lead_status est égal à WIPED_OUT.
  • À partir de v25, ContactDetails.email est supprimé et ContactDetails.phone_number_extension est disponible dans le message ContactDetails renvoyé par local_services_lead.contact_details.
  • Les données des prospects dont le category_id fait partie d'une catégorie de santé ne sont pas disponibles.

Conversation avec un prospect Local Services

LocalServicesLeadConversation expose les détails des conversations qui ont eu lieu dans le cadre d'un LocalServicesLead. Il existe une relation de type un à plusieurs avec LocalServicesLead, où un prospect peut avoir plusieurs conversations. Le nom de ressource du prospect associé se trouve dans le champ lead.

Les données de conversation peuvent être récupérées à partir de la ressource local_services_lead_conversation. Voici un exemple de requête qui filtre les résultats pour les appels téléphoniques :

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

Vous pouvez utiliser la méthode LocalServicesLeadService.AppendLeadConversation pour ajouter des ressources LocalServicesLeadConversation à un LocalServicesLead.

Limites

  • Pour accéder à l'URL de l'enregistrement de l'appel, vous devez vous connecter avec une adresse e-mail disposant au moins d'un accès en lecture seule au compte client Google Ads propriétaire de la campagne à laquelle le prospect est associé.

  • Demander toutes les conversations à la fois peut prendre du temps. Vous devez donc filtrer les conversations par prospect, par exemple :

    SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.message_details.text
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

Document de validation Local Services

LocalServicesVerificationArtifact expose les données de validation des entreprises des annonceurs. Notez que ces validations sont effectuées au niveau de l'entreprise et n'incluent pas celles des employés. Les données incluent les éléments suivants :

  • Vérification des licences
  • Vérification des assurances
  • Vérifications des antécédents
  • Validations de l'immatriculation des entreprises

Chaque fois qu'une demande de validation est envoyée aux annonces Local Services, une instance d'artefact de validation est créée dans l'API Google Ads. Chaque artefact de validation représente une seule demande de validation. Chaque artefact de validation peut contenir certaines des informations suivantes, selon le type de demande de validation qu'il représente :

  • État de chaque artefact de validation
  • URL de vérification des antécédents à utiliser pour la validation
  • Délai de traitement de la vérification des antécédents (le cas échéant)
  • URL du document d'assurance permettant de consulter les informations sur l'assurance déjà envoyées
  • Motif du refus de l'assurance (le cas échéant)
  • Informations sur la licence (type, numéro, nom, prénom)
  • Motif du refus de la licence (le cas échéant)
  • URL du document de licence permettant d'afficher l'image de licence déjà envoyée (le cas échéant)
  • Détails d'immatriculation de l'entreprise (pièce d'identité, numéro d'immatriculation)
  • Motif du refus de l'immatriculation de l'entreprise (le cas échéant)
  • URL du document d'immatriculation de l'entreprise pour afficher l'image d'immatriculation déjà envoyée (le cas échéant)

Les données des artefacts de validation peuvent être récupérées à partir de la ressource local_services_verification_artifact. Voici un exemple de requête qui récupère les données de tous les artefacts de validation liés aux licences pour un compte client donné :

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_verification_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

Données géographiques et catégorielles sur les licences et les assurances

Pour déterminer par programmation l'état des demandes de validation par zone géographique (plus précisément, le code de ciblage géographique) et l'ID de catégorie de services locaux, vous pouvez utiliser le champ local_services_settings de la ressource customer, qui est de type LocalServicesSettings.

Ce champ présente un récapitulatif de haut niveau de l'état des demandes de validation des licences et des assurances par zone géographique et par catégorie. Voici un exemple de requête qui récupère toutes ces données :

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

Employé d'un prestataire local

LocalServicesEmployee expose les données sur les employés des services locaux que les annonceurs ont importées dans leur fiche d'établissement dans nos systèmes.

Voici un exemple de requête qui récupère les données de tous les employés du service local pour un compte client donné :

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee

Campagnes Performance Max Local Services

Les campagnes Performance Max sont compatibles avec les paramètres liés aux services locaux à partir du v24. Ces paramètres vous permettent de configurer et d'identifier une campagne Performance Max qui diffuse des annonces Local Services (campagne PMax ALS).

Identifier les campagnes Performance Max Local Services

Pour identifier si une campagne Performance Max est une campagne Annonces Local Services, consultez le champ en lecture seule local_services_enabled sur la page pmax_campaign_settings de la campagne.

Configurer les paramètres

Pour les campagnes où local_services_enabled est défini sur true, configurez les paramètres sous le champ local_services_pmax_campaign_settings :

  • navigational_query_leads_enabled : indique s'il faut utiliser un filtre de requête de navigation.
  • founding_year : année de création de l'établissement.
  • country_code : code pays de l'annonce Local Services. Ce champ est immuable et n'est défini qu'une seule fois lors de la création de l'annonce. Il s'agit d'un code pays à deux lettres en majuscules, utilisé pour déterminer les exigences de validation et valider la sélection des critères de localisation.
  • phone_numbers : liste des numéros de téléphone associés au fournisseur, représentés par des messages LocalServicesPhoneNumber.

Numéros de téléphone

Chaque entrée du champ répété phone_numbers utilise le type de message LocalServicesPhoneNumber avec les champs suivants :

  • phone_number : numéro de téléphone.
  • country_code : code pays à deux lettres en majuscules.
  • phone_number_type : type de numéro de téléphone, défini par GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Voici les types acceptés :
    • DESTINATION_PHONE_NUMBER_FOR_ADS : numéro de destination à utiliser pour les appels provenant d'un bloc d'annonces Services de proximité (par défaut).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY : numéro de destination compatible avec les SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY : numéro de destination du compte WhatsApp d'un fournisseur.