Data Locker—dành cho nhà quảng cáo

Khái quát: Data Locker gửi dữ liệu báo cáo vào bộ lưu trữ đám mây để tải vào hệ thống BI của bạn. Bạn có thể chọn giữa các điểm đích lưu trữ khác nhau từ bộ chứa do AppsFlyer sở hữu trong AWS, bộ lưu trữ do bạn sở hữu trong AWSGCS và Snowflake.  Data Locker hỗ trợ nhiều điểm đích. Điều đó có nghĩa là bạn có thể gửi tất cả dữ liệu đến nhiều điểm đích, phân tách dữ liệu theo điểm đích hoặc kết hợp cả hai.  Đối với mỗi điểm đích, hãy chọn định dạng Parquet hoặc CSV. 

Data Locker

6133DataLockerForAdvertisers.png

Bài đọc liên quan:

Trong Data Locker, hãy chọn ứng dụng, nguồn truyền thông, sự kiện và báo cáo của bạn để đưa vào dữ liệu mà AppsFlyer cung cấp cho các tùy chọn lưu trữ đám mây bạn đã chọn. Sau đó, tải dữ liệu theo cách lập trình từ bộ lưu trữ vào hệ thống của bạn. 

Tính năng—Data Locker

Tính năng Mô tả
Tùy chọn lưu trữ (đám mây)

Data Locker có thể gửi dữ liệu của bạn đến bất cứ nhà cung cấp dịch vụ đám mây nào sau đây:

Bạn có thể đặt nhiều điểm đích trong Data Locker. Điều này có nghĩa là bạn có thể gửi tất cả hoặc một phần dữ liệu của mình đến nhiều điểm đích.

Ví dụ:

  • Phân tách dữ liệu theo loại báo cáo. Gửi dữ liệu thô tới GCS và hợp nhất dữ liệu vào Snowflake.
  • Phân tách dữ liệu theo ứng dụng và gửi dữ liệu theo mỗi nhóm ứng dụng đến các bộ chứa khác nhau. 
Đa ứng dụng 

Gửi dữ liệu của 1, nhiều hoặc tất cả các ứng dụng trong tài khoản của bạn. Khi bạn thêm ứng dụng vào tài khoản, chúng có thể tự động được đưa vào. 

Khung thời gian khả dụng

14 ngày

Phân tách dữ liệu

Các tùy chọn phân tách dữ liệu có sẵn

  • [Mặc định] Hợp nhất: Dữ liệu của tất cả các ứng dụng được kết hợp. Trường ID ứng dụng cấp hàng được sử dụng để xác định ứng dụng trong tệp dữ liệu. 
  • Phân tách theo ứng dụng: Dữ liệu của mỗi ứng dụng nằm trong một thư mục riêng. Tên thư mục chứa ID ứng dụng. 
Tùy chọn định dạng dữ liệu
  • CSV
  • Parquet
Tính cập nhật của dữ liệu

Tính cập nhật tùy thuộc vào loại báo cáo 

  • Hàng giờ: Dữ liệu được tạo liên tục; ví dụ: lượt cài đặt và dữ liệu sự kiện trong ứng dụng được ghi trong vòng vài giờ sau khi sự kiện đến AppsFlyer. 
  • Hàng ngày: Các báo cáo như lượt gỡ cài đặt, được tạo hàng ngày và sẵn sàng vào ngày hôm sau. 
  • Tạo phiên bản: Nếu cùng một báo cáo được tạo nhiều lần trong cùng một khoảng thời gian, thì sẽ áp dụng một cơ chế tạo phiên bản. 
Big Query và Google Data Studio

Nếu bạn ghi dữ liệu vào bộ nhớ GCS, Big Query có thể tải trực tiếp các tệp tin Data Locker của bạn mà không cần bất kỳ quá trình xử lý trung gian nào. Bạn có thể sử dụng các công cụ khác qua Big Query, như Google Data Studio, để trực quan hóa dữ liệu của mình. 

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

Kiến trúc lưu trữ dữ liệu

Tổng quan

