Data Locker dành cho nhà tiếp thị

Báo cáo có sẵn qua Data Locker

Cấu trúc dữ liệu của bạn trong kho lưu trữ phụ thuộc vào việc bạn gửi dữ liệu đến kho lưu trữ đám mây hay kho dữ liệu. Cấu trúc thư mục được mô tả ở đây áp dụng cho kho lưu trữ (bộ chứa). Trong trường hợp lưu trữ trong kho dữ liệu, xin lưu ý rằng có thể áp dụng tham chiếu đến thư mục cho các chế độ xem. Xem Snowflake. 

Dữ liệu được ghi vào tùy chọn lưu trữ bạn đã chọn. Trong trường hợp lưu trữ đám mây, lưu trữ này thuộc sở hữu của AppsFlyer trên AWS hoặc thuộc sở hữu của bạn trên AWS, GCS hoặc Yandex. Bạn có thể chuyển các tùy chọn lưu trữ bất kỳ lúc nào hoặc gửi một phần hoặc tất cả dữ liệu của mình sang nhiều tùy chọn lưu trữ. 

Dữ liệu trong kho lưu trữ đám mây có bộ chứa được sắp xếp theo cấu trúc thư mục phân cấp dựa vào loại báo cáo, ngày và giờ. Hình sau đây là một ví dụ về cấu trúc này:

Dữ liệu của một báo cáo nhất định được chứa trong các thư mục giờ (h) được liên kết với báo cáo đó:

• Số lượng thư mục giờ phụ thuộc vào tính cập nhật của dữ liệu báo cáo (hàng giờ, hàng ngày hoặc tạo phiên bản).
• Dữ liệu được cung cấp dưới dạng tệp nén Snappy hoặc GZIP hoặc tệp không nén, có định dạng Parquet hoặc CSV.
• Tệp tin dữ liệu bao gồm các cột (trường). 
• Cấu trúc lược đồ (trường) của báo cáo hành trình của người dùng giống hệt nhau và phụ thuộc vào các trường bạn đã chọn. Các báo cáo khác đều có các trường cụ thể riêng, hay còn gọi là báo cáo không lược đồ. Xem báo cáo của nhà tiếp thị Data Locker về các báo cáo có sẵn và các liên kết đến thông số kỹ thuật của báo cáo. 

Tệp tin dữ liệu phụ thuộc vào loại phân tách.

• Dữ liệu được ghi cho chủ sở hữu bộ nhớ mà bạn chọn như sau:
  • Bộ nhớ của AppsFlyer
  • Bộ nhớ của khách hàng—AWS, GCS, Azure, Yandex, BigQuery và Snowflake
• Bạn có thể thay đổi lựa chọn bộ nhớ bất kỳ lúc nào.
• Nếu bạn thay đổi bộ nhớ, sẽ xảy ra các khả năng sau:
  • Chúng tôi bắt đầu ghi vào bộ nhớ mới được chọn trong vòng một giờ.
  • Chúng tôi tiếp tục ghi vào bộ nhớ hiện có trong giai đoạn chuyển tiếp là 7 ngày. Thời gian hết hạn của giai đoạn chuyển tiếp sẽ hiển thị trong giao diện người dùng. Sử dụng giai đoạn chuyển tiếp để cập nhật quy trình tải dữ liệu của bạn. Bạn có thể bắt đầu lại giai đoạn chuyển tiếp hoặc hoàn nguyên về bộ chứa AppsFlyer, nếu cần. 
  • Thay đổi bộ lưu trữ: Bạn có thể di chuyển từ tùy chọn lưu trữ này sang tùy chọn lưu trữ khác bằng cách sử dụng tùy chọn đa bộ lưu trữ và gửi đồng thời dữ liệu đến nhiều điểm đích. Khi đã hoàn tất quá trình di chuyển và thử nghiệm, hãy xóa tùy chọn lưu trữ mà bạn không cần nữa. 

Thông báo cho nhân viên bảo mật trong trường hợp bộ nhớ do khách hàng kiểm soát

Cân nhắc:

