Лента профиля

Семантика фида профилей

Как упоминалось в определениях категорий каналов, семантика канала моментальных снимков включает в себя следующие действия:

  • Для любого поставщика в канале снимков, если поставщик в данный момент не существует в базе данных поставщиков LSA, будет создан новый профиль.
  • Для любого поставщика в канале снимков, если поставщик в настоящее время существует в базе данных поставщиков LSA, то информация профиля будет обновлена.
  • Для любого поставщика, не указанного в канале моментальных снимков, если этот поставщик в настоящее время существует в базе данных поставщиков LSA, профиль будет удален.

Семантика инкрементной подачи приводит к следующим действиям:

  • Для любого поставщика в инкрементном потоке, если поставщик в данный момент не существует в базе данных поставщиков LSA, это пустая операция.
  • Для любого поставщика в инкрементном канале, если поставщик в настоящее время существует в базе данных поставщиков LSA, то информация профиля будет обновлена.
  • Для любого поставщика, не участвующего в инкрементной подаче, это пустая трата времени.

Обработка ошибок в профилях

Если отдельный элемент фида профиля недействителен, то мы не будем обновлять этот элемент фида в базе данных LSA, а тем временем приостановим этот элемент, чтобы избежать предоставления устаревших данных.

Если фид профиля недействителен (например, не соответствует схеме), мы прекратим обработку всего фида. Мы предоставим отчёт, включающий сводку результатов обработки фидов (например, ошибки, статус обработки каждого элемента и т. д.).

Протокол и ограничения

  1. Ограничения. Каждая компания (элемент фида) в фиде должна иметь уникальный идентификатор.

  2. Ограничения. LSA накладывает ограничения на размер отдельных полей данных, указанные в таблице ниже.

  3. Ограничения на название компании

    1. Максимальная длина: 100 символов, включая пробелы.
    2. Требуется хотя бы одна цифра или буква
    3. Поддерживаемые кодировки букв: UTF-8, UTF-16 и UTF-32 (рекомендуется UTF-8).
    4. Разрешены специальные символы:
      1. Дефис - , Амперсанд & , Точка . , Запятая , , Апостроф ' , Скобки ( )
    5. Запретить ВСЕ ЗАГЛАВНЫЕ БУКВЫ
    6. Запретить оскорбительные слова
    7. Запретить эмодзи

Поля профиля

Ниже описаны поля, заданные для данного поставщика. Необязательные поля отмечены соответствующим образом.

