Интегрируйте AppsFlyer с Salesforce Marketing Cloud (SFMC), чтобы с помощью диплинкинга направлять пользователей из email-кампаний к контенту в приложении. Синхронизируйте данные о событиях в приложении с SFMC, чтобы создавать аудитории и запускать пути на основе реального поведения в приложении.
Об интеграции
SFMC позволяет повторно вовлекать существующих пользователей через email-кампании, направляя их с помощью диплинков к определенному контенту в приложении, например к промоакции или персонализированному предложению.
Есть два варианта интеграции:
- Стандартный email-диплинкинг в SFMC: создайте в AppsFlyer ссылки OneLink для кампании, а затем добавьте их в электронные письма.
- Расширенная интеграция AppExchange с SFMC: создавайте ссылки OneLink для кампаний прямо в Salesforce и автоматически импортируйте данные о событиях в приложении, чтобы формировать аудитории для повторного вовлечения. Это премиум-функция.
Сравнение: Standard vs. Advanced
| Возможность | Стандартный email-диплинкинг в SFMC | Расширенная интеграция AppExchange с SFMC |
|---|---|---|
| Отложенные диплинки | Да | Да |
| Прямые диплинки | Да | Да |
| Измерение диплинков | Да | Да |
| Создание ссылок | В AppsFlyer | В специальном приложении Salesforce |
| Постбэки SFMC (синхронизация событий в приложении) | Ни один | Да |
Предварительные требования
https://support.appsflyer.com/hc/article_attachments/360016192917
- SDK AppsFlyer для iOS версии 4.9.0+
- Для универсальных ссылок iOS в вашей среде SFMC выполните следующие действия: приобретите и внедрите Sender Authentication Package (SAP), а также приобретите сертификат SSL (конфигурация SSL) и отправьте форму запроса SSL. Чтобы получить оба варианта, обратитесь к представителю Salesforce по вашему аккаунту или отправьте кейс в поддержку по доставляемости через Salesforce Help.
Android;
- SDK AppsFlyer для Android версии 4.9.0+
- SFMC не поддерживает Android App Links, поэтому вместо них используется диплинкинг по схеме URI. Никаких специальных действий для поддержки диплинкинга в приложениях Android из SFMC не требуется.
Настройка стандартных диплинков для электронных писем SFMC
См. инструкции по настройке интеграции:
Шаг 1: Настройте свой домен для записи кликов в SFMC
Чтобы настроить домен для записи кликов, следуйте официальным руководствам SFMC:
Шаг 2: Загрузите свой SSL-сертификат в SFMC
Чтобы универсальные ссылки iOS работали корректно, ваш домен для регистрации кликов должен включать SSL-сертификат вашего домена, который необходимо установить в вашем аккаунте SFMC. Инструкции по настройке SSL-сертификатов можно найти в официальном руководстве SFMC.
Шаг 3: Настройка диплинкинга в SFMC
Чтобы активировать перенаправление по диплинкам из электронных писем SFMC, выполните следующие действия:
- Войдите в свой аккаунт SFMC и перейдите к представлению Email Studio
- Перейдите на вкладку Администратор.
-
В боковом меню нажмите на диплинкинг. В этом представлении вы можете настроить новую интеграцию диплинков со своим приложением или изменить существующие.
-
Чтобы создать новую конфигурацию, нажмите кнопку Создать и введите свой AppID. Значение AppID представляет собой комбинацию идентификатора вашей команды разработчиков Apple и идентификатора пакета. Оба эти значения можно получить из вашего аккаунта Apple Developer.
Пример
Если префикс идентификатора команды 5UABCDFGH и идентификатор пакета com.your.app, необходимо ввести следующее значение:
5uabcdfgh.com.your.app -
Настройка универсальных ссылок и диплинкинга будет завершена после того, как SFMC создаст файл Apple App Site Association (AASA). Этот процесс может занять несколько часов. Сгенерированный файл можно увидеть по следующему URL-адресу:
https://<click_recording_link_domain>/apple-app-site-association
Шаг 4: Настройте свой SDK AppsFlyer
Примечание
Если вы этого еще не сделали, обязательно настройте приложение на поддержку диплинкинга с OneLink.
После настройки домена регистрации кликов для поддержки универсальных ссылок, как описано выше, вам необходимо настроить приложение на диплинкинг и разрешить универсальные ссылки.
-
Свяжите домен регистрации кликов в Xcode:
-
Предоставьте домен регистрации кликов в API SDK
setResolveDeepLinkURLs. Этот API необходимо вызывать до инициализации SDK. Дополнительные сведения см. в документации SDK по разрешению URL-адресов диплинков.AppsFlyerLib.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]-
Важно! Если вы используете Movable Ink (MI) вместе с Salesforce, вам необходимо получить MI CNAME и внутренние домены у своего менеджера по работе с клиентами MI и добавить их в
setResolveDeepLinkURLs, а также ссылку для кликов для Salesforce. Например:AppsFlyerLib.shared().resolveDeepLinkURLs = ["salesforce-click.example.com", "mi.example.com", "example.micpn.com"]
-
- Когда приложение вызывается кликом по универсальной ссылке, AppsFlyer SDK разрешает диплинк и извлекает ссылку OneLink. Затем все параметры диплинка передаются в API onAppOpenAttribution для выполнения логики диплинка.
Отправка электронных писем со стандартным диплинкингом email в SFMC
Чтобы отправлять электронные письма со стандартным диплинкингом email в SFMC:
- Создайте ссылку OneLink вручную или на странице ссылок OneLink на дэшборде AppsFlyer.
- При создании OneLink кодируйте все значения параметров в формате URL. Настоятельно рекомендуется использовать следующие параметры:
| Параметр | Описание | Примечания |
|---|---|---|
| pid | Подписка IAP | Репрезентативный медиа-источник |
| c | Доступно только в расширенных отчётах. | Кампания, которой будет присвоена атрибуция |
| af_dp | URL-адрес диплинка | Адрес перенаправления пользователей по диплинку |
| af_web_dp. | Перенаправление на настольную версию | Перенаправление для пользователей настольных компьютеров |
| af_ios_url; | Перенаправление для пользователей iOS, у которых не установлено приложение | |
| af_android_url; | Перенаправление для пользователей Android, у которых не установлено приложение |
- Скопируйте ссылку в письмо, которое вы создаете в Salesforce Email Studio. Salesforce Marketing Cloud оборачивает ссылку вашим доменом для регистрации кликов, поэтому любой клик по этому домену перенаправляет на вашу ссылку OneLink для атрибуции.
Пример (параметры URL-адреса показаны без кодирования для удобства чтения):
https://example.onelink.me/ABcd?pid=Email&c=Spring_Newsletter&af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/contentНастройка расширенной интеграции SFMC AppExchange
Чтобы настроить расширенную интеграцию SFMC AppExchange:
Шаг 1. Установите приложение OneLink из SFMC AppExchange
- Попросите вашего CSM или отправьте электронное письмо на hello@appsflyer.com, чтобы включить установку приложения в SFMC AppExchange.
- В Salesforce перейдите по ссылке AppExchange, которой с вами поделится ваш CSM после включения приложения.
- Нажмите Install.
- Предоставьте разрешения: попросите администратора Salesforce Marketing Cloud предоставить доступ к приложению отдельным пользователям или бизнес-юнитам. Возможно, потребуется выполнить hard refresh, чтобы увидеть новые разрешения.
- Предоставьте пользователям доступ к приложению AppsFlyer OneLink: перейдите в Apps > Installed Packages, откройте вкладку ACCESS, выберите пользователей, которым нужно разрешить использовать OneLink, и нажмите Save. Опять же, может потребоваться hard refresh.
Шаг 2: Выполните базовую настройку
Выполните шаги из раздела «Настройка стандартного диплинкинга для электронной почты SFMC» выше.
Шаг 3: Создайте ссылки OneLink в Salesforce с помощью приложения AppsFlyer OneLink
Создайте отдельную ссылку атрибуции для каждой кампании.
Чтобы создать ссылку OneLink:
- В Salesforce откройте приложение AppsFlyer OneLink.
- Нажмите Add OneLink.
- Введите имя в поле Link name. Учтите:
- Выберите понятное и легко узнаваемое имя.
- Имя ссылки будет использоваться при применении OneLink к email-кампаниям.
- В поле Base URL введите URL-адрес OneLink в длинном формате, скопированный со страницы AppsFlyer OneLink custom links.
- Используйте URL-адрес в длинном формате, чтобы приложение проанализировало и установило параметры ссылки.
- Узнайте, как скопировать URL-адрес существующей ссылки или создать новую ссылку OneLink.
- [Необязательно] Чтобы добавить дополнительные параметры, нажмите Добавить параметр. См. список рекомендуемых параметров.
- [Необязательно] Чтобы задать внутренний макрос Salesforce Marketing Cloud, нажмите значок справа от параметра.
- Для каждого параметра OneLink рекомендуется задать Subscriber key.
- Это позволит связать атрибутированные конверсии из email с вашими данными Salesforce.
- Нажмите Создать ссылку.
Шаг 4. Отправка электронных писем с пользовательскими ссылками атрибуции
- В Salesforce Email Studio создайте новый шаблон или электронное письмо.
- Нажмите Редактировать, перейдите на вкладку Контент, затем выберите Блоки.
-
Прокрутите вниз и найдите AppsFlyer Button CB или AppsFlyer Image CB.
- Перетащите изображение/кнопку в тело электронного письма.
- Нажмите на изображение/кнопку, чтобы отредактировать.
- В поле Заголовок укажите название изображения/кнопки.
-
Выберите ссылку OneLink.
- Сохраните электронное письмо и отправьте его.
Пример
Для удобства чтения параметры URL не закодированы в URL-адресе:
https://example.onelink.me/ABcd?pid=Email&c=Spring_Newsletter&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content
Шаг 5: Протестируйте ссылки
Чтобы протестировать ссылки атрибуции:
- Создайте соответствующий URL-адрес OneLink.
- Поместите его в электронное письмо.
- Отправьте электронное письмо себе.
- Нажмите ссылку.
- Если приложение установлено на вашем устройстве, оно должно быть вызвано.
- Если реализованы соответствующие API для диплинкинга в AppsFlyer SDK, то вы должны перейти по диплинку на соответствующий контент.
- Клик должен появиться на дэшборде AppsFlyer, атрибутированный к указанному медиа-источнику и кампании.
- Клик появляется в данных Salesforce.
Динамические письма
Если вам нужно динамически генерировать ссылки, чтобы отображать динамический контент для каждого пользователя, используйте API OneLink.
Для этого в Journey Builder SFMC используйте активность скрипта Automation Studio, которая перед отправкой вызывает API OneLink, записывает сгенерированную глубокую ссылку в поле Data Extension для отправки для каждого контакта, а затем письмо подставляет это поле через простой AMPscript lookup.
Расширенная синхронизация данных о событиях в приложении в SFMC
Эта функция позволяет AppsFlyer автоматически отправлять данные о событиях в приложении из вашего приложения в Salesforce Marketing Cloud, где они хранятся в отдельном Data Extension. Используйте эти данные, чтобы создавать аудитории, запускать пути и персонализировать кампании на основе реального поведения в приложении, например покупок, регистраций или прохождения уровней.
Это премиум-функция, доступная в рамках расширенной интеграции AppExchange для SFMC.
Принцип действия
Когда пользователь выполняет событие в приложении (например, завершает покупку), AppsFlyer отправляет постбэк в коннектор SFMC. Коннектор записывает данные о событии в Data Extension в вашей учетной записи SFMC, где каждая строка представляет одно событие для одного контакта. После этого используйте Journey Builder или Automation Studio в SFMC, чтобы запускать последующие коммуникации на основе этого события.
Чтобы настроить расширенную синхронизацию данных:
Шаг 1. Включите отправку постбэков в AppsFlyer
- В AppsFlyer перейдите в Collaborate > Active Integrations и найдите Salesforce Marketing Cloud.
- Выберите приложение, которое хотите настроить, и нажмите Set up integration.
- На вкладке Integration убедитесь, что переключатель Activate partner включен.
- Прокрутите до раздела In-app event postbacks и включите переключатель.
- Нажмите Add event и сопоставьте события AppsFlyer, которые хотите отправлять в SFMC. Для каждого события выберите его из списка событий вашего приложения и задайте условие отправки: This partner only (отправляются только события, атрибутированные трафику SFMC) или All media sources, including organic (рекомендуется для создания аудиторий, так как отправляется каждое срабатывание события независимо от атрибуции).
- Нажмите Сохранить интеграцию.
В списке событий отображаются только события, которые AppsFlyer уже получил через ваш SDK или S2S-интеграцию. Если событие отсутствует, сначала проверьте реализацию SDK.
Шаг 2. Проверьте Data Extension в SFMC
После отправки первого постбэка AppsFlyer автоматически создает Data Extension в вашей учетной записи SFMC с именем Installs-{mid} или Events-{mid}. Для проверки:
- В SFMC перейдите в Email Studio > Data Extensions.
- Найдите Data Extension вашего приложения.
- Убедитесь, что строки заполняются данными о событиях. В каждой строке должны быть идентификатор контакта, название события, временная метка события и параметры события.
Если Data Extension не был создан автоматически, убедитесь, что приложение-коннектор SFMC установлено правильно и что администратор SFMC предоставил ему необходимые разрешения на запись данных.
Шаг 3. Используйте данные о событиях в Journey Builder
- В SFMC откройте Journey Builder и создайте или измените путь.
- Укажите Data Extension в качестве источника входа и выберите AppsFlyer Data Extension для вашего приложения.
- Настройте критерии входа, например контакты, у которых event_name равно af_purchase.
- Создайте нужные шаги пути (отправка email, ожидание, ветвление по значению события и т. д.).
- Активируйте путь.
Используйте параметр af_sub1 в своих OneLink, чтобы передавать ключ подписчика SFMC в качестве идентификатора пользователя. Это позволяет сопоставлять постбэки с правильной записью контакта в Salesforce и использовать персонализацию на уровне контакта, а не только атрибуцию на уровне кампании.
Поля данных постбэка
Коннектор SFMC создает в вашей учетной записи два Data Extension: один для установок, другой — для событий в приложении. Все поля есть в схеме, но некоторые из них сейчас не заполняются. Поля с пометкой "not written" входят в схему, но всегда будут пустыми.
Поля данных
Поля Data Extension установок (49 полей)
| Поле | Записано | Примечания |
|---|---|---|
| Тип взаимодействия | Да | |
| Время касания | Да | |
| Название события | Да | |
| Источник события | Да | |
| Источник медиа | Да | |
| Доступно только в расширенных отчётах. | Да | |
| Доступно только в расширенных отчётах. | Да | |
| строка | Да | |
| Sub Param 1–5 | Да | Сопоставьте с ссылками af_sub1–af_sub5 в OneLink |
| Подписка IAP | Да | |
| Код страны | Да | |
| Ссылка | Да | |
| Доступно только в расширенных отчётах. | Да | |
| Почтовый индекс | Да | |
| Подтвержден ли чек | Да | |
| IP | Да | |
| AF ID | Да | Уникальный идентификатор устройства AppsFlyer |
| IDFV | Да | |
| Логическое значение | Да | |
| Категория устройства | Да | |
| Это ретаргетинг | Да | |
| Версия ОС | Да | |
| Версия приложения | Да | |
| Версия SDK | Да | |
| Строка | Да | |
| Имя приложения | Да | |
| Is Retargeting (Ретаргетинг) | Да | |
| Тип сопоставления | Да | |
| User Agent. | Да | |
| Время установки | Да | |
| Время события | Да | |
| Значение диплинк-ссылки | Да | |
| deep_link_sub1—deep_link_sub10 | Ни один | Есть в схеме, не записывается |
| IDFA | Ни один | Есть в схеме, не записывается (идентификатор устройства iOS) |
| ID рекламодателя | Ни один | Есть в схеме, не записывается (GAID Android) |
Поля расширения данных in-app событий
Все поля установок выше, а также:
| Поле | Записывается | Примечания |
|---|---|---|
| Is Primary Attribution (Основная атрибуция) | Ни один | Есть в схеме, не записывается |
| Окно повторного вовлечения | Ни один | Есть в схеме, не записывается |
| Значение события | Ни один | Есть в схеме, не записывается |
| Валюта выручки от события | Ни один | Есть в схеме, не записывается |
| Выручка от события в USD | Ни один | Есть в схеме, не записывается |
Устранение неполадок
- Нет данных в Data Extension: проверьте, что переключатель активации партнера и переключатель постбэков событий в приложении включены, а нужные вам события сопоставлены. Также убедитесь, что у приложения SFMC есть разрешения на запись данных в вашей учетной записи SFMC.
- События отображаются, но соответствующие контакты не найдены: убедитесь, что вы передаете af_sub1=%%subscriberkey%% в OneLink, чтобы постбэки могли сопоставляться с контактами SFMC.
- Data Extension не создано: обратитесь к своему CSM или в службу поддержки AppsFlyer, чтобы убедиться, что коннектор правильно настроен для вашего аккаунта.