Данные в источниках должны отвечать следующим требованиям:

• Дата (только): yyyy-mm-dd (например, 2023-04-18)
• Дата и время:
  • Формат: гггг-МММ-дд чч:мм:сс (например, 2023-APR-18 15:30:35)
  • Часовой пояс: UTC
• Числа: до 2 символов после десятичного разделителя
• Длина строки: до 256 символов
• Ограничение по количеству символов:
  • Для имен полей (заголовки столбцов): без пробелов или специальных символов
  • Все прочие данные: без ограничений (все символы действительны)

В дополнение к данным, предоставляемым для обработки, таблицы источника в BigQuery или Snowflake должны содержать 2 дополнительных столбца: один для даты и один для версии:

• Дата:
  • Заголовок столбца: dt
  • Тип столбца: дата
  • Формат даты: гггг-мм-дд (например, 2023-04-18)
  • Дополнительно: Таблицы BigQuery должны быть разграничены по этому столбцу.
• Версия:
  • Заголовок столбца: v
  • Тип столбца: строка
  • Формат данных: число (например, 1, 2, 3, 10).
  • Важно! Новая версия отчета запускается каждый раз, когда DCR обнаруживает новое значение в этой колонке. Чтобы обеспечить полноту отчета, обязательно заполняйте таблицу источника полным набором данных при каждом изменении значения столбца.

Исходные файлы, хранящиеся в Amazon S3 или GCS, должны соответствовать этим требованиям к именам и форматам файлов:

• Названия файлов должны соответствовать требованиям DCR к именам
• Формат CSV или GZIP.
  • Файл внутри архива GZIP должен иметь формат CSV.
• Количество файлов источника данных на папку с данными:
  • CSV: не более 1
  • GZIP: не более 1 цельного файла. Поддерживаются составные файлы GZIP со следующими именами: filename_part01.csv.gz, filename_part02.csv.gz и т. д.

1. В AppsFlyer, из бокового меню, выберите Сотрудничество > Data Clean Room.
    

   

2. Нажмите + Новый источник (на главной странице или на вкладке Источники).
    

   

3. Следуйте пошаговым инструкциям New source :

Введите название источника. Это может быть любое уникальное название, которое поможет вам идентифицировать источник. Вы также можете добавить описание источника (необязательно), чтобы было проще понять, что в нем содержится (например, «Все покупки за 2025 год»).

Требования и рекомендации

• Убедитесь, что название источника уникально среди всех остальных источников в вашем аккаунте. В противном случае вы не сможете сохранить источник.
• Оно не обязательно должно совпадать с именем файла.
• Требования к названию источника:
  • Длина: 2–80 символов.
  • Допустимые символы:
    • буквы (A–Z, a–z)
    • цифры (0-9), не могут быть первым символом имени;
    • Подчёркивание "_"
  • Недопустимые символы:
    • пробелы
    • все остальные символы или специальные символы

Чтобы указать расположение источника:

1. Выберите подключение, в котором будет создан (или уже создан) источник.
   • Если подключения в аккаунте не определены, откроется диалоговое окно Новое подключение с предложением создать подключение. Чтобы создать его, следуйте этим инструкциям.
   • Если у вас уже есть подключения, но вы хотите использовать новое, нажмите + New connection и следуйте этим инструкциям, чтобы создать его.
2. Продолжайте выполнять соответствующие инструкции ниже в зависимости от того, где находятся данные для вашего источника.

Примечание: Для наилучшей производительности при большом объеме данных часть ваших данных может храниться отдельно. Эти данные будут обновляться при каждом обновлении источника и удаляться при удалении источника.

Расположение источника в BigQuery

Чтобы завершить указание расположения источника для источника в BigQuery:

1. Выберите набор данных, в котором находится таблица источника.
2. Выберите таблицу, в которой находятся исходные данные.

Списки, из которых вы делаете эти выборы, содержат доступные наборы данных и таблицы, соответственно, в проекте BigQuery, который вы указали при создании подключения.

Расположение источника в Snowflake

Чтобы завершить указание расположения источника для источника в Snowflake:

1. Выберите ресурс, содержащий исходные данные.
2. Выберите схему, в которой находится исходная таблица.
3. Выберите таблицу, в которой находятся исходные данные.

