So khớp nâng cao

Tài liệu này giải thích cách gửi dữ liệu sự kiện trong ứng dụng của người dùng cho Facebook để So khớp nâng cao. Thông tin này sẽ được băm trước khi được chia sẻ với chúng tôi. Chúng tôi sẽ sử dụng thông tin dạng băm để tăng tính chính xác khi xác định những người nào thực hiện hành động sau khi xem quảng cáo của bạn. Với dữ liệu này, Facebook có thể so khớp các sự kiện chuyển đổi với khách hàng của bạn nhằm tối ưu hóa quảng cáo và xây dựng lượng đối tượng tiếp thị lại đông đảo hơn.

Sau khi so khớp, Facebook sẽ bỏ ngay dữ liệu dạng băm.

Bạn có thể thiết lập tính năng So khớp nâng cao bằng một trong các phương thức sau đây:

• Facebook SDK - Thêm mã vào ứng dụng di động Android hoặc iOS để gửi dữ liệu cho Facebook theo cách thủ công.
• API Sự kiện trong ứng dụng trên Facebook - Thêm truy vấn vào mã để gửi dữ liệu cho Facebook theo cách thủ công.
• Trình quản lý sự kiện - Đặt cấu hình ứng dụng trong bảng điều khiển Trình quản lý sự kiện để bật tính năng So khớp nâng cao tự động nhằm gửi dữ liệu cho Facebook.
• Mobile Measurement Partners (MMP) SDK - Thêm mã vào ứng dụng Android hoặc iOS để gửi dữ liệu cho bảng điều khiển Adjust.

Sử dụng Facebook SDK

Khi sử dụng Facebook SDK để gửi dữ liệu sự kiện trong ứng dụng của người dùng cho Facebook, tất cả dữ liệu người dùng sẽ được băm. Dữ liệu dạng băm này tồn tại giữa các phiên bản ứng dụng.

Yêu cầu

• Facebook SDK 4.36 trở lên

Android

Đặt dữ liệu người dùng khi khởi chạy AppEventsLogger bằng hàm setUserData. Hàm này sẽ băm dữ liệu người dùng.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

iOS

Đặt dữ liệu người dùng khi khởi chạy FBSDKAppEvents bằng hàm setUserData . Dữ liệu người dùng sẽ được băm và tồn tại giữa các phiên bản ứng dụng.

Đề xuất

• Để đảm bảo tính năng So khớp nâng cao hoạt động đúng cách, bạn nên nâng cấp Facebook SDK dành cho iOS lên phiên bản mới nhất. Hãy xem Nhật ký thay đổi của iOS SDK để biết thêm thông tin.

Mã mẫu để thiết lập một loại dữ liệu

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

Mã mẫu để để thiết lập nhiều loại dữ liệu

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

Sử dụng Trình quản lý sự kiện

Tính năng So khớp nâng cao tự động sẽ tự động đặt cấu hình Facebook SDK để phát hiện và nhận dữ liệu người dùng cùng với sự kiện hoặc hành động xảy ra trong ứng dụng của bạn. Dữ liệu này được băm trước khi gửi cho Facebook.

Để bật tính năng So khớp nâng cao tự động, hãy truy cập vào Trình quản lý sự kiện, chọn tab Cài đặt của ứng dụng và chuyển So khớp nâng cao tự động thành BẬT. Bạn cũng có thể chia sẻ địa chỉ email và số điện thoại dạng băm.

Lưu ý: Bạn phải triển khai Facebook SDK 5.8.0 trở lên.

Sử dụng Adjust SDK

Thêm dữ liệu khách hàng vào sự kiện trên Adjust

Khi sử dụng Mobile Measurement Partners (MMP) SDK của Adjust, vui lòng dùng hàm băm như minh họa trong ví dụ dưới đây vì MMP SDK sẽ không tự động băm dữ liệu. Nếu bạn không sử dụng hàm băm, API của chúng tôi sẽ trả về ngoại lệ và không chấp nhận văn bản thuần túy.

Thêm các thông số dữ liệu khách hàng sẽ chuyển cho đối tác mạng, đã được kích hoạt trong bảng điều khiển Adjust bằng cách gọi phương thức addPartnerParameter trên phiên bản ADJEvent của bạn.

Lưu ý: Bạn không cần phải triển khai Facebook SDK.

Mã mẫu dành cho Android

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

Mã mẫu dành cho iOS

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

Để biết thêm thông tin, vui lòng xem ví dụ về Mã Github.

Đối ghép thông số của Adjust với thông số của Facebook

Làm theo các bước sau đây để đối ghép thông số của Adjust với thông số của Facebook trong bảng điều khiển Adjust.

1. Trong bảng điều khiển Adjust, hãy nhấp vào mục Cài đặt của ứng dụng mà bạn muốn đối ghép thông số của đối tác.
2. Chọn Thiết lập đối tác.
3. Nhấp vào đối tác mong muốn.
4. Chọn Đối ghép thông số của đối tác.
5. Nhập tên thông số của đối tác mà Adjust nhận được thông qua SDK vào cột TỪ ỨNG DỤNG ở bên trái. Tên này phải giống nhau giữa các đối tác. Ví dụ: nếu bạn đang dùng tên thông số là email trong Adjust SDK, hãy nhập "email".
6. Nhập tên thông số của đối tác như mong muốn của đối tác này vào cột ĐẾN ĐỐI TÁC ở bên phải. Đây là tên cụ thể của đối tác. Thông số dùng trong Facebook SDK phải có định dạng là ud[pii_type_name]. Ví dụ: "email" phải có dạng ud[em], số điện thoại phải ở dạng ud[ph].

Để biết thêm thông tin, vui lòng xem Tài liệu về Adjust.