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

• Дата (только): 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. Нажмите + New source (на главной странице или на вкладке Sources).
    

   

3. Выполните шаги интерактивного руководства New source :

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

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

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

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

1. Выберите подключение, в котором будет создан (или уже создан) источник.
   • Если подключения в аккаунте не определены, откроется диалоговое окно Новое подключение с предложением создать подключение. Чтобы создать его, следуйте этим инструкциям to create it.
   • Если у вас уже есть подключения, но вы хотите использовать новое, нажмите + 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.
    • Папка input не является обязательной, и вы можете удалить ее или назвать по-другому, при условии что она соответствует требованиям к наименованиям 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. Загрузка append (delta) файлов 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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, может различаться в зависимости от количества пользователей, дающих или не дающих согласие.