Кратко: Настройте облачные сервисы, чтобы подключить исходные данные к DCP и экспортировать аудитории в бакеты облачного хранилища.
О настройке облачных сервисов
DCP использует два типа подключений для передачи данных между вашими облачными сервисами и платформой:
- Подключения к источникам: позволяют подключать данные из ваших собственных источников к DCP для совместной работы и создания аудиторий.
- Подключения к облачному хранилищу: позволяют экспортировать ваши аудитории в бакеты облачного хранилища после каждого обновления аудитории.
Настройка подключения — это двухэтапный процесс:
- Шаг 1: Используйте интерфейс облачного сервиса, чтобы подготовить его к использованию с DCP.
- Шаг 2: Подключите его к DCP на платформе AppsFlyer. См. Платформа для совместной работы с данными (DCP) – добавление подключений.
В таблице ниже показано, какие сервисы поддерживаются для каждого типа подключения:
| Облачный сервис | Источник (входящий) | Облачное хранилище (исходящее) |
|---|---|---|
| Amazon S3 | ✓ | ✓ |
| Google Cloud Storage | ✓ | ✓ |
| BigQuery | ✓ | - |
| Snowflake | ✓ | - |
| Salesforce Cloud/CRM | ✓ | - |
Для Amazon S3 и GCS одни и те же настройки бакета и разрешения применяются как к подключениям к источникам, так и к подключениям к облачному хранилищу, поэтому отдельная настройка для каждого направления не требуется. При создании подключения к источнику автоматически создается соответствующее подключение к облачному хранилищу (и наоборот), а при удалении одного удаляется и другое, поскольку фактически это одно базовое подключение, общее для обеих вкладок.
Настройте свои облачные сервисы
Ниже выберите облачный сервис, чтобы просмотреть инструкции по настройке.
Amazon S3
Следующие инструкции помогут подготовить бакет Amazon S3 к использованию с DCP.
Примечание
Описанная ниже процедура должна быть выполнена вашим администратором AWS.
Чтобы создать бакет:
- Войдите в консоль AWS.
- Откройте сервис S3.
- Создайте корзину:
- Нажмите Create bucket (Создать корзину).
-
Заполните поле Bucket name, указав имя бакета, начинающееся с
af-dcr-и продолжите своим текстом в соответствии с требованиями к именованию DCR.
- Нажмите Create bucket (Создать корзину).
Чтобы предоставить AppsFlyer права доступа к корзине:
- Выберите созданную вами корзину.
- Перейдите на вкладку Permissions (Разрешения).
- В разделе Bucket policy нажмите Edit. Откроется окно Edit bucket policy.
-
Вставьте в это окно следующий фрагмент кода:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AF-DCR-DL", "Effect": "Allow", "Principal": { "AWS": [ "arn:aws:iam::195229424603:user/product=dcr-reporter__envtype=prod__ns=default", "arn:aws:iam::195229424603:user/product=datalocker__envtype=prod__ns=default" ] }, "Action": [ "s3:GetObject", "s3:ListBucket", "s3:DeleteObject", "s3:PutObject" ], "Resource": [ "arn:aws:s3:::af-dcr-mybucket", "arn:aws:s3:::af-dcr-mybucket/*" ] } ] } - Во фрагменте кода замените
af-dcr-mybucket(в двух строках, где оно встречается) именем созданного вами бакета. - Примечание
Двоеточие (:)
При замене имени бакета во фрагменте кода не удаляйте /* во второй строке, где встречается имя бакета.
Google Cloud Storage
Используйте следующие инструкции, чтобы подготовить бакет GCS для использования с DCP.
Вкладка «Разрешения»
Описанная ниже процедура должна быть выполнена вашим администратором Google Cloud.
Чтобы создать бакет:
- Войдите в консоль GCS.
- Перейдите на страницу Cloud Storage Browser.
- Создайте корзину:
- Нажмите Create bucket (Создать корзину).
-
Введите информацию о бакете на странице Create a bucket. Укажите имя бакета, начинающееся с
af-dcr-и продолжите своим текстом в соответствии с требованиями к именованию DCR.
- Нажмите Продолжить.
- Нажмите Создать.
Чтобы предоставить AppsFlyer права доступа к корзине:
- Выберите созданную вами корзину.
- Перейдите на вкладку Permissions (Разрешения).
- В разделе Permissions нажмите + Add. Откроется окно Add members.
- В поле New members введите следующие учетные записи:
appsflyer-dcr@dcr-report.iam.gserviceaccount.comaf-data-delivery@af-raw-data.iam.gserviceaccount.com
- В списке Role выберите Cloud storage > Storage Admin.
- Нажмите Save (Сохранить).
BigQuery
BigQuery поддерживает только подключения к источникам данных. Используйте следующие инструкции, чтобы создать набор данных и предоставить AppsFlyer разрешения.
Вкладка «Разрешения»
Описанная ниже процедура должна быть выполнена вашим администратором Google Cloud.
Чтобы создать набор данных:
- Войдите в консоль Google Cloud Console.
- Перейдите на страницу BigQuery.
- В новом или существующем проекте Google Cloud создайте набор данных для исключительного использования DCP:
- На панели слева кликните значок меню с тремя точками (View actions) справа от идентификатора ID проекта.
-
Выберите Создать набор данных.
- В открывшейся панели справа введите название набора данных и выберите другие необходимые параметры.
- Можно использовать любое название: только буквы, цифры и знаки подчёркивания.
- Рекомендация: используйте название, указывающее на то, что набор данных используется для подключения к источнику.
- Не используйте параметр Enable table expiration, так как после истечения срока действия таблиц DCP не сможет прочитать ваши данные.
- Можно использовать любое название: только буквы, цифры и знаки подчёркивания.
- Нажмите кнопку Создать набор данных.
Чтобы предоставить AppsFlyer права доступа к набору данных:
- На панели слева нажмите значок меню с тремя точками (View actions) справа от созданного набора данных.
- Выберите Поделиться.
- В открывшейся панели справа нажмите Add principal.
- В разделе Add principals введите следующий аккаунт в поле New principals:
appsflyer-dcr@dcr-report.iam.gserviceaccount.com
-
В разделе Assign roles выберите BigQuery > BigQuery Data Viewer.
- Нажмите Save (Сохранить).
- Нажмите Close, чтобы закрыть правую боковую панель.
Snowflake
Snowflake поддерживает только подключения к источникам. Воспользуйтесь следующими инструкциями, чтобы создать приватный общий доступ для использования DCP.
Вкладка «Разрешения»
Следующая процедура должна выполняться администратором аккаунта Snowflake Accountadmin.
Чтобы создать приватный общий доступ:
- Войдите в аккаунт Snowflake, содержащий данные, которыми вы хотите поделиться с DCP.
- Смените роль на Account admin.
- На панели слева выберите Private Sharing.
-
На открывшейся странице выберите вкладку Shared By Your Account.
- Кликните Поделиться. В открывшемся списке выберите Create a Direct Share.
- Выберите таблицы и/или представления, которыми вы хотите поделиться с DCP, затем нажмите Done.
- Измените Secure Share Identifier и при необходимости добавьте дополнительное описание.
-
В поле Add accounts in your region by name введите аккаунт AppsFlyer Snowflake для вашего региона:
Доход от рекламы Аккаунт AppsFlyer ЕС Запад (eu-west-1) QL63117 США Восток – Сев. Вирджиния (us-east-1) MWB70410 США Восток – Огайо (us-east-2) BM15378 - Кликните Create Share.
Salesforce Cloud/CRM
Salesforce Cloud/CRM поддерживает только подключения к источникам. Инструкции по настройке см. в статье DCP - Интеграция с Salesforce Data Cloud.
Спецификации и ограничения
| Специфика | Описание |
|---|---|
| Поддерживаемые облачные сервисы | Amazon S3 и GCS поддерживают подключения как к источникам, так и к облачным хранилищам. BigQuery, Snowflake и Salesforce Cloud/CRM поддерживают только подключения к источникам. |
| Использование бакета | Бакеты S3 и GCS должны использоваться исключительно для DCP. Никакой другой сервис не может записывать данные в бакет. |
| Требования DCR к именам |
В отношении всех объектов данных DCR, включая бакеты, папки и файлы, действуют следующие требования к именованию:
|
| Именование бакетов |
Имена бакетов должны начинаться с |
См. также