Создание аудитории для рекламы недвижимости

Начиная с выпуска Marketing API версии 15.0 создание аудитории для рекламы особой категории будет невозможно. Подробнее см. в разделе Аудитория для рекламы особой категории.

Создание аудитории для рекламы недвижимости:

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

Сигналы — это предварительно определенные события, которые могут отправляться с сайта или из приложения. С их помощью можно измерять эффективность кампаний и фиксировать намерения аудиторий. См. статью, посвященную настройке пикселя Facebook.

Для рекламы недвижимости пиксель на сайте и мобильное приложение должны отправлять следующие стандартные события:

Событие пикселяСобытие в приложенииОбязательное?Описание

Search

fb_mobile_search

Пользователь выполнил поиск в объявлениях о недвижимости.

ViewContent

fb_mobile_content_view

Пользователь просмотрел определенное объявление.

InitiateCheckout

fb_mobile_initiated_ checkout

Пользователь сохранил объявление, поставил "Нравится" или проявил к нему особый интерес.

Purchase

fb_mobile_purchase

Пользователь связался с агентом по поводу объявления.

  • ◉ — обязательное. Без этих событий реклама не будет работать.
  • ◎ — рекомендуемое. Не является строго обязательным, но позволяет повысить качество рекомендаций и таргетинга рекламы. Используйте как можно больше таких событий.
  • ◯ — необязательное. Можно пропустить.

Например, чтобы отслеживать событие поиска объявления с помощью пикселя Facebook или событий в приложении, добавьте на страницу с результатами поиска следующий код:

<!-- Facebook Pixel Code -->
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "home_listing");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "[\"1234\", \"2345\", \"3456\", \"4567\"]"); // top search results

// we must prefix all travel-specific parameters with fb_
parameters.putString("fb_city", "New York City"); // Required for Search event
parameters.putString("fb_region", "New York"); // region is the state for the US. Required for Search event
parameters.putString("fb_country", "US"); // Required for Search event

logger.logEvent(
  AppEventsConstants.EVENT_NAME_SEARCHED,
  parameters
);
[FBSDKAppEvents logEvent:FBSDKAppEventNameSearched
  parameters:@{
    FBSDKAppEventParameterNameContentType : @"home_listing",
    FBSDKAppEventParameterNameContentID : @"[\"1234\", \"2345\", \"3456\", \"4567\"]", // top search results
		// we must prefix all travel-specific parameters with fb_
		@"fb_city" : @"New York City", //Required for Search event
	  @"fb_region" : @"New York", // region is the state for the US. Required for Search event
	  @"fb_country" : @"US", // Required for Search event
  }
];

Решив, какие события должны инициироваться, задайте параметры для каждого из них.

Параметры событий

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

Параметр пикселяПараметр для мобильных приложенийОбязательное?

content_ids

fb_content_id

content_type

fb_content_type

lease_start_date

lease_end_date

preferred_baths_range

preferred_beds_range

preferred_price_range

currency

fb_currency

property_type

listing_type

availability

city

fb_city

neighborhood

region

fb_region

country

fb_country

Сведения о параметрах

Имя параметраТип данныхОписание

availability

string

Должен иметь значение available_soon, for_rent, for_sale, off_market, recently_sold или sale_pending.

city

string

Укажите город, который интересует пользователя, например 'Menlo Park'.

content_ids

string или string[]

Любые ID из каталога для объявления. Например, для события ViewContent следует отправлять ID просмотренного товара. Для события Search можно отправить массив ID с наиболее популярными результатами: ['1234', '2345', '3456', '4567'].

content_type

string или string[]

Примеры:

  • 'home_listing'
  • ['home_listing', 'product']
  • ['home_listing', 'hotel']

country

string

Интересующая страна, например 'United States'.

currency

string

Указывается в формате ISO 4217: 'USD'.

lease_start_date

string

Позволяет нам рекомендовать объекты недвижимости в соответствии с датами, когда они свободны (исходя из available_dates_price_config в каталоге), и улучшать целевые страницы для пользователей (с помощью тегов шаблонов). Указывается в формате даты ISO 8601: 'YYYY-MM-DD' (например, 2018-01-01).

lease_end_date

string

Указывается в формате даты ISO 8601: 'YYYY-MM-DD' (например, '2018-02-01').

listing_type

string

Должен иметь значение for_rent_by_agent, for_rent_by_owner, for_sale_by_agent, for_sale_by_owner, foreclosed, new_construction или new_listing.

neighborhood

string

Интересующий район: 'Menlo Oaks'.

preferred_baths_range

[int (мин.), int (макс.)]