Имя поля Описание Тип поля Пример Необходимый Ограничения
serviceProviderId Уникальный идентификатор бизнес-листинга (поставщика услуг) число 12345 Да Это уникальный идентификатор для каждого поставщика услуг. Он будет преобразован в тип int64. При обновлении поставщика сохраняйте тот же идентификатор.
ИмяПоставщикаУслуг Название компании нить «King David Garage Doors, Inc.» Да Максимум 100 символов. Действуют правила ограничения имён.
поставщик услуг веб-сайт URL URL-адрес веб-сайта компании нить https://abc.xyz Нет Начните с http или https
адрес Деловой адрес объект "addressLine1":"Оливер Авеню, 847", "city":"Вэлли Стрим", "region":"Нью-Йорк", "postalCode":"11581", "country":"США" Да В строке addressLine1 необходимо указать почтовый адрес (если он доступен). Код страны нельзя изменить после первоначальной настройки бизнеса.
агрегаторProfileUrl URL-адрес профиля, ведущий на страницу профиля на сайте партнера. нить http://aggregator.com/joes-plumbing/ Нет Начните с http или https
год начала бизнеса Год основания компании целое число 2015 Нет Формат ГГГГ
часы работы Часы работы предприятия Массив объектов См. «Пример фида профилей». Да См. определение объекта для ограничений.
businessPhoneNumber Индивидуальный номер телефона компании в формате e164 должен быть пустым или принадлежать компании, а не являться номером колл-центра или номером отслеживания, выделенным партнером. нить «+16501112222» Да Номер телефона должен быть в формате E.164.
контакт контактная информация, используемая для различных способов связи Массив объектов "{ “тип”: “ТЕЛЕФОН”, “адрес”: “+16501112222” }" Да Тип может быть «PHONE» или «MESSAGE». Для типа «PHONE» адрес должен содержать номер телефона в формате E.164. Для типа «MESSAGE» адрес не заполняется. Элемент с типом PHONE обязателен, а элемент с типом MESSAGE необязателен.
таргетингЯзыки Список языков, на которых будет показываться реклама. Языки определены в коде языка ISO 639-1 (строчные, 2 буквы). Массив строк «en», «fr» Да Если не указано, по умолчанию используется значение «en».
geoCovered География, обслуживаемая предприятием. объект Нет
geoCovered ->criteriaIds Список идентификаторов критериев, соответствующих обслуживаемым территориям (регион, округ, город, почтовый индекс). Массив целых чисел Нет Идентификатор геокритерия должен быть действительным в списке географических целей Google Ads.
категории Список категорий, обслуживаемых предприятием. Массив объектов См. «Пример фида профилей». Да Выбирать из списка категорий, предоставленного Google. Должен содержать только одну категорию.
категории->задачи Список задач, выполняемых в данной категории. Массив объектов Да Выбрать из списка задач, предоставленного Google
задачи ->геоохвачены Гео обслуживается задачей объект Да
задачи ->геоохвачено->почтовые индексыкритериев Список идентификаторов критериев, соответствующих обслуживаемым почтовым индексам. Массив строк Идентификатор географического критерия списка обслуживаемых почтовых индексов. Идентификатор критерия должен быть действительным в списке географических целей Google Ads с типом целевого объекта PostalCode.
задачи ->geoCovered->cityCriteriaIds Список идентификаторов критериев, соответствующих обслуживаемым городам. Массив строк Идентификатор географического критерия списка обслуживаемых городов, идентификатор критерия должен быть действительным в списке географических целей Google Ads с целевым типом «Город»).
активный Флаг, указывающий, следует ли активировать этот бизнес или приостановить его булев правда/ложь Да
месячный бюджет Месячный бюджет этого провайдера вmonthBudgetCurrency целое число 100 Да Должна быть больше или равна максимальной цене ставки или резервной цене лида.
месячный бюджет Валюта ежемесячного бюджета и ставок. См. Коды валют . нить "ДОЛЛАР США" Да Не может быть изменено после первоначальной настройки бизнеса.
выноски Массив выносок для каждой категории Массив объектов Да Выбрать из предоставленного Google списка выносок
Стратегия торгов Стратегия назначения ставок для этого бизнеса на аукционе. Влияет на цену за лид. нить «MANUAL_CPA» / «MAX_CONVERSION» Нет Выбирается из списка, предоставленного Google. Если не указано иное, по умолчанию будет использоваться стратегия MANUAL_CPA.
Конфигурация торгов Список конфигураций ставок для каждой категории. Применимо только к стратегии ставок MANUAL_CPA. Массив объектов См. пример фида профиля. Н Если конфигурация не указана и biddingStrategy равно MANUAL_CPA, по умолчанию для каждой категории устанавливается минимальная ставка.
Конфигурация ставок->Идентификатор категории Идентификатор категории в таксономии LSA. Эти категории должны соответствовать категориям, перечисленным выше. Требуется, если объявлена конфигурация торгов. нить Нет Выбирается из предоставленного Google списка.
Настройка ставок->ручнаяСтоимостьЗаЛид Ручная настройка цены за лид. Должен быть указан, если biddingStrategy — «MANUAL_CPA». объект Нет
manualCostPerLead->ставка Цена за лид, заданная вручную. Цена лида никогда не превысит значение этой ставки. Обязательно, если объявлено manualCostPerLead. число Нет Должна быть больше или равна резервной цене.