• Bộ chứa hoặc điểm đích chỉ phục vụ cho việc sử dụng AppsFlyer. Không nên ghi thực thể nào khác vào một điểm đích nhất định.
• Bạn có thể xóa dữ liệu trong điểm đích sau 25 giờ kể từ khi chúng tôi ghi dữ liệu.
• Dữ liệu được ghi vào điểm đích là bản sao dữ liệu đã có trong máy chủ của chúng tôi. Dữ liệu tiếp tục được lưu giữ trong máy chủ theo chính sách lưu giữ của chúng tôi. 
• Vì lý do kỹ thuật nên đôi khi chúng tôi xóa và ghi lại dữ liệu. Do đó, chúng tôi cần quyền xóa và lên danh sách. Không có quyền nào gây rủi ro cho bạn về bảo mật. Trong trường hợp lên danh sách, chúng tôi là thực thể duy nhất ghi vào bộ chứa. Trong trường hợp xóa, chúng tôi có thể tạo lại dữ liệu.
• Để biết thêm thông tin, bạn có thể liên hệ với nhóm bảo mật của chúng tôi qua địa chỉ hello@appsflyer.com hoặc CSM của bạn.  

Trong Hộp khoá Dữ liệu, bạn có thể gửi một vài hoặc tất cả dữ liệu của mình tới 2 điểm đích (được xác định trong cài đặt kết nối). Ví dụ: bạn có thể gửi dữ liệu của Ứng dụng A tới AWS và dữ liệu của Ứng dụng B tới GCS.

Mỗi kết nối bao gồm một tập hợp đầy đủ các cài đặt Data Locker, bao gồm cả một điểm đích. Cài đặt kết nối độc lập với nhau.

Đối với việc quản lý các kết nối của bạn, hãy xem xét:

• Trong cài đặt Data Locker, các kết nối được hiển thị trong các tab. Mỗi kết nối có tab cài đặt riêng mà từ đó bạn có thể quản lý kết nối. Biểu tượng của mỗi tab đại diện cho loại lưu trữ.
• Để xem thông tin chi tiết của kết nối, nhân bản kết nối hoặc xóa kết nối, nhấp vào ⋮ (tùy chọn).

Sử dụng quy trình này để thiết lập Data Locker. Mọi thay đổi đối với cài đặt Data Locker cần tới 3 giờ để có hiệu lực. 

Điều kiện tiên quyết

Để thiết lập bộ lưu trữ do nhà tiếp thị sở hữu:

Nếu bạn đang thiết lập Data Locker bằng dịch vụ lưu trữ đám mây do nhà tiếp thị sở hữu, hãy hoàn thành một hoặc nhiều quy trình sau ngay bây giờ. 

• Thiết lập:
  • Bộ chứa AWS
  • Bộ chứa GCS
  • [Beta] Azure Blob
  • [Thử nghiệm] Bộ chứa Yandex
  • Kho dữ liệu BigQuery
  • Kho dữ liệu Snowflake

Lưu ý! Nếu bạn không đăng ký Data Locker và muốn truy cập dữ liệu phân tích Nhóm người hoặc dữ liệu SKAN, bạn phải hoàn tất quy trình về dịch vụ lưu trữ đám mây do nhà tiếp thị sở hữu. 

Để thiết lập Data Locker:

1. Quản trị viên cần thực hiện thiết lập. 
2. Trong Appsflyer, đi đến Tích hợp > Data Locker. 
3. [Tùy chọn] Nếu bạn đã có điểm đích đang hoạt động trên Data Locker và muốn thêm điểm đích khác, hãy nhấp vào Thêm kết nối. Đặt tên cho kết nối của bạn.
4. Chọn một điểm đến dữ liệu dịch vụ đám mây. Thực hiện một trong những thao tác sau:
   
   • Chọn Bộ chứa AWS của AppsFlyer (tùy chọn này chỉ dành cho người đăng ký Data Locker). Nhấp vào Lưu và tiếp tục đến bước 5. 
   • Chọn S3.
     1. Nhập tên bộ chứa AWS S3 của bạn. Bắt buộc chứa tiền tố af- và nhập tên thủ công.
     2. Nhấp vào Test connection.
     3. Xác minh rằng không hiển thị thông báo lỗi cho biết rằng đường dẫn bộ chứa không hợp lệ.
     4. Chọn Tạo kết nối này tương thích với Adobe Experience Platform nếu bạn muốn. Nếu đã chọn, nhấp vào Lưu và tiếp tục đến Bước 6.
     5. Nhấp vào Save (Lưu).
   • Chọn GCS.
     1. Nhập tên bộ chứa GCS.
     2. Nhấp vào Test connection.
     3. Xác minh rằng không hiển thị thông báo lỗi cho biết rằng đường dẫn bộ chứa không hợp lệ.
     4. Nếu muốn làm kết nối này tương thích với Adobe Experience Platform, chọn Make this connection compatible with Adobe Experience Platform. Nếu chọn, nhấp vào Save và tiếp tục đến Bước 6.
     5. Nhấp vào Save (Lưu).
   • [Beta] Chọn Azure.
     1. Nhập Tên kết nối, Tên tài khoản lưu trữ và Mã khóa.
     2. Xác minh rằng không hiển thị thông báo lỗi cho biết rằng đường dẫn bộ chứa không hợp lệ.
     3. Nếu muốn làm kết nối này tương thích với Adobe Experience Platform, chọn Make this connection compatible with Adobe Experience Platform. Nếu chọn, nhấp vào Save và tiếp tục đến Bước 6.
     4. Nhấp vào Save (Lưu).
   • [Thử nghiệm] Chọn Yandex.
     1. Nhập tên Bộ chứa, Mã khóa truy cập và Mã khóa bí mật.
     2. Xác minh rằng không hiển thị thông báo lỗi cho biết rằng đường dẫn bộ chứa không hợp lệ.
     3. Nếu muốn làm kết nối này tương thích với Adobe Experience Platform, chọn Make this connection compatible with Adobe Experience Platform. Nếu chọn, nhấp vào Save và tiếp tục đến Bước 6.
     4. Nhấp vào Save (Lưu).
   • Chọn BigQuery.
     1. Nhập ID dự án BigQuery và tên tệp dữ liệu của bạn.
     2. Nhấp vào Test connection.
     3. Xác minh rằng không hiển thị thông báo lỗi cho biết rằng đường dẫn bộ chứa không hợp lệ.
     4. Nhấp vào Lưu và tiếp tục đến Bước 6.
   • Chọn Snowflake.
     1. Nhập vùng Snowflake và ID tài khoản của bạn.
     2. Nhấp vào Test connection.
     3. Xác minh rằng không hiển thị thông báo lỗi cho biết rằng đường dẫn bộ chứa không hợp lệ.
     4. Nhấp vào Lưu và tiếp tục đến Bước 6.
5. Hoàn thành phần Cài đặt dữ liệu:
   1. Chọn định dạng tệp tin bạn muốn:
      • [Mặc định] Parquet
      • CSV
   2. Chọn kiểu nén tệp tin bạn muốn:
      • Snappy (chỉ khả dụng đối với các tệp tin Parquet)
      • GZIP
      • Không nén
   3. Chọn số hàng tối đa bạn muốn trong tập tin của mình: 10k, 25k, 50k, 100k, 200k hoặc 500k. Nhiều hàng hơn trong tập tin có nghĩa là ít tập tin hơn nhưng kích thước tập tin sẽ lớn hơn.
   4. Chọn cấu trúc thư mục (phân tách dữ liệu):
      • [Mặc định] Hợp nhất
      • Phân tách theo ứng dụng
6. Hoàn thành phần nội dung Data Locker:
7. Chọn một hoặc nhiều Ứng dụng để đưa vào báo cáo. Chọn tất cả để tự động thêm cả các ứng dụng được thêm vào trong tương lai. 
8. Nhấp vào Apply (Áp dụng). 
9. [Tùy chọn] Chọn một hoặc nhiều Nguồn Truyền thông để đưa vào báo cáo.
   • Default=All (Mặc định=Tất cả). Điều này có nghĩa là các nguồn truyền thông được thêm vào trong tương lai sẽ tự động được thêm vào.
10. Nhấp vào Apply (Áp dụng). 
11. [Tùy chọn] Chọn các Trường để đưa vào báo cáo. Lưu ý: Đôi khi chúng tôi có sẵn các trường bổ sung. Hãy cân nhắc điều này trong quá trình nhập dữ liệu.
12. Nhấp vào Apply (Áp dụng). 
13. Chọn các loại báo cáo. Bạn phải chọn ít nhất là 1. 
14. [Tùy chọn] Đối với báo cáo Sự kiện trong ứng dụng, hãy chọn các sự kiện trong ứng dụng muốn đưa vào. Nếu bạn có hơn 100 loại sự kiện trong ứng dụng, bạn không thể tìm kiếm chúng. Nhập chính xác tên của sự kiện để chọn. 
    • Default=All (Mặc định=Tất cả). Điều này có nghĩa là các sự kiện trong ứng dụng được thêm vào trong tương lai sẽ tự động được thêm vào.