Cấu trúc dữ liệu của bạn trong bộ lưu trữ phụ thuộc vào việc dữ liệu được gửi đến bộ 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 bộ lưu trữ (bộ chứa). Trong trường hợp lưu trữ kho dữ liệu (Snowflake), xin lưu ý rằng có thể áp dụng số tham chiếu 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, bộ lưu trữ thuộc sở hữu của AppsFlyer trên AWS hoặc do bạn sở hữu trên AWS hoặc GCS. 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 bộ nhớ được sắp xếp theo cấu trúc thư mục phân cấp, theo 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:

DLFolderOVerview.png

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 tin nén GZ 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à quảng cáo Data Locker để biết 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. 

Cấu trúc thư mục

Thư mục Mô tả 
ID Đăng ký

DataLockerFolders.png

  • Thư mục cấp cao nhất trong bộ chứa phụ thuộc vào chủ sở hữu và nhà cung cấp bộ lưu trữ. Nói chung, thư mục cấp cao nhất là ID Đăng ký của bạn nhưng trong một số trường hợp, ví dụ như nếu bạn sử dụng Cyberduck thì ID sẽ được đặt trong dấu trang và không hiển thị trong cấu trúc thư mục. 
  • Thư mục data-locker-hourly chứa các chủ đề báo cáo. Các thư mục trên cấp độ này phụ thuộc vào quyền sở hữu bộ chứa và nhà cung cấp dịch vụ đám mây.

 Ví dụ về cấu trúc thư mục dựa trên chủ sở hữu bộ chứa và nhà cung cấp đám mây

  • Bộ chứa AppsFlyer: <af-ext-reports>/<unique_identifier>/<data-locker-hourly>
  • Bộ chứa AWS của bạn: <af-datalocker-your bucket prefix>/<generated-home-folder><subscription-id>
  • Bộ chứa GCS của bạn: <your bucket name>/<generated-home-folder>/<subscription-id>
Chủ đề (t) Loại báo cáo liên quan đến chủ đề của báo cáo. 
Ngày (dt)

Đây là ngày dữ liệu liên quan. Trong trường hợp dữ liệu thô, ngày này có nghĩa là ngày xảy ra sự kiện. Trong trường hợp dữ liệu hợp nhất, thì đây chính là ngày báo cáo. 

Thời gian (h hoặc phiên bản)

Thư mục ngày được chia thành các thư mục theo giờ (h) hoặc phiên bản tùy thuộc vào loại báo cáo. 

Thư mục theo giờ

Các thư mục h liên quan đến thời gian AppsFlyer nhận dữ liệu. Ví dụ: các sự kiện cài đặt nhận được trong khoảng thời gian từ 14:00-15:00 UTC được ghi vào tệp tin h=14. Lưu ý! Sẽ có độ trễ về thời gian, khoảng 1-3 giờ, từ khi dữ liệu đến AppsFlyer cho đến khi thư mục h được ghi vào Data Locker. Ví dụ: thư mục h=14 được ghi 1 giờ sau đó vào lúc 15:00 UTC. 

Đặc điểm thư mục theo giờ:

  • Có các thư mục 24 h được đánh số từ 0–23. Ví dụ: h=0, h=1, v.v. 
  • Thư mục đến trễ, h=late, chứa các sự kiện của ngày hôm trước đến sau nửa đêm. Có nghĩa là các sự kiện đến trong khoảng 00:00–02:00 UTC của ngày hôm sau. Ví dụ: nếu người dùng cài đặt một ứng dụng vào thứ Hai lúc 08:00 UTC và sự kiện đến vào thứ Ba lúc 01:00 UTC, thì sự kiện được ghi vào thư mục đến trễ của ngày thứ Hai. 
  • Dữ liệu đến sau 02:00 UTC được ghi vào thư mục của ngày và giờ đến thực tế. 
  • Đảm bảo rằng dữ liệu trong thư mục h=late được sử dụng. Dữ liệu không được chứa trong bất kỳ thư mục nào khác. 
  • Thư mục _temporary: Trong một số trường hợp, chúng tôi tạo một thư mục tạm thời trong một thư mục h. Bỏ qua các thư mục tạm thời và thư mục con. Ví dụ: /t=impressions/dt=2021-04-11/h=18/_temporary.
  • Lưu ý:
    • Các báo cáo dữ liệu thô cập nhật dữ liệu hàng ngày được lưu trữ trong thư mục h=23. Báo cáo lượt gỡ cài đặt thường nằm trong thư mục h=2 nhưng cũng có thể nằm trong bất kỳ thư mục nào. 
    • Báo cáo Nhóm người và báo cáo Tính gia tăng được lưu trữ trực tiếp vào thư mục dt. 
    • Các báo cáo tạo phiên bản tuân theo một quy ước khác được mô tả trong phần này. 

