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

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

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

  • Для любого поставщика в веб-канале моментальных снимков, если поставщик в настоящее время не существует в базе данных поставщика 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. Запретить эмодзи

Поля профиля

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

Имя поля Описание Тип поля Пример Необходимый Ограничения
идентификатор_сервиса Уникальный идентификатор компании (поставщика услуг) количество 12345 Да Это уникальный идентификатор для каждого поставщика услуг. Это будет преобразовано в int64. Сохраняйте ID одинаковым при обновлении провайдера
serviceProviderName Наименование фирмы нить "Гаражные ворота короля Давида, Inc." Да Максимум 100 символов. В соответствии с политикой ограничения имен.
serviceProviderВеб-сайтUrl URL бизнес-сайта нить https://abc.xyz Нет Начните с http или https
адрес Юридический адрес объект "addressLine1": "847 Oliver Avenue", "город": "Valley Stream", "region": "NY", "postalCode": "11581", "country": "US" Да addressLine1 должен быть заполнен уличным адресом, если он доступен. Код страны нельзя изменить после первоначальной настройки бизнеса.
aggregatorProfileUrl URL-адрес профиля, ведущий на страницу профиля на сайте партнера. нить http://aggregator.com/joes-сантехника/ Нет Начните с http или https
годBusinessStarted Год основания бизнеса целое число 2015 Нет формат ГГГГ
часы работы Часы работы предприятия Массив объектов См. «Пример фида профиля». Да См. определение объекта для ограничений
бизнесНомер телефона Индивидуальный рабочий номер телефона в формате e164 должен быть либо пустым, либо принадлежать компании, а не номеру колл-центра или партнерскому номеру отслеживания. нить «+16501112222» Да Номер телефона должен быть в формате E.164.
контакт контактная информация, используемая для различных способов связи Массив объектов "{ "тип": "ТЕЛЕФОН", "адрес": "+16501112222" }" Да Тип может состоять из «ТЕЛЕФОН» или «СООБЩЕНИЕ». Для типа «ТЕЛЕФОН» адрес должен содержать номер телефона в формате E.164. Для «СООБЩЕНИЯ» адрес не должен быть заполнен. Элемент с типом PHONE обязателен, а элемент с типом MESSAGE необязателен.
таргетингЯзыки Список языков, на которых будет показываться реклама. Языки определены в коде языка ISO 639-1 (нижний регистр, 2 буквы). Массив строк «ан», «фр» Да Если не указано, по умолчанию используется «en».
geoCovered Гео обслуживается компанией. объект Нет
geoCovered -> идентификаторы критериев Список идентификаторов критериев, соответствующих обслуживаемым областям (область, округ, город, почтовый индекс). Массив целых чисел Нет Идентификатор географического критерия должен быть действительным в списке географических целей Google Рекламы.
категории Список категорий, обслуживаемых компанией. Массив объектов См. «Пример фида профиля». Да Для выбора из предоставленного Google списка категорий. Он должен содержать ровно одну категорию.
категории->задачи Список задач, выполняемых в данной категории. Массив объектов Да Для выбора из предоставленного Google списка задач
задачи ->geoCovered Гео обслуживается задачей объект Да
задачи ->geoCovered->postalCodeCriteriaIds Список идентификаторов критериев, соответствующих обслуживаемым почтовым индексам. Массив строк Идентификатор географического критерия из списка обслуживаемых почтовых индексов. Идентификатор критерия должен быть действительным в списке географических целей Google Реклама с целевым типом PostalCode.
задачи ->geoCovered->cityCriteriaIds Список идентификаторов критериев, соответствующих обслуживаемым городам. Массив строк Идентификатор географического критерия из списка обслуживаемых городов. Идентификатор критерия должен быть действительным в списке географических целей Google Реклама с целевым типом города.
активный Флаг, указывающий, должна ли эта компания быть активной или приостановленной логический правда/ложь Да
месячный бюджет Ежемесячный бюджет этого провайдера в monthBudgetCurrency целое число 100 Да Должна быть больше или равна максимальной резервной цене предложения или свинца.
месячный бюджетВалюта Валюта месячного бюджета и ставок. См. Коды валют . нить "ДОЛЛАР США" Да Невозможно изменить после начальной настройки бизнеса.
выноски Массив выносок для каждой категории Массив объектов Да Для выбора из предоставленного Google списка уточнений
ставкиСтратегия Стратегия назначения ставок для этой компании на аукционе. Влияет на цену лида. нить "MANUAL_CPA" / "MAX_CONVERSION" Нет Для выбора из предоставленного Google списка. Если не установлено, для этой стратегии по умолчанию будет использоваться MANUAL_CPA.
торгиКонфигурация Список конфигураций ставок для каждой категории. Применимо только к стратегии назначения ставок MANUAL_CPA. Массив объектов См. Пример фида профиля Н Если конфигурация не указана, а biddingStrategy имеет значение MANUAL_CPA, по умолчанию для каждой категории устанавливается минимальная ставка.
biddingConfiguration->categoryId Идентификатор категории в таксономии LSA. Эти категории должны соответствовать категориям, перечисленным выше. Требуется, если объявлена ​​конфигурация торгов. нить Нет Для выбора из предоставленного Google списка.
biddingConfiguration->manualCostPerLead Стоимость конфигурации лида вручную. Должен быть указан, если biddingStrategy имеет значение «MANUAL_CPA». объект Нет
manualCostPerLead->ставка Стоимость ставки лида вручную. Цена лида никогда не будет превышать значение этой ставки. Требуется, если объявлено manualCostPerLead. количество Нет Должна быть больше или равна резервной цене.