15. Nhấp vào Apply (Áp dụng). 
16. Nhấp vào Lưu kết nối. Một trong những điều sau đây có thể xảy ra:
    
    • Nếu bạn đã chọn bộ chứa AWS AppsFLyer:
      • Bộ chứa AWS chuyên dụng được tạo. Thông tin đăng nhập bộ chứa sẽ hiển thị.
      • Có thể truy cập bộ chứa bằng thông tin đăng nhập. Thông tin đăng nhập cung cấp cho bạn quyền truy cập chỉ đọc vào bộ chứa.
    • Nếu bạn đã chọn một trong các dịch vụ lưu trữ đám mây: Dữ liệu sẽ được ghi vào dịch vụ của bạn trong vòng 3 giờ. 

Quản trị viên có thể đặt lại thông tin đăng nhập của bộ chứa AppsFlyer bất kỳ lúc nào. Lưu ý! Nếu bạn đặt lại thông tin đăng nhập, bạn phải cập nhật các tập lệnh nhập dữ liệu của mình bằng thông tin đăng nhập được cập nhật.

Để đặt lại thông tin đăng nhập của bộ lưu trữ do AppsFlyer sở hữu:

1. Trong Appsflyer, đi đến Tích hợp > Data Locker. 
2. Hãy chọn điểm đích do AppsFlyer sở hữu.
3. Trong mục Credentials (Thông tin đăng nhập), nhấp vào Reset credentials (Đặt lại thông tin đăng nhập).
   Một cửa sổ xác nhận sẽ hiển thị.
4. Nhấp vào Reset (Đặt lại).
5. Chờ (khoảng 20 giây) cho đến khi thông báo Credentials successfully reset (Đặt lại thành công thông tin đăng nhập) được hiển thị.
   Có sẵn các thông tin đăng nhập cập nhật.

• Dấu hiệu: Không thể truy xuất dữ liệu bằng AWS CLI
• Thông báo lỗi: Đã xảy ra lỗi (AccessDenied) khi gọi thao tác ListObjectsV2: Truy cập bị Từ chối
• Nguyên nhân: Thông tin đăng nhập AWS đang được sử dụng không phải là thông tin đăng nhập chính xác cho bộ chứa AppsFlyer. Điều này có thể do trên máy của bạn có nhiều thông tin đăng nhập hoặc thông tin đăng nhập không hợp lệ. 
• Giải pháp:
  1. Sử dụng một phương thức khác, như Cyberduck để truy cập bộ chứa, nghĩa là không phải CLI. Thực hiện điều này để xác minh rằng thông tin đăng nhập bạn đang sử dụng vẫn hoạt động bình thường. Nếu bạn có thể kết nối bằng Cyberduck, điều này cho thấy có vấn đề với bộ nhớ đệm thông tin đăng nhập. 
  2. Làm mới bộ nhớ đệm thông tin đăng nhập AWS.
     Ảnh chụp màn hình từ AWS

     

Trước khi bạn bắt đầu:

• Cài đặt AWS CLI trên máy tính của bạn.
• Trong AppsFlyer, đi đến Data Locker, và truy xuất thông tin có trong bảng thông tin đăng nhập.

Để sử dụng AWS CLI:

1. Mở thiết bị đầu cuối. Để thực hiện trong Windows, bấm <Windows>+<R>, nhấp vào OK.
   Cửa sổ dòng lệnh mở ra.
2. Nhập cấu hình aws.
3. Nhập Khóa Truy cập AWS như xuất hiện trong bảng thông tin đăng nhập.
4. Nhập Mã khóa Bí mật AWS của bạn như xuất hiện trong bảng thông tin đăng nhập.
5. Nhập eu-west-1.
6. Nhấn Enter (Không có).

Sử dụng các lệnh CLI sau đây khi cần thiết.

Trong các lệnh sau, có thể tìm thấy giá trị của {home-folder}