Những điều cần lưu ý về báo cáo theo giờ cho các ứng dụng không sử dụng thời gian UTC.

Để đảm bảo rằng bạn nhận được tất cả dữ liệu cho một ngày nhất định theo lịch, bạn phải sử dụng các thư mục theo ngày được xác định bằng múi giờ ứng dụng như được trình bày chi tiết sau đây: 

  • Múi giờ ở bán cầu Đông: Để nhận được tất cả dữ liệu của một ngày nhất định theo lịch, bạn phải sử dụng các thư mục theo ngày và giờ UTC. Ví dụ: Múi giờ ứng dụng của bạn là UTC+10 (Sydney, Úc). Để có được tất cả dữ liệu theo giờ liên quan đến ngày thứ Ba (Sydney), bạn phải sử dụng các thư mục sau: Thứ Hai h=14–23 và muộn hơn, thứ Ba h=0–13 và 14-15 Tại sao bạn phải sử dụng thứ Ba h=14-15? Một vài dữ liệu có thể đến muộn. Vì vậy, các thư mục h=14–15 có thể chứa các sự kiện đến muộn. Bạn phải lọc event_time để phù hợp với ngày ứng dụng theo lịch so với UTC. 
  • Múi giờ ở bán cầu Tây: Để nhận được tất cả dữ liệu của một ngày nhất định theo lịch, bạn phải sử dụng các thư mục theo ngày và giờ UTC. Ví dụ: Múi giờ ứng dụng của bạn là UTC- 7 (Los Angeles). Để nhận được tất cả dữ liệu theo giờ liên quan đến thứ Ba (Los Angeles), bạn phải sử dụng các thư mục sau: Thứ Ba h=7–23 và muộn hơn, thứ Tư h=0–6 và 7-8. Tại sao bạn phải sử dụng thứ Tư h=7-8? Một vài dữ liệu có thể đến muộn. Vì vậy, các thư mục h=7–8 có thể chứa các sự kiện đến muộn. Bạn phải lọc event_time để phù hợp với ngày ứng dụng theo lịch so với UTC.

Thư mục phiên bản

Một số báo cáo có tùy chọn tạo phiên bản. Điều này có nghĩa là dữ liệu cập nhật mới nhất cho một ngày nhất định sẽ được cung cấp nhiều lần. Vì dữ liệu có thể tiếp tục cập nhật do dữ liệu đến muộn hoặc dữ liệu chính xác hơn nên cùng một báo cáo có nhiều phiên bản, trong đó phiên bản gần đây nhất sẽ là chính xác nhất. 

Các báo cáo cho một ngày nhất định được chứa trong thư mục phiên bản của ngày đó. Mỗi phiên bản được chứa trong một thư mục riêng biệt có tên được đặt bằng nhãn thời gian Epoch phân biệt từng báo cáo. 

Trong quy trình nhập dữ liệu, bạn cần lưu ý rằng dữ liệu có thể được ghi trở về trước. Ví dụ: vào ngày 14 tháng 1, dữ liệu có thể được ghi vào thư mục 1 tháng 1. Nếu bộ chứa do bạn sở hữu, hãy cân nhắc sử dụng thông báo dịch vụ đám mây để kích hoạt quy trình nhập của bạn (AWS | GCS)

Phân tách ứng dụng

Dữ liệu được cung cấp trong các tệp dữ liệu hợp nhất chứa dữ liệu của tất cả các ứng dụng đã chọn hoặc được tách riêng thành các thư mục theo ứng dụng. Việc phân tách sẽ nằm trong thư mục h như được mô tả trong bảng sau.
Loại phân tách Mô tả 
[Mặc định] Hợp nhất

Dữ liệu cho tất cả các ứng dụng được cung cấp trong các tệp dữ liệu thống nhất. Khi sử dụng dữ liệu, hãy sử dụng trường app_id cấp hàng để phân biệt giữa các ứng dụng.

Ví dụ về tệp dữ liệu nằm trong thư mục h=2

UnifiedByApp.png

