บทช่วยสอน: วัด Conversion ของโฆษณา iOS

ขั้นตอนที่ 3: เริ่มต้นการวัด Conversion บนอุปกรณ์โดยใช้ Google Analytics

ตอนนี้คุณสามารถรวบรวมที่อยู่อีเมลและหมายเลขโทรศัพท์ของผู้ใช้ได้ และแอปของคุณมี Google Analytics สำหรับ Firebase SDK แล้ว คุณสามารถใช้ทั้งสองเพื่อเริ่มวัด Conversion ได้

เรียก API

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

มีสองวิธีในการเริ่มต้นการวัด:

• การใช้ข้อมูลรับรอง
• การใช้ข้อมูลประจำตัวที่แฮช

ใช้ที่อยู่อีเมลหรือหมายเลขโทรศัพท์

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

ใช้ที่อยู่อีเมลหรือหมายเลขโทรศัพท์ที่แฮช

API จะยอมรับที่อยู่อีเมลและหมายเลขโทรศัพท์ที่แฮชด้วย SHA256 คุณสามารถรักษาการควบคุมข้อมูลผู้ใช้ของคุณได้โดยทำการแฮชในโค้ดของคุณก่อนที่จะทำการเรียกไปยัง SDK

หากต้องการใช้ข้อมูลประจำตัวที่แฮช ให้ทำให้ที่อยู่และตัวเลขเป็นมาตรฐาน แฮชด้วย SHA256 จากนั้นเรียกใช้ API

ปรับที่อยู่อีเมลและหมายเลขโทรศัพท์ให้เป็นมาตรฐาน

สำหรับ ที่อยู่อีเมล Google Analytics API จะถือว่ามีการดำเนินการทำให้เป็นมาตรฐานก่อนที่จะใช้ SHA256 ดังนั้นให้ทำตามขั้นตอนเหล่านี้เพื่อทำให้ข้อมูลของคุณเป็นมาตรฐาน:

1. แปลงที่อยู่อีเมลทั้งหมดเป็นตัวพิมพ์เล็ก

2. หากที่อยู่อีเมลลงท้ายด้วยโดเมน @googlemail.com ให้แทนที่โดเมน @googlemail.com ด้วย @gmail.com

3. สำหรับที่อยู่ที่ลงท้ายด้วยโดเมน @gmail.com (รวมถึงที่แก้ไขในขั้นตอนก่อนหน้า):

   1. ลบช่วงเวลาทั้งหมดออกจากส่วนชื่อผู้ใช้

   2. ทำการทดแทนต่อไปนี้ในส่วนชื่อผู้ใช้:

      • สำหรับตัวอักษร I หรือ i หรือหลัก 1 ให้ใช้ตัวอักษร l แทน
      • สำหรับเลข 0 ให้ใช้ตัวอักษร o แทน
      • สำหรับหลักที่ 2 ให้ใช้ตัวอักษร z แทน
      • สำหรับหลัก 5 ให้ใช้ตัวอักษร s แทน

ตัวอย่างเช่น หลังจากการทำให้เป็นมาตรฐาน:

• an.email.user0125@googlemail.com กลายเป็น anemlluserolzs@gmail.com
• CAPSUSER0125@provider.net กลายเป็น capsuser0125@provider.net

สำหรับ หมายเลขโทรศัพท์ ตัวเลขต้องอยู่ในรูปแบบ E.164 อยู่แล้ว (นั่นคือ นำหน้าด้วย +, 1-3 หลักสำหรับรหัสประเทศ, สูงสุด 12 หลักสำหรับหมายเลขสมาชิก) ก่อนที่จะแฮชด้วย SHA256

เรียก API ด้วยข้อมูลประจำตัวที่แฮช

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

ตรวจสอบด้วยบันทึกการแก้ไขข้อบกพร่อง Xcode (ไม่บังคับ)

หากคุณเปิดใช้งานโหมดแก้ไขข้อบกพร่อง หลังจากเรียกใช้ API การวัดแล้ว ตรวจสอบให้แน่ใจว่าข้อความเช่นข้อความบันทึกต่อไปนี้ปรากฏในคอนโซลดีบัก Xcode:

9.0.0 - [FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

ใน Firebase 9.6.0 หรือใหม่กว่า หากคุณเปิดใช้งานโหมดแก้ไขข้อบกพร่องและรวมอาร์กิวเมนต์การเปิดใช้ -DebugOnDeviceConversionMeasurement การเรียก initiateOnDeviceConversionMeasurement() API จะจำลองการจับคู่

9.6.0 - [FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

arrow_back_ios ขั้นตอนที่ 2 : รวม Google Analytics ขั้นตอนที่ 4 : แก้ไขปัญหาและจัดการปัญหาทั่วไป arrow_forward_ios