Семантика фида профиля
Как упоминалось в определениях категорий фидов, семантика моментального снимка фида — это следующие действия:
- Для любого поставщика в веб-канале моментальных снимков, если поставщик в настоящее время не существует в базе данных поставщика LSA, будет создан новый профиль.
- Для любого поставщика в веб-канале моментальных снимков, если поставщик в настоящее время существует в базе данных поставщика LSA, информация о профиле будет обновлена.
- Для любого поставщика, не включенного в канал моментальных снимков, если поставщик в настоящее время существует в базе данных поставщика LSA, профиль будет удален.
Семантика добавочного фида приводит к следующим действиям:
- Для любого поставщика в добавочном канале, если поставщик в настоящее время не существует в базе данных поставщика LSA, он не работает.
- Для любого поставщика в добавочном канале, если поставщик в настоящее время существует в базе данных поставщика LSA, информация о профиле будет обновлена.
- Для любого провайдера, не входящего в инкрементный фид, это недопустимо.
Обработка ошибок в профилях
Если отдельный элемент канала профиля недействителен, мы не будем обновлять этот элемент канала в базе данных LSA, а тем временем приостановим этот элемент, чтобы избежать предоставления устаревших данных.
Если фид профиля недействителен (например, не соответствует схеме), мы прекратим обработку всего фида. Мы поделимся отчетом, который включает в себя сводку результатов обработки каналов (например, ошибки, статус обработки для каждого элемента и т. д.).
Протокол и ограничения
Ограничения. Каждая компания (элемент фида) в фиде должна иметь уникальный идентификатор.
Ограничения. LSA накладывает ограничения на размер отдельных полей данных, указанные в таблице ниже.
Ограничения на название компании
- Максимальная длина: 100 символов, включая пробелы.
- Требуется хотя бы одна цифра или буква
- Поддерживаемые кодировки букв: UTF-8, UTF-16 и UTF-32 (рекомендуется UTF-8).
- Разрешены специальные символы:
- Дефис
-
, амперсанд&
, точка.
, запятая,
, апостроф'
, скобки(
)
- Дефис
- Запретить ВСЕ ЗАГЛАВНЫЕ БУКВЫ
- Запретить оскорбительные слова
- Запретить эмодзи
Поля профиля
Ниже описаны установленные поля для данного провайдера. Необязательные поля помечаются как таковые.
Имя поля | Описание | Тип поля | Пример | Необходимый | Ограничения |
---|---|---|---|---|---|
идентификатор_сервиса | Уникальный идентификатор компании (поставщика услуг) | количество | 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. | количество | Нет | Должна быть больше или равна резервной цене. |