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

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


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

ขั้นตอนที่ 1: ใช้ประสบการณ์การลงชื่อเข้าใช้

ขั้นตอนที่ 2: ผสานรวม Google Analytics

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

ขั้นตอนที่ 4 แก้ปัญหาที่พบบ่อย


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

เรียก API

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

การเริ่มการวัดผลทำได้ 2 วิธีดังนี้

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

Swift

นําเข้าโมดูล FirebaseAnalytics และส่งอีเมลหรือหมายเลขโทรศัพท์ไปยัง initiateOnDeviceConversionMeasurement() API

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")

Objective-C

นําเข้าโมดูล FirebaseAnalytics และส่งอีเมลไปยัง initiateOnDeviceConversionMeasurementWithEmailAddress: API หรือส่งหมายเลขโทรศัพท์ไปยัง initiateOnDeviceConversionMeasurementWithPhoneNumber: API

@import FirebaseAnalytics;

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

Unity

นำเข้าเนมสเปซ Firebase.Analytics และส่งไปยังอีเมลไปยัง InitiateOnDeviceConversionMeasurementWithEmailAddress() API หรือหมายเลขโทรศัพท์ไปยัง InitiateOnDeviceConversionMeasurementWithPhoneNumber() API ดังนี้

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
      • ใช้ตัวอักษร s แทนตัวเลข 5

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

  • an.email.user0125@googlemail.com เปลี่ยนเป็น anemalluserolzs@gmail.com
  • CAPSUSER0125@provider.net เปลี่ยนเป็น capsuser0125@provider.net

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

เรียก API ด้วยข้อมูลเข้าสู่ระบบที่ผ่านการแฮช

Swift

นําเข้าโมดูล FirebaseAnalytics และส่งอีเมลหรือหมายเลขโทรศัพท์ไปยัง initiateOnDeviceConversionMeasurement() 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)

Objective-C

นําเข้าโมดูล FirebaseAnalytics และส่งอีเมลไปยัง initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API หรือส่งหมายเลขโทรศัพท์ไปยัง initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API

@import FirebaseAnalytics;

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

Unity

นำเข้าเนมสเปซ Firebase.Analytics และส่งไปยังอีเมลไปยัง InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API หรือหมายเลขโทรศัพท์ไปยัง InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API ดังนี้

using Firebase.Analytics;

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

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

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

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




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