Списки, из которых вы делаете эти выборы, содержат общие ресурсы, схемы и таблицы, соответственно, в аккаунте Snowflake, который вы указали при создании подключения.

Расположение источника в облачных корзинах

Расположение источника в Amazon S3 или GCS состоит из облачного бакета, указанного в подключении, и пути к папке, из которой DCR считывает исходный файл при каждом его обновлении. 

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

• Позволив AppsFlyer генерировать папки, можно упростить процесс. Однако вместо этого вы можете создать их вручную, следуя инструкциям, подробно описанным здесь.

Если AppsFlyer генерирует папки, единственная необходимая дополнительная информация — это имя, которое вы хотите дать папке источника. (Это папка верхнего уровня, в которой вы обновляете источник каждый раз, когда хотите использовать его для запуска новой версии отчета). Вы также можете указать, хотите ли вы, чтобы папка источника была создана под родительской папкой, часто называемой input.

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

• По умолчанию отображенное имя папки источника:
  • Основано на имени, которое вы присвоили источнику. Вы можете изменить название папки в соответствии со своими потребностями при условии, что оно соответствует требованиям DCR к именованию.
  • Указывает, что оно будет сгенерировано в родительской папке под именем input. Эта папка служит родительской папкой для всех источников, загруженных в DCR.
    • Папка входные данные не является обязательной, и вы можете удалить ее или назвать иначе, при условии что она соответствует требованиям к именованию DCR.
    • Хотя эта папка и не является обязательной, наличие папки input (или аналогичной папки с другим именем) считается правильным вариантом. Такой подход является еще более предпочтительным, если вы используете одну и ту же корзину и для загрузки файлов с данными (input), и для получения отчета (output).

Расположение источника: локальные файлы 

Вы также можете загрузить исходные данные из локального файла. Однако настоятельно рекомендуется указать облачный сервис в качестве расположения источника (это критически важно для больших наборов данных и автоматических обновлений). Локальный файл в основном используется для тестирования и ознакомления с функциями платформы. 

Чтобы загрузить исходные данные из локального файла: 

При выборе расположения источника нажмите Local file system, а затем Next — появится возможность загружать локальные файлы с вашего устройства. 

При настройке источника в Data Collaboration Platform (DCP) необходимо выбрать, как будут обрабатываться обновления этого источника. DCP поддерживает два метода синхронизации: Snapshot и Append. Каждый метод подходит для разных сценариев использования и потоков данных:

• Snapshot — при каждом обновлении источника этот метод загружает полный набор данных и полностью заменяет старый набор новым. Выбирайте этот метод только в том случае, если ваши загружаемые файлы всегда содержат полный и актуальный набор данных.
• Append — этот метод загружает только новые или измененные данные, а не полный набор данных. Старые наборы данных не удаляются и не обновляются. Идеально подходит для периодических загрузок, таких как ежедневные или еженедельные отчеты. Преимущества включают меньший объем загрузок (что может снизить стоимость облачного хранилища), более высокую скорость загрузки данных, более удобное управление записями и многое другое.

Требования к загрузке снимков

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

Поддерживаемые облачные сервисы

• Amazon S3
• Google Cloud Storage
• BigQuery
• Snowflake

Следуйте этим рекомендациям для метода обновления снимка:

1. Путь к исходной папке

   Когда вы регистрируете в DCP источник в облачном хранилище, для него задается корневой путь (например, input/my_source_folder/). При каждом обновлении набора данных вы загружаете в эту папку полный снимок — файл, содержащий все текущие строки. Это гарантирует, что DCP всегда обрабатывает самые актуальные и полные данные.

2. Загрузка файлов полного снимка

/v=1/data/

/v=1/

Структура папок:

s3://af-dcr-xyz/abcd9876/input/source_name1/dt=2025-mm-dd/v=1/data/\n└ бакет ┘ └ tenant ┘ └ ingestion ┘ └ источник ┘└ дата снимка ┘└ ver ┘└ files ┘

Пример структуры снимков за два дня:

source_name1/
  dt=2025-08-10/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS
  dt=2025-08-11/
    v=1/
      data/
        snapshot.parquet
      _SUCCESS

