การจับคู่ขั้นสูง

เอกสารนี้จะอธิบายวิธีส่งข้อมูลผู้ใช้ที่เป็นเหตุการณ์ในแอพของคุณไปยัง Facebook เพื่อทำการจับคู่ขั้นสูง ระบบจะแฮชข้อมูลนี้ก่อนแชร์ให้กับเรา เราใช้ข้อมูลที่แฮชเพื่อระบุให้แม่นยำยิ่งขึ้นว่ามีผู้ใช้รายใดบ้างที่ดำเนินการเพื่อตอบสนองต่อโฆษณาของคุณ ข้อมูลนี้จะช่วยให้ Facebook สามารถจับคู่เหตุการณ์คอนเวอร์ชั่นกับลูกค้าของคุณได้เพื่อปรับโฆษณาของคุณให้เหมาะสมและสร้างกลุ่มเป้าหมายที่ใหญ่ขึ้นสำหรับทำการตลาดใหม่อีกครั้ง

หลังจากจับคู่แล้ว Facebook จะยกเลิกข้อมูลที่แฮชทันที

คุณสามารถตั้งค่าการจับคู่ขั้นสูงได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้

• Facebook SDK – เพิ่มโค้ดไปยังแอพมือถือสำหรับ Android หรือ iOS เพื่อส่งข้อมูลไปยัง Facebook ด้วยตนเอง
• API เหตุการณ์ในแอพของ Facebook - เพิ่มการสืบค้นลงในโค้ดของคุณเพื่อส่งข้อมูลไปยัง Facebook ด้วยตนเอง
• ตัวจัดการเหตุการณ์ – กำหนดค่าแอพของคุณในแดชบอร์ดตัวจัดการเหตุการณ์เพื่อเปิดการจับคู่ขั้นสูงแบบอัตโนมัติเพื่อส่งข้อมูลไปยัง Facebook
• SDK สำหรับพาร์ทเนอร์ด้านการวัดผลบนอุปกรณ์มือถือ (MMP) – เพิ่มโค้ดไปยังแอพ Android หรือ iOS เพื่อส่งข้อมูลไปยังแดชบอร์ด Adjust ของคุณ

การใช้ Facebook SDK

เมื่อใช้ Facebook SDK เพื่อส่งข้อมูลเหตุการณ์ในแอพของผู้ใช้ไปยัง Facebook ระบบจะแฮชข้อมูลผู้ใช้ทั้งหมด และข้อมูลที่แฮชนี้จะคงอยู่ระหว่างอินสแตนซ์ของแอพ

ข้อกำหนด

• Facebook SDK 4.36 ขึ้นไป

Android

ตั้งค่าข้อมูลผู้ใช้ขณะเริ่มต้น AppEventsLogger ด้วยฟังก์ชั่น setUserData ฟังก์ชั่นนี้จะแฮชข้อมูลผู้ใช้

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

ตั้งค่าข้อมูลผู้ใช้ขณะเริ่มต้น FBSDKAppEvents ด้วยฟังก์ชั่น setUserData ระบบจะแฮชข้อมูลผู้ใช้และข้อมูลนี้จะคงอยู่ระหว่างอินสแตนซ์ของแอพ

คำแนะนำ

• เราขอแนะนำให้อัพเกรด Facebook SDK สำหรับ iOS เป็นเวอร์ชั่นล่าสุดเพื่อให้แน่ใจว่าการจับคู่ขั้นสูงทำงานอย่างถูกต้อง โปรดดูข้อมูลเพิ่มเติมที่บันทึกการเปลี่ยนแปลงของ SDK สำหรับ iOS

ตัวอย่างโค้ดสำหรับตั้งค่าข้อมูลประเภทเดียว

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

ตัวอย่างโค้ดสำหรับตั้งค่าข้อมูลหลายประเภท

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"]];

ใช้ตัวจัดการเหตุการณ์

