Plik danych profilu

Semantyka źródła treści profilu

Zgodnie z definicjami kategorii plików danych semantyka pliku danych typu snapshot obejmuje te działania:

  • Jeśli w przypadku dowolnego dostawcy w pliku danych zrzutu dostawca nie istnieje obecnie w bazie danych dostawców LSA, zostanie utworzony nowy profil.
  • W przypadku każdego dostawcy w pliku migawki, jeśli dostawca jest obecnie w bazie danych dostawców usług lokalnych, informacje w jego profilu zostaną zaktualizowane.
  • W przypadku każdego dostawcy, którego nie ma w pliku danych, jeśli dostawca jest obecnie w bazie danych dostawców LSA, profil zostanie usunięty.

Semantyka dodatkowego pliku danych powoduje wykonanie tych działań:

  • Jeśli dostawca w kanale przyrostowym nie istnieje obecnie w bazie danych dostawców LSA, nie zostanie wykonana żadna operacja.
  • W przypadku każdego dostawcy w pliku danych przyrostowych, jeśli dostawca jest obecnie w bazie danych dostawców usług lokalnych, informacje o profilu zostaną zaktualizowane.
  • W przypadku każdego dostawcy, który nie znajduje się w dodatkowym pliku danych, jest to operacja bez efektu.

Obsługa błędów w profilach

Jeśli poszczególny element pliku danych profilu jest nieprawidłowy, nie zaktualizujemy go w bazie danych usług lokalnych, a tymczasem wstrzymamy go, aby uniknąć wyświetlania nieaktualnych danych.

Jeśli plik danych profilu jest nieprawidłowy (np. nie jest zgodny ze schematem), przestaniemy przetwarzać cały plik danych. Udostępnimy raport zawierający podsumowanie wyników przetwarzania plików danych (np.błędy, stan przetwarzania poszczególnych produktów itp.).

Protokół i ograniczenia

  1. Ograniczenia. Każda firma (element pliku danych) w pliku danych musi mieć unikalny identyfikator.

  2. Limity. LSA nakłada limity rozmiaru na poszczególne pola danych, które są podane w tabeli poniżej.

  3. Ograniczenia dotyczące nazwy firmy

    1. Maksymalna długość: 100 znaków, w tym spacji.
    2. Wymaga co najmniej jednej cyfry lub litery
    3. Obsługiwane kodowania liter to UTF-8, UTF-16 i UTF-32 (zalecane jest UTF-8).
    4. Dozwolone znaki specjalne:
      1. Myślnik -, ampersand &, kropka ., przecinek ,, apostrof ', nawiasy ( )
    5. Nie zezwalaj na pisanie SAMYMI WIELKIMI LITERAMI
    6. Blokowanie obraźliwych słów
    7. Blokowanie emotikonów

Pola profilu

Poniżej znajdziesz opis ustawionych pól dla danego dostawcy. Pola opcjonalne są odpowiednio oznaczone.