Để liệt kê các thư mục trong bộ chứa của bạn:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/

Liệt kê các tệp tin và thư mục

Có ba loại thư mục trong bộ chứa Data Locker của bạn:

• Loại Báo cáo t=
• Ngày dt=
• Giờ h=

Để liệt kê tất cả các báo cáo của một loại báo cáo cụ thể:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/

Để liệt kê tất cả các báo cáo của một loại báo cáo cụ thể cho một ngày cụ thể:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17

Để liệt kê tất cả các báo cáo của một báo cáo cụ thể, trong một giờ cụ thể của một ngày cụ thể:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17/h=23

Để tải xuống tệp tin cho một ngày cụ thể:

aws s3 cp s3://af-ext-reports/<home-folder>/data-locker-hourly/t=installs/dt=2020-08-01/h=9/part-00000.gz ~/Downloads/

Trước khi bạn bắt đầu:

• Cài đặt máy khách Cyberduck.
• Trong AppsFlyer, đi đến Data Locker và truy xuất thông tin có trong bảng thông tin đăng nhập.

Để cấu hình Cyberduck:

1. Trong Cyberduck, nhấp vào Action (Hành động).
2. Chọn New Bookmark (Dấu trang Mới). Sẽ có cửa sổ mở ra.
3. Trong trường đầu tiên, (được đánh dấu [1] trong ảnh chụp màn hình bên dưới), hãy chọn Amazon S3.

   

4. Điền vào các trường như sau:
   • Biệt danh : Văn bản tự do
   • Server (Máy chủ): s3.amazonaws.com
   • ID khóa truy cập: Sao chép Khóa truy cập AWS như khóa xuất hiện tại bảng thông tin đăng nhập trong AppsFlyer
   • Khóa truy cập bí mật: Sao chép khóa Bí mật của bộ chứa như xuất hiện tại bảng thông tin đăng nhập trong AppsFlyer.
   • Đường dẫn: {Bucket Name}/{Home Folder} Ví dụ: af-ext-reports/1234-abc-ffffffff
5. Đóng cửa sổ. Để thực hiện, hãy nhấp vào X ở góc trên bên phải của cửa sổ.
6. Chọn kết nối.
   Các thư mục dữ liệu được hiển thị.

Trước khi bạn bắt đầu:

• Cài đặt Trình duyệt Amazon S3.
• Trong AppsFlyer, đi đến Data Locker và truy xuất thông tin có trong bảng thông tin đăng nhập.

Để cấu hình Trình duyệt Amazon S3:

1. Trong trình duyệt S3, hãy nhấp vào Accounts (Tài khoản) > Add New Account (Thêm Tài khoản Mới).
   Cửa sổ Thêm Tài khoản Mới sẽ mở ra.

   

2. Điền vào các trường như sau:
   • Account Name (Tên Tài khoản): văn bản tự do. 
   • Access Key ID (ID Mã khóa Truy cập): sao chép Mã khóa Truy cập AWS như xuất hiện trong bảng thông tin đăng nhập. 
   • Secret Access Key (Mã khóa Truy cập Bí mật): sao chép mã khóa Bí mật của Bộ chứa như xuất hiện trong bảng thông tin đăng nhập.
   • Chọn Encrypt Access Keys with a password (Mã hóa Mã khóa Truy cập bằng mật khẩu) và nhập mật khẩu. Ghi lại mật khẩu này.
   • Chọn Use secure transfer (Sử dụng phương thức truyền an toàn). 
3.  Nhấp vào Save changes (Lưu thay đổi).
4. Nhấp vào Buckets (Bộ chứa) > Add External Bucket (Thêm Bộ chứa Ngoài).
   Cửa sổ Thêm Bộ chứa Ngoài sẽ mở ra.
   

   

5. Nhập Bucket name (Tên Bộ chứa).Tên Bộ chứa có định dạng sau: {Bucket Name}/{Home Folder}. Các giá trị cần thiết cho tên bộ chứa và thư mục gốc hiện trong cửa sổ thông tin đăng nhập. 
6. Nhấp vào Add External bucket
   (Thêm Bộ chứa Ngoài).Bộ chứa được tạo và xuất hiện trong bảng điều khiển bên trái của cửa sổ.
   Bây giờ bạn có thể truy cập các tệp tin Data Locker.