Примечание. Описанная ниже процедура должна быть выполнена вашим администратором AWS.

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

1. Войдите в консоль AWS.
2. Откройте сервис S3.
3. Чтобы создать корзину:
   1. Нажмите Создать корзину.
   2. Укажите имя в поле Bucket name (Название корзины): сначала префикс af-dcr-, затем ваш текст (как было описано выше).
   3. Нажмите Создать корзину.
4. Чтобы предоставить AppsFlyer права доступа к корзине:
   1. Выберите созданную вами корзину. 
   2. Перейдите на вкладку Permissions (Разрешения). 
   3. В разделе Bucket policy (Политика корзины) нажмите Edit (Редактировать).
      Откроется окно для редактирования политики корзины.
   4. Вставьте в это окно следующий фрагмент кода.

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Sid": "AF-DCR",
            "Effect": "Allow",
            "Principal": {
              "AWS": "arn:aws:iam::195229424603:user/product=dcr-reporter__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/*"
            ]
          }
        ]
      }
      

5. Во фрагменте кода замените имя af-dcr-mybucket (в обеих строках, где оно встречается) на имя созданной вами корзины.
   Внимание! При замене имени корзины во фрагменте кода будьте внимательны, чтобы не удалить символы /* в строке, в которой имя корзины встречается второй раз.

6. Нажмите Save changes (Сохранить изменения).

Примечание. Описанная ниже процедура должна быть выполнена вашим администратором Google Cloud.

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

1. Войдите в консоль GCS.
2. Перейдите на страницу Cloud Storage Browser.
3. Чтобы создать корзину:
   1. Нажмите  Create bucket (Создать корзину).
   2. Введите информацию о корзине на странице создания корзины . Укажите имя корзины: сначала префикс af-dcr-, затем ваш текст (как было описано выше).
   3. Нажмите Continue (Продолжить).
   4. Нажмите Create (Создать).
4. Чтобы предоставить AppsFlyer права доступа к корзине:
   1. Выберите созданную вами корзину. 
   2. Перейдите на вкладку Permissions (Разрешения). 
   3. В разделе Permissions (Разрешения) нажмите + Add (Добавить).
      Откроется окно Add members (Добавить пользователей).
   4. В поле New members (Новые пользователи) вставьте следующий фрагмент кода.

      appsflyer-dcr@dcr-report.iam.gserviceaccount.com

   5. В списке Role (Роль) выберите Cloud storage (Облачное хранилище) > Storage Admin (Администратор хранилища).
      

      

   6. Нажмите кнопку Save (Сохранить).
      

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

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

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

af-dcr-example-bucket/01bcc5fb/input/

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

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

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

af-dcr-example-bucket/01bcc5fb/input/BI-data/
                                     CRM-data/

Мы наконец дошли до той части структуры папок, где все происходит, — до папок, непрерывно просматриваемых AppsFlyer на предмет новых файлов для чтения в DCR.

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

• В каждой папке источника данных --> 1 подпапка по каждой дате («папка даты»)
  • Формат: dt=гггг-мм-дд/
  • Пример: dt=2022-03-10/
• В каждой папке даты --> 1 подпапка по каждой версии за эту дату («папка версии»)
  • Формат: v=n/
  • Пример: v=1/
  • Примечание. Папка версии требуется даже в том случае, если вы загружаете файл один раз в день.
• В каждой папке версии --> 1 подпапка, указывающая расположение данных («папка с данными»)
  • Формат: data/

В большинстве случаев вы будете использовать вызовы API или другие доступные программные средства, чтобы папки даты/версии/данных создавались автоматически при каждой загрузке файла из источника данных. Дополнительную информацию см. в документации к API своего облачного сервиса: AWS, GCS.

Файлы из источников данных

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

• Должны соответствовать требованиям DCR к именам
• Формат CSV или GZIP. Файл внутри архива GZIP должен иметь формат CSV.
• Количество файлов из источников данных на папку с данными:
  • CSV: не более 1
  • GZIP: не более 1 цельного файла. Файлы GZIP из нескольких частей поддерживаются при условии следующего именования: имяфайла_part01.gzip, имяфайла_part02.gzip и т. д.

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

• Дата и время:
  • Формат: гггг-мм-дд чч:мм:сс
  • Часовой пояс: UTC
• Числа: до 2 символов после десятичного разделителя
• Длина строки: до 256 символов
• Ограничения по символам: нет (все символы считаются допустимыми)

Файлы _SUCCESS

После загрузки файла источника данных в папку данных, в папку версии должен быть загружен пустой файл с именем _SUCCESS. Это сигнализирует AppsFlyer о том, что новый файл доступен для обработки. В большинстве случаев для автоматической загрузки этого файла используется скрипт API.

Важно! Файл _SUCCESS загружается в папку версии вне папки данных.

Имя файла:

• ВСЕ ЗАГЛАВНЫЕ
• Начинается с нижнего подчеркивания (_)
• Не имеет расширения файла

Для файлов из нескольких частей:

• Загружается только один файл _SUCCESS для всех частей файла.
• Файл _SUCCESS должен загружаться только по завершении загрузки всех частей файла.

af-dcr-example-bucket/01bcc5fb/input/BI-data/
                                             dt=2022-03-10/
                                                           v=1/
                                                               _SUCCESS
                                                               data/
                                                                    BI-data.csv
                                             dt=2022-03-11/
                                                           v=1/
                                                               _SUCCESS
                                                               data/
                                                                    BI-data.csv
                                     CRM-data/
                                             dt=2022-03-10/
                                                           v=1/
                                                               _SUCCESS
                                                               data/
                                                                    CRM-data_part01.gzip
                                                                    CRM-data_part02.gzip
                                                           v=2/
                                                               _SUCCESS
                                                               data/
                                                                    CRM-data_part01.gzip
                                                                    CRM-data_part02.gzip
                                             dt=2022-03-11/
                                                           v=1/
                                                               _SUCCESS
                                                               data/
                                                                    CRM-data_part01.gzip
                                                                    CRM-data_part02.gzip
                                                           v=2/
                                                               _SUCCESS
                                                               data/
                                                                    CRM-data_part01.gzip
                                                                    CRM-data_part02.gzip

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

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

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

af-dcr-example-bucket/01bcc5fb/output/

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

Например, если вы будете получать из DCR два отчета: отчет по конверсиям и отчет по ретаргетингу, каждому из этих источников данных нужно выделить папку. Соответствующие папки можно назвать, например, conversions/ и retargeting/.

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

af-dcr-example-bucket/01bcc5fb/output/conversions/
                                      retargeting/

В отличие от пути к папке входных данных, вы не создаете вложенные папки дат/версий в пути папки для вывода данных. Эта структура папок автоматически создается AppsFlyer при каждой доставке отчета.

Отчеты DCR предоставляются в формате CSV.