Nazwa pola Opis Typ pola Przykład Wymagane Ograniczenia
serviceProviderId Unikalny identyfikator wizytówki firmy (usługodawcy). liczba 12345 Tak Jest to unikalny identyfikator każdego usługodawcy. Zostanie on przekonwertowany na typ int64. Nie zmieniaj identyfikatora przy aktualizacji dostawcy.
serviceProviderName Nazwa firmy ciąg znaków "King David Garage Doors, Inc." Tak Maksymalnie 100 znaków. Podlega zasadom dotyczącym ograniczeń nazw.
serviceProviderWebsiteUrl Adres URL witryny firmy ciąg znaków https://abc.xyz Nie Zacznij od http lub https.
adres Adres firmy obiekt "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" Tak Pole addressLine1 musi zawierać adres ulicy, jeśli jest dostępny. Po początkowej konfiguracji firmy nie można zmienić kodu kraju.
aggregatorProfileUrl Adres URL profilu, który prowadzi do strony profilu w witrynie partnera. ciąg znaków http://aggregator.com/joes-plumbing/ Nie Zacznij od http lub https.
yearBusinessStarted rok założenia firmy, liczba całkowita 2015 Nie Format RRRR
businessHours Godziny otwarcia firmy Tablica obiektów Zobacz „Przykład pliku danych o profilu”. Tak Ograniczenia w definicji obiektu
businessPhoneNumber Numer telefonu firmy w formacie e164. Powinien być pusty lub należeć do firmy, a nie do centrum obsługi telefonicznej ani być numerem do śledzenia połączeń przydzielonym przez partnera. ciąg znaków „+16501112222” Tak Numer telefonu musi być w formacie E.164.
kontakt dane kontaktowe używane w różnych metodach kontaktu; Tablica obiektów "{ “type”: “PHONE”, “address”: “+16501112222” }" Tak Typ może mieć wartość „PHONE” lub „MESSAGE”. W przypadku typu „PHONE” adres musi zawierać numer telefonu w formacie E.164. W przypadku adresu „MESSAGE” nie można wypełnić pola adresu. Element typu PHONE jest wymagany, ale element typu MESSAGE jest opcjonalny.
targetingLanguages Lista języków, w których będzie wyświetlana reklama. Języki są zdefiniowane za pomocą kodu języka ISO 639-1 (małe litery, 2-literowy). Tablica ciągów znaków „en”, „fr” Tak Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna „en”.
geoCovered Obszar geograficzny obsługiwany przez firmę. obiekt Nie
geoCovered ->criteriaIds Lista identyfikatorów kryteriów odpowiadających obsługiwanym obszarom (region, hrabstwo, miasto, kod pocztowy). Tablica liczb całkowitych Nie Identyfikator kryterium geograficznego musi być prawidłowy na liście docelowych lokalizacji geograficznych Google Ads.
kategorie Lista kategorii, w których działa firma. Tablica obiektów Zobacz „Przykład pliku danych o profilu”. Tak Do wyboru z listy kategorii udostępnionej przez Google. Musi zawierać dokładnie 1 kategorię.
categories->tasks Lista zadań w danej kategorii. Tablica obiektów Tak wybrać z listy zadań udostępnionej przez Google;
tasks ->geoCovered Obszar geograficzny, w którym wykonywane jest zadanie obiekt Tak
tasks ->geoCovered->postalCodeCriteriaIds Lista identyfikatorów kryteriów odpowiadających wyświetlanym kodom pocztowym. Tablica ciągów znaków Identyfikator kryterium geograficznego listy wyświetlanych kodów pocztowych. Identyfikator kryterium musi być prawidłowy na liście lokalizacji docelowych w Google Ads z typem elementu docelowego PostalCode.
tasks ->geoCovered->cityCriteriaIds Lista identyfikatorów kryteriów odpowiadających obsługiwanym miastom. Tablica ciągów znaków Identyfikator kryterium geograficznego listy miast, w których wyświetlają się reklamy. Identyfikator kryterium musi być prawidłowy na liście docelowych lokalizacji geograficznych Google Ads (typ elementu docelowego: miasto).
aktywna Flaga wskazująca, czy ta firma powinna być aktywna czy wstrzymana Wartość logiczna prawda/fałsz Tak
monthlyBudget Budżet miesięczny tego dostawcy w walucie monthlyBudgetCurrency. liczba całkowita 100 Tak Musi być równa maksymalnej stawce lub cenie minimalnej za potencjalnego klienta albo od niej większa.
monthlyBudgetCurrency Waluta budżetu miesięcznego i stawek. Zobacz kody walut. ciąg znaków „USD” Tak Po początkowej konfiguracji firmy nie można go zmienić.
objaśnienia Tablica wywołań dla każdej kategorii Tablica obiektów Tak Do wyboru z listy objaśnień dostarczonej przez Google
biddingStrategy Strategia ustalania stawek w przypadku aukcji dla tej firmy. Ma to wpływ na cenę potencjalnej transakcji. ciąg znaków „MANUAL_CPA” / „MAX_CONVERSION” Nie Do wyboru z listy podanej przez Google . Jeśli nie zostanie ustawiona, ta strategia będzie domyślnie korzystać z ustawienia MANUAL_CPA.
biddingConfiguration Lista konfiguracji określania stawek według kategorii. Dotyczy tylko strategii ustalania stawek MANUAL_CPA. Tablica obiektów Zobacz przykład kanału profilu N Jeśli nie podano konfiguracji, a wartość parametru biddingStrategy to MANUAL_CPA, ustaw dla każdej kategorii stawkę domyślną na minimalną.
biddingConfiguration->categoryId Identyfikator kategorii w taksonomii LSA. Kategorie te powinny być zgodne z kategoriami wymienionymi powyżej. Wymagany, jeśli zadeklarowano konfigurację określania stawek. ciąg znaków Nie Do wyboru z listy podanej przez Google.
biddingConfiguration->manualCostPerLead Ręczna konfiguracja kosztu potencjalnej transakcji. Należy podać, jeśli strategia ustalania stawek to „MANUAL_CPA”. obiekt Nie
manualCostPerLead->bid Ręczna stawka za potencjalne zlecenie. Cena za potencjalnego klienta nigdy nie przekroczy wartości tej stawki. Wymagany, jeśli zadeklarowano wartość manualCostPerLead. liczba Nie Musi być równa lub większa od ceny minimalnej.