บทแนะนํา: วัด Conversion ของโฆษณา iOS

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

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

เรียกใช้ API

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

คุณเริ่มการวัดได้ 2 วิธีดังนี้

• ใช้ข้อมูลเข้าสู่ระบบ
• ใช้ข้อมูลเข้าสู่ระบบที่แฮช

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

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 จะกลายเป็น anemalluserolzs@gmail.com
• CAPSUSER0125@provider.net จะกลายเป็น capsuser0125@provider.net

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

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

เรียกใช้ 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);

ยืนยันการผสานรวม

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

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

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

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

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