Quy ước đặt tên tệp tin dữ liệu là unique_id.gz.

  • Quy trình tải dữ liệu của bạn phải: 
    • Tải dữ liệu sau khi đã đặt cờ hiệu _SUCCESS.
    • Tải tất cả các tệp tin trong thư mục có phần mở rộng .gz. Không xây dựng quy trình nhập của bạn bằng cách sử dụng logic đánh số bộ phận. 
Phân tách theo ứng dụng

Thư mục chứa các thư mục con cho mỗi ứng dụng. Các tệp tin dữ liệu cho một ứng dụng nhất định được chứa trong thư mục ứng dụng. Trong hình sau, thư mục h=19 chứa các thư mục ứng dụng. Mỗi thư mục ứng dụng chứa các tệp tin dữ liệu được liên kết. Lưu ý! Các tệp tin dữ liệu không chứa app_id, nên bạn phải xác định app_id bằng cách sử dụng thư mục. 

DLSegregateByApp.png

Trong mỗi thư mục ứng dụng, quy ước đặt tên là unique_id.gz: 

  • Quy trình tải dữ liệu của bạn phải: 
    • Tải dữ liệu sau khi đã đặt cờ hiệu _SUCCESS.
    • Tải tất cả các tệp tin trong thư mục có phần mở rộng .gz. Không xây dựng quy trình nhập của bạn bằng cách sử dụng logic đánh số bộ phận. 

Giới hạn: Tùy chọn này không có sẵn cho báo cáo Phân bổ trên cơ sở người dùng.

Tệp dữ liệu

Nội dung Chi tiết
Cờ hiệu hoàn thành

Cờ hiệu tệp tin cuối cùng (hoàn thành) được đặt khi tất cả dữ liệu cho một thư mục h nhất định đã được ghi. 

  • Không đọc dữ liệu trong một thư mục trước khi xác minh sự tồn tại của cờ hiệu _SUCCESS.

  • Cờ hiệu _SUCCESS được đặt ngay cả trong trường hợp không có dữ liệu cần ghi vào một thư mục nhất định và thư mục đó trống. 

  • Lưu ý! Trong tùy chọn phân tách theo ứng dụng, cờ hiệu được đặt trong thư mục h chứ không phải các thư mục ứng dụng riêng lẻ. Xem các số liệu trong phần trước. 
Loại tệp tin
  • Các tệp phần được nén bằng GZ.
  • Sau khi giải nén, các tệp tin dữ liệu sẽ có định dạng Parquet hoặc CSV tùy theo tùy chọn cài đặt của bạn.
Thứ tự cột (tệp tin CSV) 

Trong trường hợp tệp tin CSV, thứ tự các trường trong báo cáo luôn giống nhau. Khi chúng tôi thêm các trường mới, chúng sẽ được thêm vào bên phải các trường hiện có. 

Về vấn đề này: 

  • Cấu trúc cột của báo cáo hành trình người dùng là giống hệt nhau. Điều này có nghĩa là bạn có thể có các quy trình tải dữ liệu tương tự cho các loại báo cáo khác nhau. Bạn chọn các trường có trong các báo cáo. Ý nghĩa của trường được trình bày chi tiết trong từ điển dữ liệu thô
  • Các báo cáo có ký hiệu FF trong phần tính khả dụng của báo cáo không tuân theo cấu trúc cột chung. 
Những điều cần lưu ý khi điền trường

Các trường rỗng hoặc trống: Một số trường được điền là null hoặc để trống. Điều này có nghĩa là trong trường hợp của một báo cáo nhất định, không có dữ liệu nào để báo cáo. Thông thường, null có nghĩa là trường này không được điền trong trường hợp của loại ứng dụng và báo cáo nhất định. Để trống "" có nghĩa là trường có liên quan theo trường hợp nhưng không tìm thấy dữ liệu nào để điền vào. 

Trong trường hợp nguồn truyền thông bị hạn chế, thì nội dung của các trường bị hạn chế sẽ được đặt thành rỗng. 

Về tổng thể, hai trạng thái rỗng và trống được coi là một và giống nhau; không có dữ liệu khả dụng. 

Múi giờ và Tiền tệ

Cài đặt múi giờ và tiền tệ cụ thể cho ứng dụng không ảnh hưởng đến dữ liệu được ghi vào Data Locker. Áp dụng những điều sau: 

  • Múi giờ: Dữ liệu ngày và giờ tính theo UTC.
  • Tiền tệ: Trường event_revenue_usd có đơn vị là USD.