การจับคู่ขั้นสูงแบบอัตโนมัติจะกำหนดค่า Facebook SDK ของคุณโดยอัตโนมัติเพื่อตรวจหาและรับข้อมูลผู้ใช้พร้อมกับเหตุการณ์หรือการดำเนินการที่เกิดขึ้นในแอพของคุณ ระบบจะแฮชข้อมูลนี้ก่อนส่งไปยัง Facebook

หากต้องการเปิดการจับคู่ขั้นสูงแบบอัตโนมัติ ให้ไปที่ตัวจัดการเหตุการณ์ เลือกแท็บการตั้งค่าของแอพ แล้วเปิดการจับคู่ขั้นสูงแบบอัตโนมัติ นอกจากนี้ คุณยังสามารถแชร์อีเมลและหมายเลขโทรศัพท์ที่แฮชได้ด้วย

โปรดทราบว่าคุณต้องใช้ Facebook SDK 5.8.0 ขึ้นไป

ใช้ Adjust SDK

เพิ่มข้อมูลลูกค้าไปยังเหตุการณ์ของ Adjust

เมื่อใช้ SDK สำหรับพาร์ทเนอร์ด้านการวัดผลบนอุปกรณ์มือถือ (MMP) ของ Adjust โปรดใช้ฟังก์ชั่นการแฮชตามที่แสดงในตัวอย่างด้านล่าง เนื่องจาก SDK สำหรับ MMP จะไม่แฮชโดยอัตโนมัติ API ของเราจะแสดงข้อผิดพลาดขึ้นมาและไม่ยอมรับข้อความธรรมดา หากคุณไม่ใช้ฟังก์ชั่นการแฮช

เพิ่มพารามิเตอร์ข้อมูลลูกค้าที่จะส่งไปยังพาร์ทเนอร์เครือข่าย ซึ่งเปิดใช้งานแล้วในแดชบอร์ด Adjust ของคุณ โดยเรียกใช้เมธอด addPartnerParameter ในอินสแตนซ์ ADJEvent

โปรดทราบว่าคุณไม่จำเป็นต้องใช้ Facebook SDK

ตัวอย่างโค้ด Android

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

ตัวอย่างโค้ด iOS

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

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

[Adjust trackEvent:event];

โปรดดูข้อมูลเพิ่มเติมที่ตัวอย่างโค้ด Github

แมปพารามิเตอร์ของ Adjust กับพารามิเตอร์ของ Facebook

ใช้ขั้นตอนต่อไปนี้เพื่อแมปพารามิเตอร์ของ Adjust กับพารามิเตอร์ของ Facebook ในแดชบอร์ด Adjust

1. ในแดชบอร์ด Adjust ให้คลิกที่การตั้งค่าของแอพที่คุณต้องการแมปพารามิเตอร์ของพาร์ทเนอร์
2. เลือกการตั้งค่าพาร์ทเนอร์
3. คลิกเลือกพาร์ทเนอร์ที่คุณสนใจ
4. เลือกการแมปพารามิเตอร์พาร์ทเนอร์
5. ป้อนชื่อพารามิเตอร์พาร์ทเนอร์ตามที่ SDK ได้ส่งไปยัง Adjust ในคอลัมน์ "FROM APP" ทางด้านซ้าย ส่วนนี้ควรจะเหมือนกันสำหรับทุกพาร์ทเนอร์ ตัวอย่างเช่น หากคุณใช้ email เป็นชื่อพารามิเตอร์ใน Adjust SDK ให้ป้อน “อีเมล”
6. ป้อนชื่อพารามิเตอร์พาร์ทเนอร์ตามที่พาร์ทเนอร์รายนี้ต้องการในคอลัมน์ TO PARTNER ทางด้านขวา ส่วนนี้จะแตกต่างกันไปสำหรับพาร์ทเนอร์แต่ละราย โดยพารามิเตอร์ที่ใช้ใน Facebook SDK ควรอยู่ในรูปแบบ ud[pii_type_name] ตัวอย่างเช่น “อีเมล” ควรใช้ ud[em] ส่วน “โทรศัพท์” ควรใช้ ud[ph]

โปรดดูข้อมูลเพิ่มเติมที่เอกสารประกอบของ Adjust