Чем мы можем помочь?

Интеграция Salesforce Marketing Cloud (SFMC) с AppsFlyer

  • Обновлено

Интегрируйте 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, выполните следующие действия:

  1. Войдите в свой аккаунт SFMC и перейдите к представлению Email Studio
  2. Перейдите на вкладку Администратор.
  3. В боковом меню нажмите на диплинкинг. В этом представлении вы можете настроить новую интеграцию диплинков со своим приложением или изменить существующие.

    [НЕОБХОДИМ АЛЬТЕРНАТИВНЫЙ ТЕКСТ: опишите экран настройки диплинкинга SFMC]
  4. Чтобы создать новую конфигурацию, нажмите кнопку Создать и введите свой AppID. Значение AppID представляет собой комбинацию идентификатора вашей команды разработчиков Apple и идентификатора пакета. Оба эти значения можно получить из вашего аккаунта Apple Developer.

     Пример

    Если префикс идентификатора команды 5UABCDFGH и идентификатор пакета com.your.app, необходимо ввести следующее значение:
    5uabcdfgh.com.your.app

    [НЕОБХОДИМ АЛЬТЕРНАТИВНЫЙ ТЕКСТ: опишите показанный здесь экран настройки диплинкинга SFMC]
  5. Настройка универсальных ссылок и диплинкинга будет завершена после того, как SFMC создаст файл Apple App Site Association (AASA). Этот процесс может занять несколько часов. Сгенерированный файл можно увидеть по следующему URL-адресу:

    https://<click_recording_link_domain>/apple-app-site-association
Шаг 4: Настройте свой SDK AppsFlyer

Примечание

Если вы этого еще не сделали, обязательно настройте приложение на поддержку диплинкинга с OneLink.

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

  1. Свяжите домен регистрации кликов в Xcode:

    [НЕОБХОДИМ АЛЬТЕРНАТИВНЫЙ ТЕКСТ: опишите экран связанных доменов в Xcode]
  2. Предоставьте домен регистрации кликов в 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"]
  3. Когда приложение вызывается кликом по универсальной ссылке, AppsFlyer SDK разрешает диплинк и извлекает ссылку OneLink. Затем все параметры диплинка передаются в API onAppOpenAttribution для выполнения логики диплинка.

Отправка электронных писем со стандартным диплинкингом email в SFMC

Чтобы отправлять электронные письма со стандартным диплинкингом email в SFMC:

  1. Создайте ссылку OneLink вручную или на странице ссылок OneLink на дэшборде AppsFlyer.
  2. При создании OneLink кодируйте все значения параметров в формате URL. Настоятельно рекомендуется использовать следующие параметры:
Параметр Описание Примечания
pid Подписка IAP Репрезентативный медиа-источник
c Доступно только в расширенных отчётах. Кампания, которой будет присвоена атрибуция
af_dp URL-адрес диплинка Адрес перенаправления пользователей по диплинку
af_web_dp. Перенаправление на настольную версию Перенаправление для пользователей настольных компьютеров
af_ios_url;   Перенаправление для пользователей iOS, у которых не установлено приложение
af_android_url;   Перенаправление для пользователей Android, у которых не установлено приложение
  1. Скопируйте ссылку в письмо, которое вы создаете в 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
  1. Попросите вашего CSM или отправьте электронное письмо на hello@appsflyer.com, чтобы включить установку приложения в SFMC AppExchange.
  2. В Salesforce перейдите по ссылке AppExchange, которой с вами поделится ваш CSM после включения приложения.
  3. Нажмите Install.
  4. Предоставьте разрешения: попросите администратора Salesforce Marketing Cloud предоставить доступ к приложению отдельным пользователям или бизнес-юнитам. Возможно, потребуется выполнить hard refresh, чтобы увидеть новые разрешения.
  5. Предоставьте пользователям доступ к приложению AppsFlyer OneLink: перейдите в Apps > Installed Packages, откройте вкладку ACCESS, выберите пользователей, которым нужно разрешить использовать OneLink, и нажмите Save. Опять же, может потребоваться hard refresh.
Шаг 2: Выполните базовую настройку
Шаг 3: Создайте ссылки OneLink в Salesforce с помощью приложения AppsFlyer OneLink

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

[НУЖЕН АЛЬТЕРНАТИВНЫЙ ТЕКСТ: сейчас используется имя файла SFMC-AF-app1-en_us.png; опишите показанный экран приложения OneLink]

