Краткий обзор: Настройте подключения DCP, чтобы соединить источники данных, обогатить данные и экспортировать аудиторию в облачные хранилища и медиапартнерам.
О подключениях DCP
Подключения определяют, как DCP получает ваши данные и экспортирует вашу аудиторию. После настройки облачных сервисов подключите их к DCP с помощью окна Управление подключениями. Доступны следующие типы подключений:
- Подключения источников: для загрузки ваших собственных данных в DCP из облачного хранилища или хранилища данных.
- Подключения к облачному хранилищу: для экспорта ваших аудиторий в корзины Amazon S3 или Google Cloud Storage (GCS).
- Подключения медиапартнеров: для отправки ваших аудиторий рекламным платформам для активации.
- Подключения данных и идентификаторов: предназначены для объединения разрозненных пользовательских данных, чтобы повысить коэффициент совпадений и расширить аудитории на стороне партнеров.
DCP поддерживает разные облачные сервисы для разных направлений подключения. Используйте приведенную ниже таблицу, чтобы узнать, какие сервисы можно использовать для каждого типа подключения:
| Облачные сервисы | Источник (входящий) | Экспорт в облачное хранилище (исходящий трафик) |
|---|---|---|
| Amazon S3 | ✓ | ✓ |
| Google Cloud Storage | ✓ | ✓ |
| BigQuery | ✓ | - |
| Snowflake | ✓ | - |
| Salesforce Cloud/CRM | ✓ | - |
Для Amazon S3 и Google Cloud Storage одно соединение служит как источником (входящее сообщение), так и местом назначения экспорта в облачное хранилище (исходящее). При создании подключения источника к S3 или GCS автоматически создаётся соответствующее подключение для экспорта в облачное хранилище, и наоборот.
Создать подключение источников
Создавайте подключения источников для передачи собственных данных в DCP.
Чтобы создать подключение к источнику, выполните следующие действия:
- В AppsFlyer перейдите в раздел Сотрудничество > Данные Clean Room.
- Нажмите Управление подключениями в правом верхнем углу.
- Перейдите на вкладку «Источник» и нажмите + «Новое подключение».
- Продолжайте использовать приведенные ниже инструкции по подключению облачных сервисов для получения исходных данных.
Кроме того, подключение к источнику можно создать непосредственно при настройке источника. Инструкции см. в разделе Создание источников и управление ими.
Примечание
При создании входящего подключения Source к Amazon S3 или GCS автоматически создается соответствующее исходящее подключение к облачному хранилищу (и наоборот). При удалении подключения Amazon S3 или GCS второе подключение также удаляется автоматически. Поскольку на самом деле это одно базовое соединение, при удалении его с любой вкладки оно удаляется везде, где оно используется.
Подключения к облачным сервисам для исходных данных
Подключения источников предназначены для безопасного подключения источников ваших данных к DCP. В диалоговом окне «Новое подключение» выберите облачный сервис и заполните сведения о своем поставщике:
BigQuery: В диалоговом окне «Новое подключение» введите идентификатор проекта BigQuery для проекта, содержащего ваши исходные данные. Вы можете найти это на странице BigQuery в консоли Google Cloud.
Snowflake: В окне «Новое подключение» введите идентификатор учетной записи Snowflake и регион для учетной записи, содержащей ваши исходные данные. Чтобы найти это, нажмите на название учетной записи в левом нижнем углу консоли Snowflake:
ACCOUNTADMIN > Учетная запись > наведите курсор на соответствующую учетную запись > Скопировать идентификатор учетной записи. Подробности см. в документации Snowflake.
Важно!
Найдите идентификатор с меткой Locator. Это не тот идентификатор, который использовался для создания исходящих подключений Snowflake.
Amazon S3 и GCS В окне «Новое подключение» введите название корзины, созданной для эксклюзивного использования AppsFlyer Data Clean Room (DCR).
Облако Salesforce/CRM: Узнайте, как настроить подключение к Salesforce.
Подключение к локальным файлам
Подключения к локальной файловой системе позволяют загружать файлы данных прямо с компьютера в DCP. Этот вариант обычно используется только для тестирования и не рекомендуется для постоянного или крупномасштабного приема данных.
Настройте подключение к локальному файлу
Соединение с локальным файлом используется для тестирования платформы на примере файла-образца. Это позволяет вам ознакомиться с функциональностью DCP до начала обмена данными. Учтите, что оно не предназначено для совместного использования данных, имеет срок хранения 14 дней и не поддерживает автоматические процессы.
Подключение к локальным файлам можно настроить во время создания источника.
Создание подключений к облачному хранилищу
Подключения к облачному хранилищу позволяют автоматически экспортировать аудитории DCP в корзину Amazon S3 или Google Cloud Storage (GCS) после каждого обновления аудитории.
Чтобы создать подключение к облачному хранилищу:
- В AppsFlyer перейдите в раздел Сотрудничество > Данные Clean Room.
- Нажмите Управление подключениями в правом верхнем углу.
- Перейдите в Облачное хранилище и нажмите + Новое подключение.
- Откроется окно «Новое подключение к облачному хранилищу».
- В окне«Новое подключение к облачному хранилищу» выберите поставщика облачных услуг: Google Cloud Storage or Amazon Simple Storage.
- Введите название корзины
-
GCS: Введите название корзины GCS в формате.
gs://my-bucket -
S3: Введите название корзины S3.
-
GCS: Введите название корзины GCS в формате.
-
Нажмите «Проверить подключение», чтобы убедиться, что DCP может подключиться к вашей корзине.
- Нажмите Сохранить. Новое подключение появится в разделе Ваши подключения к облачному хранилищу на вкладке Облачное хранилище.
Вы также можете создать подключение к облачному хранилищу непосредственно в конструкторе аудиторий. Инструкции см. в разделе Создание и активация аудитории.
Понять путь экспорта
Каждый раз, когда аудитория экспортируется, DCP записывает ее в корзину, используя фиксированный и предсказуемый путь:
<bucket>/dcp-output/audiences/<collaboration-id>/t=<audience_name>_<id>/dt=<YYYY-MM-DD>/v=<version>/<file>.csvПример содержимого папки для одной поставки:
s3://af-dcr-example-bucket/dcp-output/audiences/8f3a1c02-44b1-4e9a-9c7d-2b6e1a0f5d3e/t=example_audience_6148a3/dt=2026-07-18/v=1/
├── part-00000-a1b2c3d4-e5f6-47a8-9b0c-1d2e3f4a5b6c-c000.csv
├── part-00001-a1b2c3d4-e5f6-47a8-9b0c-1d2e3f4a5b6c-c000.csv
└── _SUCCESS| Сегмент пути | Что это значит |
|---|---|
| <bucket> | Подключенная корзина S3 или GCS. |
| dcp-output/audiences/ | Исправлена папка, которую DCP автоматически создает для экспорта всех аудиторий. |
| <collaboration-id> | Уникальный идентификатор сотрудничества, к которому принадлежит эта аудитория. Вы можете найти его в URL-адресе сотрудничества в DCP. |
| t=<audience_name>_<id> | Название аудитории (пробелы и специальные символы заменены символами подчеркивания), а также уникальный идентификатор. Это гарантирует, что удаленная и воссозданная аудитория с тем же названием никогда не перезапишет старые файлы и не столкнется с ними. |
| dt=<YYYY-MM-DD> | Дата доставки. |
| v= <version> | Номер версии для экспорта этой аудитории. Она увеличивается с каждой новой поставкой. |
| part-NNNNN-<job-id>-c000.csv | Один из выходных файлов этой поставки – см. ниже раздел «Формат файла и разбиение». |
| _SUCCESS | Пустой маркерный файл, который создаётся после записи всех частей выгрузки. |
Примечание
Эта структура папок создается и управляется автоматически. Не переименовывайте и не меняйте структуру вручную — любой автоматический процесс, который читает эти файлы, должен быть настроен так, чтобы следовать этой структуре путей и ждать появления файла _SUCCESS перед обработкой файлов-частей, чтобы не обрабатывать неполную выгрузку.
Формат и разделение файлов
- Аудитории всегда экспортируются в виде CSV-файлов без сжатия с двумя столбцами:
value(идентификатор) иtaxonomy(тип идентификатора). - Большим аудиториям можно доставлять несколько файлов, а не один файл,
part-00000пронумерованный иpart-00001т. д. По умолчанию каждый файл содержит до 500 000 строк. - Один файл может содержать разные типы идентификаторов в одних и тех же строках – отфильтруйте нужные вам значения по
taxonomyстолбцу. Общие значения таксономии включаютcustomer_id,mobile_ad_idhashed_email, иhashed_phone_number_without_plus_sha256.
Пример:
value,taxonomy
6f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c,customer_id
1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d,mobile_ad_id
b7e2c9a1f4d6e8b0a2c4d6e8f0a1b3c5d7e9f1a3b5c7d9e0f2a4b6c8d0e2f4a6,hashed_email
c1d3e5f7a9b1c3d5e7f9a1b3c5d7e9f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9c1d3,hashed_phone_number_without_plus_sha256Создавайте подключения медиапартнеров
Исходящие подключения медиапартнеров позволяют безопасно подключать аудиторию DCP к поддерживаемым медиапартнерам и активировать персонализированные кампании на их платформах. Медиапартнеры — основное направление для активизации аудитории. Узнайте, как настроить подключения с конкретными медиапартнерами.
Чтобы создать связь с медиапартнером, выполните следующие действия:
- В AppsFlyer перейдите в раздел Сотрудничество > Данные Clean Room.
- Нажмите Управление подключениями в правом верхнем углу.
- Перейдите на вкладку Медиапартнеры и нажмите + Новое подключение. Если у вас уже есть подключения, вы увидите их в списке Медиапартнеры.
- В диалоговом окне «Новое подключение медиапартнёра» выберите нужного медиапартнера.
- Введите название подключения.
- Войдите в учетную запись медиапартнера со своими учетными данными и следуйте их инструкциям, чтобы открыть доступ AppsFlyer.
- Нажмите «Выбрать идентификатор учетной записи» и выберите соответствующую учетную запись для этого подключения.
- Нажмите Сохранить. Новое подключение добавлено в список партнеров.
Вы также можете установить подключение с медиапартнером непосредственно в конструкторе аудиторий. Инструкции см. в разделе Создание и активация аудитории.
Ваши подключения данных и идентификаторов
Подключения данных и идентификаторов объединяют фрагментированные пользовательские данные для повышения коэффициента сопоставления с партнерами по активации. Это позволяет расширить партнерскую аудиторию и повысить эффективность ваших кампаний.
ID5
Обогатите собственные данные идентификаторами ID5, чтобы объединить фрагментированные пользовательские данные, улучшить сопоставление и увеличить аудиторию партнеров.
This article was translated automatically and may contain errors. The English version is the most accurate - use the language selector below to switch.