Feed del profilo

Semantica del feed del profilo

Come indicato nelle definizioni delle categorie di feed, la semantica di un feed snapshot è la seguente:

  • Per qualsiasi fornitore in un feed di snapshot, se il fornitore non esiste attualmente nel database dei fornitori di LSA, verrà creato un nuovo profilo.
  • Per qualsiasi fornitore in un feed di snapshot, se il fornitore esiste attualmente nel database dei fornitori di LSA, le informazioni del profilo verranno aggiornate.
  • Per qualsiasi fornitore non presente in un feed snapshot, se il fornitore esiste attualmente nel database dei fornitori di annunci di Servizi locali, il profilo verrà eliminato.

La semantica di un feed incrementale comporta le seguenti azioni:

  • Per qualsiasi fornitore in un feed incrementale, se il fornitore attualmente non esiste nel database dei fornitori di annunci di Servizi locali, non viene eseguita alcuna operazione.
  • Per qualsiasi fornitore in un feed incrementale, se il fornitore esiste attualmente nel database dei fornitori di LSA, le informazioni del profilo verranno aggiornate.
  • Per qualsiasi fornitore non presente in un feed incrementale, non viene eseguita alcuna operazione.

Gestione degli errori nei profili

Se un elemento del feed del profilo individuale non è valido, non lo aggiorneremo nel database LSA e lo metteremo in pausa per evitare di pubblicare dati obsoleti.

Se un feed del profilo non è valido (ad es. non è conforme allo schema), interromperemo l'elaborazione dell'intero feed. Condivideremo un report che include un riepilogo del risultato dell'elaborazione dei feed (ad es. errori, stato di elaborazione per ogni elemento e così via).

Protocollo e vincoli

  1. Vincoli. Ogni attività (elemento del feed) all'interno di un feed deve avere un ID univoco.

  2. Limiti. Gli annunci di Servizi locali impongono limiti di dimensioni ai singoli campi di dati, specificati nella tabella seguente.

  3. Vincoli per il nome dell'attività

    1. Lunghezza massima: 100 caratteri, spazi inclusi
    2. Richiede almeno un numero o una lettera
    3. Le codifiche delle lettere supportate sono UTF-8, UTF-16 e UTF-32 (consigliata UTF-8).
    4. Caratteri speciali consentiti:
      1. Trattino -, e commerciale &, punto ., virgola ,, apostrofo ', parentesi ( )
    5. Non consentire il testo COMPLETAMENTE IN MAIUSCOLO
    6. Non consentire parole offensive
    7. Non consentire le emoji

Campi profilo

Di seguito sono descritti i campi impostati per un determinato fornitore. I campi facoltativi sono contrassegnati come tali.