Ниже показано, как должна выглядеть структура папок после загрузки полного снимка файлов источника за 2 дня (а также программного создания папок даты/версии/данных и файлов _SUCCESS): структура вашего бакета/папок может выглядеть примерно так:
 

Требования к загрузке методом append

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

Зачем использовать Append?

• Эффективность – загрузки меньшего объема
• Целостность данных – сохраняет полную историю изменений для анализа временных рядов
• Соблюдение правовых норм в области конфиденциальности – упрощает удаление записей & управление согласиями

Поддерживаемые облачные сервисы: AWS S3 и Google Cloud Storage (GCS)
Примечание: BigQuery и Snowflake не поддерживаются для метода Append и требуют использования метода Snapshot.

Следуйте этим рекомендациям для метода обновления Append:

1. Настройка папки источника

2. Загрузка файлов добавления (дельта-файлов) 

Структура папок:

s3://af-dcr-xyz/abcd1234/input/source_name/dt=2025-08-10/\n└ бакет ┘ └ тенант ┘ └ входные данные ┘ └ источник ┘ └ дневной раздел ┘

Пример структуры папок для еженедельной дельты:

source_name/\n  dt=2025-08-04/\n  dt=2025-08-05/\n  dt=2025-08-06/\n  dt=2025-08-07/\n  dt=2025-08-08/\n  dt=2025-08-09/\n  dt=2025-08-10/

Краткая памятка:

Ключевые выводы: Даже при еженедельной загрузке всегда организуйте данные по дневным папкам dt=YYYY‑MM‑DD.

Сопоставьте поля источника с полями DCP, протестируйте и сохраните настроенные данные:

1. Загрузите поля источника
2. Настройте поля источника
3. Проверьте включение пользователей из ЕС
4. Протестируйте данные источника
5. Сохранение источника

1. Загрузите поля источника

Поля источника загружаются автоматически. Если требуется загрузка вручную, следуйте инструкциям ниже в зависимости от расположения источника:

Источники в локальном хранилище данных

Чтобы загрузить поля из источника, расположенного в хранилище данных (BigQuery или Snowflake), нажмите Загрузить поля из источника.

Источники в облачных корзинах

Чтобы загрузить поля из источника, расположенного в облачном хранилище (Amazon S3 или GCS), необходимо загрузить файл прототипа источника.

Для сопоставления полей источника с полями DCP: 

• Можно загрузить макетную версию источника из локального файла.
  • Если вы выбираете эту опцию, AppsFlyer всегда автоматически использует путь папки источника.

                                                                ВСЕ ЗАГЛАВНЫЕ

• Вы можете загрузить прототипную версию файла источника напрямую из подключенного облачного бакета.
  •  Важно!
    • Разрешите AppsFlyer автоматически создать облачную папку для файла источника или
    • Создайте облачную папку для файла источника вручную

Чтобы загрузить макетный файл источника, следуйте инструкциям в соответствующей вкладке ниже:

2. Настройте поля источника

После загрузки полей источника каждому полю источника (столбцу) сопоставляется поле DCP. Проверьте каждое поле источника и сопоставьте его с соответствующим полем DCP из раскрывающегося списка рядом с ним. Обратите внимание на следующее:

Определение типа поля с помощью ИИ

DCP может с помощью ИИ предложить поле DCP для каждого столбца источника на основе имени столбца.

Чтобы включить определение с помощью ИИ:

1. В разделе Сопоставление полей источника найдите баннер: «Нужна помощь, чтобы быстро сопоставить поля? Активировать ИИ-помощник DCP.» Кликните Активировать ИИ-помощник DCP.
2. Когда поля загрузятся, нажмите Автоматически определить типы полей. DCP анализирует имя каждого столбца и предлагает для него поле DCP.
3. Перед сохранением проверьте каждую рекомендацию. Вы можете принять рекомендацию как есть или вручную изменить сопоставление, как при редактировании любого другого поля.

Каждое поле получает один из следующих статусов:

• Сопоставлено: AI нашел одно точное совпадение. Проверьте его и примите или измените вручную.
• Не удалось сопоставить: AI не смог определить поле. Сопоставьте его вручную или оставьте без сопоставления.

