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 restrictions compatibles avec la version actuelle de l'API Google Ads.

Opérations compatibles

Récupérer les campagnes et les 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 de campagne 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 mettre à jour les champs status de la campagne et les champs amount_micros du budget de campagne associé.

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 des campagnes Local Services:

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 comme 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 d'une campagne Local Services, ajoutez un élément LocationInfo et définissez-le sur le location du CampaignCriterion envoyé à l'API Google Ads, à l'aide de CampaignCriterionService.MutateCampaignCriteria. Pour en savoir plus, consultez l'article Ciblage géographique.

Cibler des types de services spécifiques

Pour activer le ciblage pour un type de service spécifique, ajoutez un élément LocalServiceIdInfo et définissez-le sur le type de service.

Vous devez utiliser un ID de service correspondant aux zones géographiques et aux catégories de ciblage de votre campagne.

Opérations non acceptées

Les restrictions listées dans le tableau suivant sont susceptibles d'être modifiées 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, modifier, supprimer ni récupérer des groupes d'annonces, des annonces ou des critères dans les campagnes Local Services.

Ressources Local Services

À partir de la version 15 de l'API Google Ads, certaines données des annonces Local Services sont exposées directement dans l'API Google Ads via les ressources de rapports suivantes en lecture seule:

Pour que ces ressources renvoient des données, le compte client à l'origine de la requête doit comporter une campagne Local Services. Étant donné qu'il ne peut y avoir qu'une seule campagne Local Services 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 présente les détails d'un prospect qui sont générés lorsqu'un consommateur appelle un service, lui envoie un message ou réserve un service auprès de l'annonceur.

Les données sur les prospects Local Services 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.
  • Les données des prospects pour lesquels category_id appartient à la catégorie "Santé" ne sont pas disponibles.

Conversation avec les prospects Local Services

LocalServicesLeadConversation expose les détails des conversations qui ont eu lieu dans un LocalServicesLead. Il existe une relation de type un à plusieurs avec LocalServicesLead, où un prospect peut avoir de nombreuses 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 correspondant à des 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'

À partir de la version 17 de l'API Google Ads, vous pouvez utiliser la méthode LocalServicesLeadService.AppendLeadConversation pour ajouter des ressources LocalServicesLeadConversation à un LocalServicesLead.

Limites

  • Pour accéder à l'URL d'enregistrement des appels, vous devez vous connecter à l'aide d'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 en même temps peut prendre beaucoup de 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.id = LEAD_ID

Artefact de validation Local Services

LocalServicesVerificationArtifact expose les données de validation pour les entreprises des annonceurs. Notez que ces vérifications s'appliquent au niveau de l'entreprise et n'incluent pas celles des employés. Ces données incluent les éléments suivants:

  • Vérifications de licence
  • Vérification des attestations d'assurance
  • Vérification d'antécédents
  • Validation de l'immatriculation de l'entreprise

Chaque fois qu'une demande de validation est envoyée à Annonces Local Services, une instance d'artefact de validation est créée pour elle dans l'API Google Ads. Chaque artefact de validation représente une demande de validation unique. Chaque artefact de validation peut contenir certaines des informations suivantes, en fonction du type de requête de validation qu'il représente:

  • État de chaque artefact de validation
  • URL de vérification d'antécédents à utiliser pour la vérification d'antécédents
  • Délai de prise de décision pour la vérification d'antécédents (le cas échéant)
  • URL du document d'assurance permettant d'afficher les informations d'assurance déjà envoyées
  • Motif du refus de l'assurance (le cas échéant)
  • Informations sur la licence (type, numéro, prénom, 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 de l'immatriculation de l'entreprise (identifiant de vérification, 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, permettant d'afficher l'image d'immatriculation déjà envoyée (le cas échéant)

Les données d'artefact 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 vérification 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 l'assurance

Pour déterminer de manière programmatique l'état des demandes de validation par zone géographique, en particulier par code de cible géographique) et ID de catégorie de services locaux, vous pouvez utiliser un nouveau champ sur la ressource customer, appelé LocalServicesSetting.

Ce champ offre un résumé général de l'état des demandes de vérification 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é Local Services

LocalServicesEmployee expose les données sur les employés des services de proximité que les annonceurs ont importés dans nos systèmes pour leur profil d'annonce.

Voici un exemple de requête qui récupère les données de tous les employés Local Services 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