Чтобы создать ссылку OneLink:

  1. В Salesforce откройте приложение AppsFlyer OneLink.
  2. Нажмите Add OneLink.
  3. Введите имя в поле Link name. Учтите:
    • Выберите понятное и легко узнаваемое имя.
    • Имя ссылки будет использоваться при применении OneLink к email-кампаниям.
  4. В поле Base URL введите URL-адрес OneLink в длинном формате, скопированный со страницы AppsFlyer OneLink custom links.
  5. [Необязательно] Чтобы добавить дополнительные параметры, нажмите Добавить параметр. См. список рекомендуемых параметров.
  6. [Необязательно] Чтобы задать внутренний макрос Salesforce Marketing Cloud, нажмите значок справа от параметра.
    • Для каждого параметра OneLink рекомендуется задать Subscriber key.
    • Это позволит связать атрибутированные конверсии из email с вашими данными Salesforce.
  7. Нажмите Создать ссылку.
Шаг 4. Отправка электронных писем с пользовательскими ссылками атрибуции
  1. В Salesforce Email Studio создайте новый шаблон или электронное письмо.
  2. Нажмите Редактировать, перейдите на вкладку Контент, затем выберите Блоки.
  3. Прокрутите вниз и найдите AppsFlyer Button CB или AppsFlyer Image CB.

    [НЕОБХОДИМ АЛЬТЕРНАТИВНЫЙ ТЕКСТ: текущее имя файла sf_email_edit_onelink_new.PNG; опишите показанную панель Content Blocks]
  4. Перетащите изображение/кнопку в тело электронного письма.
  5. Нажмите на изображение/кнопку, чтобы отредактировать.
  6. В поле Заголовок укажите название изображения/кнопки.
  7. Выберите ссылку OneLink.

    [НЕОБХОДИМ АЛЬТЕРНАТИВНЫЙ ТЕКСТ: опишите показанный селектор ссылок OneLink]
  8. Сохраните электронное письмо и отправьте его.

 Пример

Для удобства чтения параметры 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: Протестируйте ссылки

Чтобы протестировать ссылки атрибуции:

  1. Создайте соответствующий URL-адрес OneLink.
  2. Поместите его в электронное письмо.
  3. Отправьте электронное письмо себе.
  4. Нажмите ссылку.
  • Если приложение установлено на вашем устройстве, оно должно быть вызвано.
  • Если реализованы соответствующие 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
  1. В AppsFlyer перейдите в Collaborate > Active Integrations и найдите Salesforce Marketing Cloud.
  2. Выберите приложение, которое хотите настроить, и нажмите Set up integration.
  3. На вкладке Integration убедитесь, что переключатель Activate partner включен.
  4. Прокрутите до раздела In-app event postbacks и включите переключатель.
  5. Нажмите Add event и сопоставьте события AppsFlyer, которые хотите отправлять в SFMC. Для каждого события выберите его из списка событий вашего приложения и задайте условие отправки: This partner only (отправляются только события, атрибутированные трафику SFMC) или All media sources, including organic (рекомендуется для создания аудиторий, так как отправляется каждое срабатывание события независимо от атрибуции).
  6. Нажмите Сохранить интеграцию.

В списке событий отображаются только события, которые AppsFlyer уже получил через ваш SDK или S2S-интеграцию. Если событие отсутствует, сначала проверьте реализацию SDK.

Шаг 2. Проверьте Data Extension в SFMC

После отправки первого постбэка AppsFlyer автоматически создает Data Extension в вашей учетной записи SFMC с именем Installs-{mid} или Events-{mid}. Для проверки:

  1. В SFMC перейдите в Email Studio > Data Extensions.
  2. Найдите Data Extension вашего приложения.
  3. Убедитесь, что строки заполняются данными о событиях. В каждой строке должны быть идентификатор контакта, название события, временная метка события и параметры события.

Если Data Extension не был создан автоматически, убедитесь, что приложение-коннектор SFMC установлено правильно и что администратор SFMC предоставил ему необходимые разрешения на запись данных.

Шаг 3. Используйте данные о событиях в Journey Builder
  1. В SFMC откройте Journey Builder и создайте или измените путь.
  2. Укажите Data Extension в качестве источника входа и выберите AppsFlyer Data Extension для вашего приложения.
  3. Настройте критерии входа, например контакты, у которых event_name равно af_purchase.
  4. Создайте нужные шаги пути (отправка email, ожидание, ветвление по значению события и т. д.).
  5. Активируйте путь.

Используйте параметр 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, чтобы убедиться, что коннектор правильно настроен для вашего аккаунта.