Характеристики и ограничения

• Лимит столбцов: обнаружение AI поддерживается для не более чем 100 столбцов на источник. Для источников с большим числом столбцов отображается сообщение «лимит превышен».
• Длина имени поля: для обнаружения AI не поддерживаются имена столбцов длиной более 100 символов.

Как удалить поле:

• Наведите указатель на правую сторону поля, которое хотите удалить, и нажмите значок корзины, который появляется при наведении.

Чтобы добавить поля вручную:

Эта опция позволяет включить в аудиторию поле, которого сейчас нет в источнике.

1. Нажмите + New field. Добавляется пустое поле.
2. Введите имя поля и выберите его тип.
    

Типы полей включают: 

• Авторизовано
  • Время совершения события, полученное из первой вспомогательной атрибуции.
  • Идентификатор AppsFlyer
  • CUID
  • Электронная почта
  • Хешированный адрес электронной почты
  • Хешированный адрес электронной почты (без точек)
  • IDFA
  • IP-адреса
  • ID5 Id
  • Идентификатор MediaMath
  • ID мобильной рекламы
  • Номер телефона
  • Хешированный номер телефона (без плюса)
  • ID платформы
  • ID, хешированный с помощью SHA256
  • SHA256 номер телефона
  • Почтовый индекс ZIP+5
  • Почтовый индекс ZIP+4
  • LUID
  • ID человека
• Список идентификаторов
  • Хешированные адреса электронной почты (без точек)
  • Хешированные номера телефонов (без плюса)
  • Хешированный адрес эл.почты
  • Хешированный телефон
  • Эл.почта
  • Номера телефонов
  • Идентификаторы ID5
  • Идентификаторы MediaMath
  • ID мобильной рекламы
  • IDFA
  • Идентификаторы Android
  • IP-адреса
• Булево значение
• Дата и время:
  • Дата и время
  • дата;
• ДМА
  • Персонализация рекламы активирована
  • Данные пользователя, взаимодействующего с рекламой, активированы
  • Применяется ЕС DMA
• Число
  • Двойной
  • Список номеров
  • Необработанные данные о согласии
  • Число
• текст.
  • текст.
  • ID приложения
  • Список текстовых значений

Идентификатор vs. список идентификаторов:

Типы идентификаторов содержат одно значение в каждой строке (например, один адрес электронной почты или один CUID в строке). Типы «Список идентификаторов» содержат массив значений в каждой строке (например, одна строка может содержать несколько хешированных адресов электронной почты или идентификаторов устройств) — используйте этот тип, если источнику нужно сопоставлять более одного идентификатора на запись.

Перезагрузить поля источника

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

Чтобы перезагрузить обновленные поля из файла:

1. Нажмите Reload fields.
2. Выберите расположение файла.
   • Для локального файла: загрузите файл.
   • Для файла из вашего облачного сервиса: нажмите Load from cloud bucket и следуйте инструкциям.
3. Нажмите OK. Обновленные файлы теперь отображаются. 

3. Проверьте включение пользователей из ЕС

• Выберите Yes или No в ответ на вопрос: Содержит ли ваш источник европейских пользователей, на которых распространяются правила DMA ЕС?

Узнать больше о правилах конфиденциальности в рамках Закона ЕС о цифровых рынках.

4. Тестирование данных источника

• [Необязательно] Нажмите Test, чтобы проверить наличие ошибок в формате или валидности полей источника.

5. Сохранение источника

• Нажмите Save (Сохранить), чтобы сохранить источник.

После подтверждения новый источник добавляется на вкладку Sources.

1. Перейдите на вкладку Sources в Data Clean Room.
2. В списке источников наведите указатель на источник, который нужно отредактировать, и нажмите значок редактирования в конце строки.
3. На странице редактирования источника измените соответствующие поля, как описано ниже.
4. Нажмите кнопку Сохранить.

Изменение имени источника

При изменении названия источника соблюдайте эти требования к именованию.

 Редактирование расположения источника

1. На странице редактирования источника > Расположение источника выберите другое подключение к данным.
2. Выберите соответствующие сведения о расположении.
3. [Необязательно] Проверить источник.
4. Нажмите кнопку Сохранить.

