Campagnes Local Services vous permettent de faire la promotion de votre entreprise sur Google et de recevoir des prospects directement de vos clients potentiels. Ce guide récapitule les opérations et dans 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 du
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 le status
de la campagne et les
du budget de campagne associé
amount_micros
.
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 de Campagnes Local Services:
ManualCpa
en définissant le champmanual_cpa
Vous pouvez définir les enchères de
ManualCpa
àLocalServicesCampaignSettings.category_bids
Vous pouvez récupérer et définirLocalServicesCampaignSettings
de Local Services les campagnesCampaign.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 campagne critère.
Créez un AdScheduleInfo
et définissez-le sur
ad_schedule
sur
CampaignCriterion
envoyé à l'API Google Ads via
CampaignCriterionService.MutateCampaignCriteria
.
Définir le ciblage géographique
Pour activer le ciblage géographique dans une campagne Local Services, ajoutez un
LocationInfo
et définissez-la sur
location
sur
CampaignCriterion
envoyé à l'API Google Ads via
CampaignCriterionService.MutateCampaignCriteria
.
Pour en savoir plus, consultez la section Localisation
le ciblage.
Cibler des types de services spécifiques
Pour activer le ciblage pour un type de service spécifique, ajoutez une
LocalServiceIdInfo
et définissez-la sur
type de
Google Cloud.
Vous devez utiliser un ID de service correspondant au ciblage de votre campagne location et category.
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 la récupération de groupes d'annonces, d'annonces ou de critères dans les campagnes Local Services. |
Ressources Local Services
À partir de la version 15 de l'API Google Ads, certaines données Les annonces Local Services sont diffusées directement. dans l'API Google Ads via les ressources de rapports 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, un service Local Services doit la campagne du compte client à l'origine de la demande. Et comme il ne peut y avoir une campagne Local Services par compte client, ces ressources spécifiez une 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'une
prospect généré lorsqu'un consommateur appelle, envoie un message ou réserve un service auprès de
l'annonceur.
Vous pouvez récupérer les données sur les prospects Local Services à partir de
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
appartient à la catégorie "Santé" sont non disponible.
Conversation avec les prospects Local Services
LocalServicesLeadConversation
expose les détails des conversations qui ont eu lieu dans le cadre d'une
LocalServicesLead
Il existe une relation de type un à plusieurs avec
LocalServicesLead
, où un prospect peut avoir de nombreuses conversations. La ressource
son nom figure dans le champ lead
.
Les données de conversation peuvent être récupérées
local_services_lead_conversation
ressource. 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 le
LocalServicesLeadService.AppendLeadConversation
pour ajouter LocalServicesLeadConversation
les ressources en LocalServicesLead
.
Limites
- Pour accéder à l'URL d'enregistrement des appels, vous devez vous connecter avec une adresse e-mail qui dispose au moins d'un accès en lecture seule au compte client Google Ads auquel appartient le à laquelle le prospect est associé.
Demander toutes les conversations en même temps peut prendre beaucoup de temps, donc vous devez 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 des données de validation pour les annonceurs les entreprises. Notez que ces
les validations sont effectuées au niveau de l'établissement et n'incluent pas les validations pour
les 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 nouvelle de l'artefact de validation est créée pour lui dans l'API Google Ads, et chaque artefact de validation représente une demande de validation unique. Chaque peut contenir certaines des informations suivantes, en fonction du type de demande de validation concerné:
- É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'immatriculation déjà envoyée image (le cas échéant)
Les données d'artefact de validation peuvent être récupérées à partir de
local_services_verification_artifact
ressource. Voici un exemple de requête qui récupère les données
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
zone géographique, en particulier code de cible géographique) et
catégorie de services de proximité
, vous pouvez utiliser un nouveau
de la ressource customer
, appelé
LocalServicesSetting
.
Ce champ offre un résumé général de l'état de la licence et de l'assurance les demandes de validation par zone géographique et par catégorie. Voici un exemple de requête 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
concernant les employés des services de proximité pour lesquels les annonceurs ont importé leur annonce
profil dans nos systèmes.
Voici un exemple de requête qui récupère les données 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