Расширенный поиск совпадений

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

Выполнив поиск совпадений, мы полностью удаляем хэшированную информацию.

Настроить расширенный поиск совпадений можно несколькими способами.

• Facebook SDK: добавьте в свое мобильное приложение для Android или iOS код для отправки данных на Facebook вручную.
• API Facebook App Events: добавьте в код запросы для отправки данных на Facebook вручную.
• Events Manager: на панели Events Manager включите для приложения автоматический расширенный поиск совпадений, чтобы отправлять данные на Facebook.
• SDK Mobile Measurement Partner (MMP): добавьте в свое приложение для Android или iOS код для отправки данных на панель Adjust.

Facebook SDK

При отправке данных событий в приложении на Facebook с помощью Facebook SDK вся информация о пользователях хэшируется. Хэшированные данные сохраняются между экземплярами приложения.

Требования

• Facebook SDK 4.36 или более поздней версии

Android

При инициализации AppEventsLogger укажите данные пользователя с помощью функции setUserData. Она хэширует эти данные.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

iOS

При инициализации FBSDKAppEvents укажите данные пользователя с помощью функции setUserData. Эти данные хэшируются и сохраняются между экземплярами приложения.

Рекомендации

• Чтобы расширенный поиск совпадений выполнялся правильно, рекомендуем установить последнюю версию Facebook SDK для iOS. Подробные сведения см. в журнале изменений SDK для iOS.

Пример кода для одного типа данных

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

Пример кода для нескольких типов данных

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

Events Manager

При использовании автоматического расширенного поиска совпадений Facebook SDK распознает и собирает данные пользователей вместе с информацией о событии, т. е. действии, которое происходит в вашем приложении. Перед отправкой на Facebook эти данные хэшируются.

Чтобы включить автоматический расширенный поиск совпадений, в Events Manager выберите вкладку Настройки и переведите переключатель Автоматический расширенный поиск совпадений в положение ВКЛ. Можно также передавать хэшированные электронные адреса и номера телефонов.

Для использования этой возможности требуется Facebook SDK 5.8.0 или более поздней версии.

Adjust SDK

Добавление данных клиентов к событиям Adjust

При работе с SDK Adjust Mobile Measurement Partner (MMP) используйте функцию хэширования, как в примере ниже, так как данные не хэшируются автоматически. Если вы не используете функцию хэширования, наш API вызовет исключение и не примет простой текст.

Добавьте параметры данных клиентов, которые должны передаваться партнерам, активированным на панели Adjust. Для этого вызовите метод addPartnerParameter для экземпляра ADJEvent.

Обратите внимание: Facebook SDK в этом случае не требуется.

Пример кода для Android

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

Пример кода для iOS

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

Для получения дополнительных сведений см. примеры кода на Github.

Сопоставление параметров Adjust с параметрами Facebook

Чтобы сопоставить параметр Adjust с параметром Facebook на панели Adjust, выполните указанные ниже действия.

1. На панели Adjust выберите Settings (Настройки) для приложения, с которым нужно сопоставить параметры партнера.
2. Выберите Partner Setup (Настройка партнера).
3. Выберите нужного партнера.
4. Выберите Partner Parameter Mapping (Сопоставление параметров партнера).
5. В столбце FROM APP (Из приложения) слева введите имена параметров, которые SDK передает в Adjust. Они должны быть одинаковыми для всех партнеров. Например, если в Adjust SDK параметр называется email, введите "email".
6. Справа в столбце TO PARTNER (Для партнера) введите имена параметров в том виде, в котором их должен получать партнер. Они могут быть разными для разных партнеров. Параметр, используемый в Facebook SDK, должен иметь формат ud[pii_type_name]. Например, параметр email должен называться ud[em], а параметр phone — ud[ph].

Подробные сведения см. в документации по Adjust.