Изменение сопоставления полей

1. Перейдите к сопоставлению полей и внесите необходимые изменения: измените поле или обновите сопоставленное с ним поле DCP.
2. Нажмите Save (Сохранить).

Вы можете удалить любой источник, если только он не используется в аудитории. В этом случае в уведомлении будут указаны аудитории, использующие этот источник. Чтобы удалить источник, сначала необходимо удалить связанную с ним аудиторию. Что касается источников, к которым вам предоставили доступ, их может удалить только владелец источника.

1. Перейдите на вкладку Sources (Источники) в Data Clean Room.
2. В списке источников наведите курсор на строку с источником, который вы хотите удалить.
3. Нажмите значок удаления справа от строки.
4. В диалоговом окне нажмите Удалить для подтверждения.

В целом, проще всего позволить AppsFlyer автоматически генерировать необходимую структуру папок в процессе создания источника. Однако если вы хотите создать эти папки вручную, вы можете сделать это следующим образом.

Создайте папку для ключа DCR

Чтобы обеспечить максимальный уровень безопасности, имя папки, расположенной непосредственно в корзине («папка ключа DCR») должно содержать 8-значный буквенно-цифровой ключ DCR, присвоенный вашему аккаунту (например, 01bcc5fb). Обратите внимание, что он отличается от любого другого пароля или ключа, связанного с вашим аккаунтом AppsFlyer.

Папка с ключом DCR обычно создается вручную через интерфейс выбранного вами облачного сервиса.

Чтобы получить ключ DCR для своего аккаунта:

• Нажмите меню с 3 точками (действия) в правом верхнем углу и выберите DCR key.

После создания папки с ключом DCR, структура корзины и папок будет выглядеть следующим образом:

Папка верхнего уровня для входных данных

Хотя это не обязательно, рекомендуется создать папку верхнего уровня для входных данных непосредственно в папке с ключом DCR. Эта папка предназначена только для файлов, которые вы загружаете в DCR.

Папка верхнего уровня для входных данных обычно создается вручную через интерфейс выбранного вами облачного сервиса.

• Такой подход является еще более предпочтительным, если вы используете одну корзину и для загрузки файлов с данными (входные данные), и для получения отчета (вывод).
• Этой папке можно присвоить любое имя, соответствующее требованиям DCR к именам. Для удобства ее обычно называют input/.

После создания папки верхнего уровня для входных данных структура корзины и папок будет выглядеть следующим образом:

Папка второго уровня по каждому источнику данных

Вы можете регулярно загружать для обработки в DCR файлы с данными из различных источников. Каждому из таких источников данных должна быть назначена отдельная папка («папки источников данных»).

Например, если вы планируете ежедневно загружать на обработку в DCR два файла: BI-data.csv и CRM-data.gzip, каждому из этих источников данных нужно выделить папку. Соответствующие папки можно назвать, например, BI-data/ и CRM-data/.

Папки источников данных обычно создаются вручную через интерфейс выбранного вами облачного сервиса.

После создания папок для двух источников данных структура корзины и папок будет выглядеть следующим образом:

В каждой папке источника данных должны создаваться вложенные подпапки по дате и версии при каждом обновлении источника.

В рамках исполнения Закона о цифровых рынках (DMA) Google обновил свою политику согласия пользователей из ЕС 6 марта 2024 года. Как партнер Google по атрибуции приложений, AppsFlyer внес необходимые изменения для поддержки требований этой политики, одновременно обеспечивая рекламодателям максимальную ценность от их маркетинговых каналов Google Ads. 

Добавление полей согласия

При настройке источника, предназначенного для активации аудиторий в Google, и выборе Да в ответ на вопрос Есть ли в вашем источнике европейские пользователи, на которых распространяются правила DMA ЕС? убедитесь, что в исходный файл включены дополнительные поля согласия из таблицы ниже. Это позволяет AppsFlyer передавать Google необходимую информацию в процессе активации.

Дополнительные поля согласия и значения ответов:

Потенциальное воздействие на размер аудитории

Фактический и расчетный размер аудитории, передаваемой в Google, может различаться в зависимости от количества пользователей, дающих или не дающих согласие.