Giá trị có dấu phẩy: Các dấu phẩy này nằm giữa dấu ngoặc kép `"`, ví dụ: `"iPhone6,1"`.

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

Tùy chọn lưu trữ

 Chú ý!

Nếu bạn đang sử dụng tùy chọn lưu trữ do nhà quảng cáo sở hữu: 

  • Xác minh rằng bạn tuân thủ các quy định về quyền riêng tư của dữ liệu như GDPR và chính sách lưu giữ dữ liệu của mạng quảng cáo/SRN.
  • Không sử dụng giải pháp lưu trữ do nhà quảng cáo sở hữu để gửi dữ liệu cho bên thứ ba. 
  • 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 hoặc GCS
  • 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. 
  Bộ nhớ do AppsFlyer sở hữu (AWS)  Bộ lưu trữ do nhà quảng cáo sở hữu (GCS, AWS, Snowflake)
Tên bộ chứa Do AppsFlyer đặt
  • GCS: Không hạn chế
  • AWS: Do bạn đặt. Phải có tiền tố af-datalocker-.

Ví dụ: af-datalocker-your-bucket-name

Quyền sở hữu bộ nhớ AppsFlyer Nhà quảng cáo
Nền tảng lưu trữ AWS AWS, GCS, Snowflake
Thông tin đăng nhập để bạn truy cập dữ liệu Có sẵn trong giao diện người dùng Data Locker cho quản trị viên tài khoản AppsFlyer của bạn Chưa biết đến AppsFlyer. Sử dụng thông tin đăng nhập do nhà cung cấp đám mây cung cấp.
Lưu trữ dữ liệu Dữ liệu sẽ bị xóa sau 14 ngày Trách nhiệm của nhà quảng cáo
Yêu cầu xóa dữ liệu Trách nhiệm của AppsFlyer Trách nhiệm của nhà quảng cáo
Bảo mật AppsFlyer kiểm soát bộ nhớ. Khách hàng có quyền truy cập đọc.

Nhà quảng cáo kiểm soát bộ nhớ.

  • AWS: AppsFlyer yêu cầu quyền GetObject, ListBucket, DeleteObject, PutObject đối với bộ chứa. Bộ chứa phải dành riêng cho việc sử dụng AppsFlyer. Không sử dụng bộ chứa cho các mục đích khác.
  • GCS: Xem bài viết về cấu hình GCS.
Dung lượng lưu trữ Do AppsFlyer quản lý Do nhà quảng cáo quản lý
Kiểm soát truy cập bằng cách sử dụng điểm cuối VPC với chính sách cho bộ chứa Không áp dụng [Tùy chọn] Trong AWS, nếu bạn triển khai thao tác bảo mật điểm cuối VPC ở cấp độ bộ chứa thì bạn phải đưa các máy chủ AppsFlyer vào danh sách cho phép. 

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 các quyền. 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.  

Các nguyên tắc về đa điểm đích

Trong Data Locker, bạn có thể gửi một phần hoặc tất cả dữ liệu của mình đến nhiều điểm đích. Mỗi điểm đích bao gồm một tập hợp các tùy chọn cài đặt hoàn chỉnh của Data Locker. Các tùy chọn cài đặt điểm đích độc lập với nhau.  Trong quản lý các điểm đích, hãy xem xét như sau:

  • Để quản lý một điểm đích, trong trang cài đặt của Data Locker, mỗi điểm đích có tab cài đặt riêng. Tab mặc định là Data Locker hàng giờ.
  • Bạn phải lưu cài đặt cho mỗi điểm đích. Nói cách khác, trước khi chuyển từ tab đích này sang tab đích khác, hãy nhấp vào Save.
  • Để xóa điểm đích, hãy nhấp vào (tùy chọn), sau đó chọn Delete.
  • Khi thêm một điểm đích, bạn cần đặt tên cho điểm đích đó. Đây được gọi là ID Đăng ký.

Quy trình

Thiết lập Hộp khóa Dữ liệu

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ộ nhớ do nhà quảng cáo sở hữu:

Nếu bạn đang thiết lập Data Locker bằng cách sử dụng bộ nhớ do nhà quảng cáo sở hữu, nghĩa là bộ chứa do bạn sở hữu, hãy hoàn tất ngay một trong các quy trình sau. 

  • Bộ chứa AWS của bạn.
  • Bộ chứa GCS của bạn.

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

AppsFlyerAdmin_us-en.png Để 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 của Data Locker đang hoạt động và muốn thêm điểm đích, hãy nhấp vào +. 
  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 AppsFlyer AWS bucket (tùy chọn chỉ dành cho người đăng ký Data Locker.) Tiếp tục bước 4. 
    • Chọn Bộ chứa AWS của bạn.
      1. Nhập tên bộ chứa AWS của bạn. Không nhập tiền tố af-datalocker-.
      2. Nhấp vào Test (Thử nghiệm).
      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ệ.
    • Chọn Bộ chứa GCS của bạn, sau đó nhập tên bộ chứa GCS của bạn và cuối cùng nhấp vào kiểm tra. 
  5. 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. Chọn định dạng tệp tin:
    • [Mặc định] Parquet.
    • CSV
  7. Chọn các ứng dụng cần thiết. Chọn tất cả để tự động thêm 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] Nguồn Truyền thông: 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. Chọn các loại báo cáo cần thiết. Bạn phải chọn ít nhất là 1. 
  11. [tùy chọn] Sự kiện trong ứng dụng: Chọn các sự kiện trong ứng dụng để đư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.
  12. Nhấp vào Apply (Áp dụng). 
  13. [Không bắt buộc] Trường: Chọn các trường cần đư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.
  14. Nhấp vào Save Configuration (Lưu Cấu hình). Một trong những điều sau đây 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 Bộ chứa khách hàng: Dữ liệu sẽ được ghi vào bộ chứa của bạn trong vòng 3 giờ. 

Đặt lại thông tin đăng nhập

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.

AppsFlyerAdmin_us-en.png Để đặ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.

Thông tin bổ sung

Đặc điểm và Hạn chế

Các đặc điểm
Đặc điểm Nhận xét 
Mạng quảng cáo Không dành cho các mạng quảng cáo sử dụng
Đại lý Không dành cho các đại lý sử dụng
Múi giờ cụ thể theo ứng dụng Không áp dụng. Các thư mục Data Locker được chia theo giờ bằng giờ UTC. Các sự kiện thực tế chứa thời gian tính theo giờ UTC. Chuyển đổi thời gian sang bất kỳ múi giờ nào khác nếu cần. Bất kể múi giờ ứng dụng của bạn là gì, thì độ trễ từ khi sự kiện xảy ra cho đến khi sự kiện được ghi nhận trong Data Locker vẫn giữ nguyên.
Tiền tệ cụ thể theo ứng dụng  Không được hỗ trợ
Hạn chế về kích thước Không áp dụng
Tính cập nhật của dữ liệu Dữ liệu được cập nhật theo tần suất cập nhật dữ liệu báo cáo cụ thể được nêu chi tiết trong bài viết này
Dữ liệu lịch sử Không được hỗ trợ. Nếu bạn cần dữ liệu lịch sử, một số báo cáo sẽ có sẵn thông qua API Pull, nhưng không phải tất cả.
Truy cập của người dùng Chỉ những người dùng tài khoản có quyền cần thiết mới có thể cấu hình Data Locker. 
Ứng dụng duy nhất/đa ứng dụng Hỗ trợ đa ứng dụng. Data Locker ở cấp độ tài khoản

Xử lý sự cố

  • 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

      mceclip0.png

Truy xuất dữ liệu AWS

Sử dụng công cụ truy xuất dữ liệu AWS yêu thích của bạn, AWS CLI hoặc một trong những công cụ được mô tả trong các phần tiếp theo. Lưu ý! Các hướng dẫn chính xác phù hợp với các bộ chứa do AppsFlyer sở hữu. Điều chỉnh hướng dẫn, nếu cần, nếu bạn đang kết nối với bộ chứa của mình. 

AWS CLI

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/

Cyberduck

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 tiếp theo), hãy chọn Amazon S3.

    DataDuckSmall2.png

  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ổ, để đóng, hãy sử dụng dấu 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ình duyệt Amazon S3

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.

    mceclip0.png

  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.

    mceclip2.png

  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. 
Bài viết này có hữu ích không?

Các bài viết trong mục này