Выбранное количество ванных комнат в виде диапазона: [1, 2].

preferred_beds_range

[int (мин.), int (макс.)]

Выбранное количество спален в виде диапазона: [1, 2].

preferred_price_range

[float (мин.), float (макс.)]

Ценовой диапазон: [1000.99, 2000.99].

property_type

string

Должен иметь значение apartment, condo, house, land, manufactured, other или townhouse.

region

string

Интересующий штат, провинция, область или край: 'California'.

Шаг 2. Связывание сигналов с каталогом объявлений.

Свяжите источники событий с каждым каталогом объявлений. Это можно сделать на странице "Каталог товаров" в Business Manager. Чтобы выбрать пиксель и приложение, которые отправляют события, посредством API, выполните запрос HTTP POST:

curl \
  -F '0=

Укажите следующие параметры:

Имя поляТип данныхОписание

external_event_sources (обязательное)

int[]

Список ID пикселей и приложений, которые необходимо связать с каталогом.

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

Для создания аудитории администратор вашей компании должен создать группу источников событий. В нее будут входить все источники, из которых отправляются сигналы интереса к объявлениям. Выполните запрос HTTP POST:

curl \
  -F 'name=My Real Estate Company Events' \
  -F 'event_sources=['

Затем предоставьте доступ к этой группе источников событий всем рекламным аккаунтам, из которых будет показываться реклама для аудиторий, созданных на основе этих источников событий. Выполните запрос HTTP POST:

curl \
  -F 'accounts=['

Шаг 4. Создание аудиторий.

Итак, вы настроили сигналы от пикселей или событий в приложении и связали их с группой источников событий и каталогом недвижимости. Чтобы таргетировать рекламу на людей, проявивших интерес к вашим объявлениям, создайте динамическую аудиторию. Добавляйте людей в аудиторию и исключайте из нее в соответствии с сигналами о намерениях. Кроме того, к аудитории можно применять дополнительные фильтры на основе правил так же, как к пользовательским аудиториям с сайта. См. статью о пользовательских аудиториях.

Чтобы создать аудиторию, выполните запрос HTTP POST к /act_<AD_ACCOUNT_ID>/customaudiences.

Обязательные параметры

Имя поляТип данныхОписание

name

string

Имя аудитории.

subtype

enum {CLAIM}

Тип пользовательской аудитории. Должен иметь значение CLAIM.

claim_objective

enum {HOME_LISTING}

Цель аудитории. Должна иметь значение HOME_LISTING.

event_source_group

id

Группа источников событий для создания аудитории.

inclusions

object[]

Массив объектов JSON. Содержит список всех сигналов о намерениях, на основании которых человек добавляется в аудиторию.

inclusions: event (обязательное)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Имя события сигнала. Используется для добавления в аудиторию: {'event': 'Search', …}.

inclusions: retention (обязательное)

object

Минимальный и максимальный период времени с момента получения события. Учитывается при определении того, должно ли включаться событие. Пример: {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. Минимальный срок удержания — 4 часа.

inclusions: count

ОператорыJSON

Сколько раз событие было инициировано. Можно использовать как операторы равенства, так и операторы числового сравнения, например {…'count': {'lte': 3}, …}.

Необязательные параметры

Имя поляТип данныхОписание

content_type

enum {HOME_LISTING}

Тип сигналов, с помощью которых формируется эта аудитория.

description

string

Описание аудитории.

exclusions

object[]

Массив объектов JSON со списком сигналов о намерении, которые приводят к исключению человека из аудитории.

exclusions: event (обязательное)

enum { Search, ViewContent, InitiateCheckout, Purchase }

Название события сигнала, используемого для исключения: {'event': 'Search', …}.

exclusions: retention (обязательное)

object

Минимальный и максимальный период времени с момента получения события. Учитывается при определении того, должно ли событие использоваться для исключения, например {…, 'retention': {'min_seconds': 0, 'max_seconds': 259200}, …}. Минимальный срок удержания — 4 часа.

rule

object

Правила пользовательских аудиторий с сайта. Поток событий должен фильтроваться согласно этим правилам до обработки параметров inclusions и exclusions.

См. список доступных полей. Их можно использовать с любыми стандартными операторами JSON для правил аудитории.

rule: home_listing_set_id (обязательное)

object

ID группы объявлений: {'eq': '1234'}}.

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

curl \
  -F 'name=Viewed or Purchased Last 14 days' \
  -F 'subtype=CLAIM' \
  -F 'claim_objective=HOME_LISTING' \
  -F 'content_type=HOME_LISTING' \
  -F 'event_source_group=