Nome campo Descrizione Tipo di campo Esempio Obbligatorio Vincoli
serviceProviderId Identificatore univoco di una scheda dell'attività (un fornitore di servizi) numero 12345 Sì Si tratta di un ID univoco per ogni fornitore di servizi. Verrà convertito in un int64. Mantieni lo stesso ID quando aggiorni un fornitore
serviceProviderName Nome attività stringa "King David Garage Doors, Inc." Sì Massimo 100 caratteri. Soggetto alle norme relative ai vincoli di denominazione.
serviceProviderWebsiteUrl URL del sito web dell'attività stringa https://abc.xyz No Inizia con http o https
indirizzo Indirizzo dell'attività oggetto "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" Sì addressLine1 deve essere compilato con l'indirizzo quando disponibile. Il codice paese non può essere modificato dopo la configurazione iniziale dell'attività.
aggregatorProfileUrl URL del profilo che rimanda alla pagina del profilo sul sito del partner. stringa http://aggregator.com/joes-plumbing/ No Inizia con http o https
yearBusinessStarted Anno di fondazione dell'attività integer 2015 No Formato AAAA
businessHours Orari durante i quali l'attività è aperta Array di oggetti Vedi "Esempio di feed del profilo". Sì Visualizza la definizione dell'oggetto per i vincoli
businessPhoneNumber Numero di telefono dell'attività individuale in formato E.164, deve essere vuoto o di proprietà dell'attività, anziché un numero di call center o un numero di monitoraggio assegnato al partner. stringa "+16501112222" Sì Il numero di telefono deve essere nel formato E.164
contatto dati di contatto utilizzati per vari metodi di contatto Array di oggetti "{ “type”: “PHONE”, “address”: “+16501112222” }" Sì Il tipo può essere "PHONE" o "MESSAGE". Per il tipo "PHONE", l'indirizzo deve contenere un numero di telefono formattato secondo lo standard E.164. L'indirizzo "MESSAGE" non deve essere compilato. L'elemento di tipo TELEFONO è obbligatorio, mentre l'elemento di tipo MESSAGGIO è facoltativo.
targetingLanguages Un elenco delle lingue in cui verrà pubblicato l'annuncio. Le lingue sono definite nel codice lingua ISO 639-1 (minuscolo, due lettere). Array di stringhe "en", "fr" Sì Se non specificato, il valore predefinito è "en".
geoCovered Area geografica servita dall'attività. oggetto No
geoCovered ->criteriaIds Un elenco di ID criteri che corrispondono alle aree (regione, contea, città, codice postale) servite. Array di numeri interi No L'ID criterio geografico deve essere valido nell'elenco dei target geografici di Google Ads.
categorie Un elenco di categorie servite dall'attività. Array di oggetti Vedi "Esempio di feed del profilo". Sì Da selezionare dall'elenco di categorie fornito da Google. Deve contenere esattamente una categoria.
categorie->attività Un elenco di attività pubblicate in una determinata categoria. Array di oggetti Sì Essere selezionato dall'elenco di attività fornito da Google
tasks ->geoCovered Area geografica servita dall'attività oggetto Sì
tasks ->geoCovered->postalCodeCriteriaIds Un elenco di ID criteri che corrispondono ai codici postali pubblicati. Array di stringhe ID criteri geografici di un elenco di codici postali pubblicati, l'ID criteri deve essere valido nell'elenco dei target geografici di Google Ads con il tipo di target PostalCode
tasks ->geoCovered->cityCriteriaIds Un elenco di ID criteri che corrispondono alle città servite. Array di stringhe ID criteri geografici di un elenco di città pubblicate, l'ID criteri deve essere valido nell'elenco dei target geografici di Google Ads (con il tipo di target Città)
attivo Flag che indica se questa attività deve essere attiva o in pausa booleano true/false Sì
monthlyBudget Budget mensile di questo fornitore in monthlyBudgetCurrency integer 100 Sì Deve essere maggiore o uguale al valore massimo del prezzo di riserva dell'offerta o del lead.
monthlyBudgetCurrency Valuta del budget mensile e delle offerte. Consulta Codici valuta. stringa "USD" Sì Non può essere modificato dopo la configurazione iniziale dell'attività.
callout Un array di callout per ogni categoria Array di oggetti Sì Da selezionare dall'elenco di callout fornito da Google
biddingStrategy Strategia di offerta per questa attività per l'asta. Influisce sul prezzo per lead. stringa "MANUAL_CPA" / "MAX_CONVERSION" No Da selezionare dall'elenco fornito da Google . Se non viene impostata, questa strategia verrà impostata per impostazione predefinita su CPA manuale.
biddingConfiguration Un elenco di configurazioni di offerta per categoria. Applicabile solo alla strategia di offerta MANUAL_CPA. Array di oggetti Vedi un esempio di feed del profilo No Se non viene fornita alcuna configurazione e biddingStrategy è MANUAL_CPA, imposta ogni categoria sull'offerta minima.
biddingConfiguration->categoryId ID categoria nella tassonomia degli annunci di Servizi locali. Queste categorie devono corrispondere a quelle elencate sopra. Obbligatorio se viene dichiarata la configurazione delle offerte. stringa No Da selezionare dall'elenco fornito da Google.
biddingConfiguration->manualCostPerLead Configurazione manuale del costo per lead. Deve essere fornito se biddingStrategy è "MANUAL_CPA". oggetto No
manualCostPerLead->bid Offerta manuale basata sul costo per lead. Il prezzo del lead non supererà mai il valore di questa offerta. Obbligatorio se viene dichiarato manualCostPerLead. numero No Deve essere maggiore o uguale al prezzo di riserva.