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 compatibles avec la version actuelle de l'API Google Ads.
Opérations compatibles
Récupérer les budgets et les campagnes Local Services
Vous pouvez récupérer les budgets et les campagnes Local Services à l'aide de la méthode GoogleAdsService.Search
ou GoogleAdsService.SearchStream
afin d'interroger les ressources de la 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 le champ status
de la campagne et le champ amount_micros
du budget de campagne associé.
Définir la stratégie d'enchères de vos 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:
ManualCpa
en définissant le champmanual_cpa
Vous pouvez définir les enchères de
ManualCpa
viaLocalServicesCampaignSettings.category_bids
. Vous pouvez récupérer et définirLocalServicesCampaignSettings
des campagnes Local Services viaCampaign.local_services_campaign_settings
.MaximizeConversions
en définissant le champmaximize_conversions
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
de l'élément CampaignCriterion
envoyé à l'API Google Ads, à l'aide de CampaignCriterionService.MutateCampaignCriteria
.
Définir le ciblage géographique
Afin d'activer le ciblage géographique pour une campagne Local Services, ajoutez un 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 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 qui correspond aux zones géographiques et catégories de ciblage de votre campagne.
Opérations non acceptées
Les restrictions répertoriées dans le tableau suivant peuvent ê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 rapport en lecture seule suivantes:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Pour que ces ressources renvoient des données, le compte client à l'origine de la demande 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
expose les détails d'un prospect généré lorsqu'un consommateur appelle, 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 silead_status
est égal àWIPED_OUT
. - Les données provenant des prospects pour lesquels
category_id
fait partie d'une catégorie de soins de santé ne sont pas disponibles.
Conversation du prospect dans 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
, dans laquelle 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 qui sont 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'
Limites
- Pour accéder à l'URL d'enregistrement des appels, vous devez vous connecter avec une adresse e-mail disposant au moins d'un accès en lecture seule au compte client Google Ads auquel appartient 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
fournit des données de validation pour les entreprises des annonceurs. Notez que ces vérifications ont lieu au niveau de l'établissement et n'incluent pas les vérifications des employés. Les données comprennent les éléments suivants:
- Vérifications des licences
- Vérifications d'assurance
- Vérifications 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 celle-ci 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 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
- Heure de décision de la vérification d'antécédents (le cas échéant)
- URL du document d'assurance pour 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, noms)
- Motif du refus de la licence (le cas échéant)
- URL du document de licence pour afficher l'image de licence déjà envoyée (le cas échéant)
- Informations sur l'immatriculation de l'entreprise (vérifier la 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 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 validation liés aux licences d'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 concernant les licences et les assurances
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 par ID de catégorie de services locaux, vous pouvez utiliser un nouveau champ dans la ressource customer
, appelé LocalServicesSetting
.
Ce champ propose un résumé général de l'état des demandes de vérification des licences et des assurances par emplacement 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é de service local
LocalServicesEmployee
expose les données concernant les employés des services de proximité que les annonceurs ont importés dans nos systèmes.
Voici un exemple de requête qui récupère les données de tous les employés des services locaux 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