Sémantique du flux de profil
Comme indiqué dans les définitions des catégories de flux, la sémantique d'un flux instantané correspond aux actions suivantes :
- Pour tout fournisseur figurant dans un flux d'instantanés, si le fournisseur n'existe pas actuellement dans la base de données des fournisseurs d'annonces Local Services, un profil sera créé.
- Pour tout fournisseur figurant dans un flux d'instantanés, si le fournisseur existe actuellement dans la base de données des fournisseurs LSA, les informations de son profil seront mises à jour.
- Pour tout fournisseur ne figurant pas dans un flux instantané, si le fournisseur existe actuellement dans la base de données des fournisseurs de services locaux, la fiche sera supprimée.
La sémantique d'un flux incrémentiel entraîne les actions suivantes :
- Pour tout fournisseur figurant dans un flux incrémentiel, si le fournisseur n'existe pas actuellement dans la base de données des fournisseurs LSA, il s'agit d'une opération sans effet.
- Pour tout fournisseur figurant dans un flux incrémentiel, si le fournisseur existe déjà dans la base de données des fournisseurs de services locaux, les informations de son profil seront mises à jour.
- Pour tout fournisseur ne figurant pas dans un flux incrémentiel, il s'agit d'une opération nulle.
Gestion des erreurs sur les profils
Si un élément de flux de fiche individuelle n'est pas valide, nous ne le mettrons pas à jour dans la base de données ALS. En attendant, nous le mettrons en veille pour éviter de diffuser des données obsolètes.
Si un flux de profil n'est pas valide (par exemple, s'il n'est pas conforme au schéma), nous cesserons de traiter l'intégralité du flux. Nous vous enverrons un rapport qui inclut un récapitulatif des résultats du traitement des flux (par exemple, les erreurs, l'état du traitement pour chaque élément, etc.).
Protocole et contraintes
Contraintes. Chaque établissement (élément de flux) d'un flux doit avoir un ID unique.
Limites. LSA impose des limites de taille aux champs de données individuels, spécifiées dans le tableau ci-dessous.
Contraintes concernant le nom de l'établissement
- Longueur maximale : 100 caractères, espaces compris
- Doit contenir au moins un chiffre ou une lettre
- Les encodages de caractères acceptés sont UTF-8, UTF-16 et UTF-32 (UTF-8 recommandé).
- Caractères spéciaux autorisés :
- Trait d'union
-, esperluette&, point., virgule,, apostrophe', parenthèses()
- Trait d'union
- Interdire les majuscules
- Interdire les mots choquants
- Interdire les emoji
Champs de profil
La section suivante décrit les champs définis pour un fournisseur donné. Les champs facultatifs sont indiqués comme tels.
| Nom du champ | Description | Type de champ | Exemple | Obligatoire | Contraintes |
|---|---|---|---|---|---|
| serviceProviderId | Identifiant unique d'une fiche d'établissement (un fournisseur de services) | Total | 12345 | Oui | Il s'agit d'un identifiant unique pour chaque fournisseur de services. Il sera converti en int64. Conserver l'ID lors de la mise à jour d'un fournisseur |
| serviceProviderName | Nom de l'entreprise | chaîne | "King David Garage Doors, Inc." | Oui | (100 caractères au maximum) Soumis au règlement sur les contraintes liées aux noms. |
| serviceProviderWebsiteUrl | URL du site Web de l'entreprise | chaîne | https://abc.xyz | Non | Commencez par http ou https |
| adresse | Adresse professionnelle | objet | "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" | Oui | addressLine1 doit être renseigné avec l'adresse postale, si elle est disponible. Une fois votre entreprise configurée, vous ne pourrez plus modifier le code pays. |
| aggregatorProfileUrl | URL du profil qui renvoie vers la page de profil sur le site du partenaire. | chaîne | http://aggregator.com/joes-plumbing/ | Non | Commencez par http ou https |
| yearBusinessStarted | Année de fondation de l'entreprise | entier | 2015 | Non | Format AAAA |
| businessHours | Heures d'ouverture de l'établissement | Tableau d'objets | Consultez "Exemple de flux de profil". | Oui | Consultez la définition de l'objet pour connaître les contraintes. |
| businessPhoneNumber | Numéro de téléphone professionnel individuel au format e164. Il doit être vide ou appartenir à l'entreprise, et non être un numéro de centre d'appels ou un numéro de suivi attribué par un partenaire. | chaîne | "+16501112222" | Oui | Le numéro de téléphone doit être au format E.164. |
| contact | coordonnées utilisées pour différentes méthodes de contact. | Tableau d'objets | "{ “type”: “PHONE”, “address”: “+16501112222” }" | Oui | Le type peut être "PHONE" (TÉLÉPHONE) ou "MESSAGE" (MESSAGE). Pour le type "PHONE", l'adresse doit contenir un numéro de téléphone au format E.164. L'adresse "MESSAGE" ne doit pas être renseignée. Un élément de type PHONE est obligatoire, mais un élément de type MESSAGE est facultatif. |
| targetingLanguages | Liste des langues dans lesquelles l'annonce sera diffusée. Les langues sont définies par un code de langue ISO 639-1 (en minuscules, à deux lettres). | Tableau de chaînes | "en", "fr" | Oui | Si aucune valeur n'est spécifiée, la valeur par défaut est "en". |
| geoCovered | Zone géographique desservie par l'établissement. | objet | Non | ||
| geoCovered ->criteriaIds | Liste des ID de critères correspondant aux zones desservies (région, département, ville, code postal). | Tableau d'entiers | Non | L'ID de critère géographique doit être valide dans la liste des cibles géographiques Google Ads. | |
| catégories | Liste des catégories desservies par l'établissement. | Tableau d'objets | Consultez "Exemple de flux de profil". | Oui | À sélectionner dans la liste de catégories fournie par Google. Elle ne doit contenir qu'une seule catégorie. |
| categories->tasks | Liste des tâches proposées dans une catégorie donnée. | Tableau d'objets | Oui | À sélectionner dans la liste des tâches fournie par Google | |
| tasks ->geoCovered | Zone géographique desservie par la tâche | objet | Oui | ||
| tasks ->geoCovered->postalCodeCriteriaIds | Liste des ID de critères correspondant aux codes postaux desservis. | Tableau de chaînes | ID de critère géographique d'une liste de codes postaux diffusés. L'ID de critère doit être valide dans la liste des cibles géographiques Google Ads avec le type de cible "PostalCode". | ||
| tasks ->geoCovered->cityCriteriaIds | Liste des ID de critères correspondant aux villes desservies. | Tableau de chaînes | ID de critère géographique d'une liste de villes desservies. L'ID de critère doit être valide dans la liste des cibles géographiques de Google Ads (avec le type de cible "Ville"). | ||
| actif | Indique si cet établissement doit être actif ou mis en veille. | booléen | true/false | Oui | |
| monthlyBudget | Budget mensuel de ce fournisseur dans la devise monthlyBudgetCurrency | entier | 100 | Oui | La valeur doit être supérieure ou égale au prix de réserve maximal de l'enchère ou du prospect. |
| monthlyBudgetCurrency | Devise du budget mensuel et des enchères. Consultez Codes de devise. | chaîne | "USD" | Oui | Non modifiable après la configuration initiale de l'entreprise. |
| accroches | Tableau des encadrés pour chaque catégorie | Tableau d'objets | Oui | À sélectionner dans la liste d'accroches fournie par Google | |
| biddingStrategy | Stratégie d'enchères pour cette entreprise pour les enchères. Cela a une incidence sur le prix par prospect. | chaîne | "MANUAL_CPA" / "MAX_CONVERSION" | Non | À sélectionner dans la liste fournie par Google . Si elle n'est pas définie, cette stratégie sera définie par défaut sur MANUAL_CPA. |
| biddingConfiguration | Liste des configurations d'enchères par catégorie. Applicable uniquement à la stratégie d'enchères MANUAL_CPA. | Tableau d'objets | Exemple de flux de profil | N | Si aucune configuration n'est fournie et que biddingStrategy est défini sur MANUAL_CPA, définissez l'enchère minimale pour chaque catégorie par défaut. |
| biddingConfiguration->categoryId | ID de catégorie dans la taxonomie LSA. Ces catégories doivent correspondre à celles listées ci-dessus. Obligatoire si la configuration des enchères est déclarée. | chaîne | Non | À sélectionner dans la liste fournie par Google. | |
| biddingConfiguration->manualCostPerLead | Configuration manuelle du coût par prospect. Doit être fourni si biddingStrategy est défini sur "MANUAL_CPA". | objet | Non | ||
| manualCostPerLead->bid | Enchère manuelle au coût par prospect. Le prix du prospect ne dépassera jamais la valeur de cette enchère. Obligatoire si manualCostPerLead est déclaré. | Total | Non | La valeur doit être supérieure ou égale au prix de réserve. |