บทความต่อไปนี้จะอธิบายขั้นตอนการส่งการรายงานผล Conversion ของ SKAdNetwork ไปยัง Google Analytics โดยใช้ Measurement Protocol
ขั้นตอนที่ 1: ลงทะเบียนการรายงานผล Conversion ของ SKAdNetwork สําหรับ iOS เวอร์ชันที่เกี่ยวข้อง
ดูข้อมูลเพิ่มเติมจากเอกสารประกอบของ Apple สําหรับลูกค้าที่ใช้ SDK ของ Google Analytics สําหรับ Firebase ชุดพัฒนาซอฟต์แวร์นี้จะลงทะเบียนโดยอัตโนมัติในนามของแอป ซึ่งคุณข้ามขั้นตอนนี้ได้
ขั้นตอนที่ 2: ตรวจสอบว่าคุณได้รับและถอดรหัสการรายงานผล Conversion ของ SKAdNetwork
ดูข้อมูลเพิ่มเติมจากเอกสารประกอบของ Apple หากยังไม่ได้ตั้งค่าปลายทาง SKAdNetwork ให้ตั้งค่าโดยทำตามเอกสารประกอบของ Apple
หมายเหตุ: ปัจจุบันยังกําหนดค่า Google Analytics 4 เป็นปลายทางไม่ได้
หากตั้งค่าปลายทางกับ App Attribution Partner (AAP) ที่ Google อนุมัติหรือโซลูชันภายในแล้ว ให้ข้ามไปยังขั้นตอนที่ 3 ซึ่งอธิบายขั้นตอนการนําผลลัพธ์ไปยัง Google Analytics โดยใช้ Measurement Protocol
ขั้นตอนที่ 3: ส่งผลลัพธ์จากระบบรายงานผล Conversion ไปยัง Google Analytics โดยตรงด้วย Measurement Protocol
ขั้นตอนนี้ทําได้โดยส่งเหตุการณ์ campaign_details ที่กําหนดเองไปยัง Google Analytics ผ่าน Measurement Protocol โดยใช้สคีมาต่อไปนี้ (ตัวอย่าง Codelab)
การติดตั้งใช้งาน Measurement Protocol ของ SKAdNetwork ใน Google Analytics 4
ต้องระบุพารามิเตอร์ทั้งหมด เว้นแต่จะระบุเป็นไม่บังคับ
พารามิเตอร์ระดับคําขอ
| พารามิเตอร์ |
ข้อมูลเพิ่มเติม |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {timestamp of received SKAN postback} |
-
ไม่บังคับ แต่หากระบุ ต้องอยู่ในช่วง 72 ชั่วโมงที่ผ่านมา หากไม่ระบุ ระบบจะใช้การประทับเวลาการเก็บรวบรวม
-
กรอบเวลาเหตุการณ์สําคัญใน Google Analytics 4 ของเหตุการณ์การได้ผู้ใช้ใหม่คือ 30 วัน คุณต้องส่งการรายงานผล Conversion โดยเร็วที่สุดเพื่อให้การรายงานแม่นยํามากขึ้น
|
| app_instance_id: {...} |
ต้องระบุ สร้างสตริงเลขสุ่มที่ไม่ซ้ำกัน ระบบจะทิ้งสตริงรหัสเฉพาะนี้เพื่อใช้รหัสอินสแตนซ์ของแอปจริงเมื่อมีการใช้ข้อมูลนี้ในการประมาณ Conversion
|
เหตุการณ์ GA
| เหตุการณ์ |
ข้อมูลเพิ่มเติม |
| campaign_details |
เหตุการณ์ที่กำหนดเอง |
พารามิเตอร์ GA (ที่มีอยู่)
| พารามิเตอร์ |
ข้อมูลเพิ่มเติม |
| source: {source} |
พารามิเตอร์เหล่านี้ใช้ในการติดแท็กด้วยตัวเอง การวางโครงสร้างการรายงาน Google Analytics 4 ใช้การจัด Channel Group เริ่มต้นของ Google Analytics 4 ซึ่งเราขอแนะนําให้ใช้เป็นแนวทางในการจัดหมวดหมู่พารามิเตอร์แต่ละรายการ ส่งพารามิเตอร์เหล่านี้สําหรับระบบรายงานผล Conversion ทั้งหมดที่ไม่ใช่ของ Google
ตัวอย่าง
ระบบรายงานผล Conversion ของ Facebook
- ที่มา: facebook
- สื่อ: cpc|cpm
- เนื้อหา: ad_version_name
- แคมเปญ: Facebook Spring 22 Campaign
- รหัสแคมเปญ: ตามที่มีอยู่จากระบบรายงานผล Conversion ของ SKAN
สําหรับระบบรายงานผล Conversion ของ Google เราจะถอดรหัสแคมเปญตามการผสานรวมพร็อพเพอร์ตี้กับ Google Ads พารามิเตอร์ข้างต้นจึงเป็นแบบไม่บังคับสําหรับระบบรายงานผล Conversion ของ Google คุณต้องตรวจสอบว่าพร็อพเพอร์ตี้ Google Analytics 4 ลิงก์กับบัญชีโฆษณา Google Ads
หมายเหตุ: คุณต้องส่งการรายงานผล Conversion ของ SKAdNetwork ทั้งหมดไปยัง Google Analytics 4 ไม่ใช่เพียงการรายงานของผู้ให้บริการรายอื่นที่ไม่ใช่ Google |
| medium: {medium} |
| term: {term} ไม่บังคับ |
| content: {content} ไม่บังคับ |
| campaign_id: {campaign_id} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork |
| campaign: {campaign} ไม่บังคับ แต่หากไม่ระบุจะแสดงเป็น (not set) |
สําหรับแคมเปญ Google Ads เราจะถอดรหัสรหัสและกำหนดชื่อให้แคมเปญตามการลิงก์ Google Analytics กับ Google Ads รวมถึงอัปเดตพารามิเตอร์แหล่งที่มาและสื่อ หากบัญชีไม่ได้ลิงก์ เราจะไม่ถอดรหัสรหัสแคมเปญ Google และจะใช้พารามิเตอร์แหล่งที่มาและสื่อที่ระบุ
สําหรับแคมเปญที่ไม่ใช่แคมเปญ Google Ads คุณถอดรหัสและระบุชื่อแคมเปญได้ หากไม่ทราบ ให้คัดลอก campaign_id ของ SKAdNetwork
หมายเหตุ: หากไม่ได้ระบุ ระบบจะแสดงเป็น (not set)
|
| source_platform: “apple_skan” |
สําคัญ: คุณต้องระบุสตริงนี้อย่างชัดเจน โดยใช้อักษรตัวพิมพ์ใหญ่และ _ |
| app_id: {app_id} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork ซึ่งจะเป็นรหัส App Bundle ของคุณ
|
| transaction_id: {transaction_id} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork |
พารามิเตอร์ใหม่ที่จําเป็น
หมายเหตุ: พารามิเตอร์ใหม่เหล่านี้สามารถตั้งค่าในอินเทอร์เฟซผู้ใช้ Google Analytics 4 แต่ไม่จําเป็น หากต้องการดูการรายงานมิติข้อมูลที่กําหนดเองซึ่งเจาะจงตามพารามิเตอร์ดังกล่าว คุณต้องลงทะเบียนพารามิเตอร์ใน Google Analytics 4
| พารามิเตอร์ |
ข้อมูลเพิ่มเติม |
| version: {version} |
ค่าจากการรายงานผล Conversion ของ SKAdNetwork |
| conversion_value: {conversion_value} |
ค่าจากการรายงานผล Conversion ของ SKAdNetwork |
| fidelity_type: {fidelity_type} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork |
| attribution_signature: {attribution_signature} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork
หมายเหตุ: นี่คือฟีเจอร์ความปลอดภัย การรายงานผล Conversion ของ SKAdNetwork จะได้รับการเข้ารหัส
|
| redownload: {redownload} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork |
| source_app_id: {source_app_id} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork
หมายเหตุ: นี่คือรหัสของแอปซึ่งมีการคลิกโฆษณาที่ทําให้เกิดการติดตั้ง
|
| did_win: {did_win} |
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork
หมายเหตุ: ผู้ลงโฆษณาจะได้รับเฉพาะการรายงานผล Conversion ที่ชนะเท่านั้น ส่วน AdTech จะได้รับการรายงานผล Conversion ที่ชนะและการรายงานผล Conversion รอง/สนับสนุน
|
|
ad_network_id: {ad_network_id}
{ad_network_id} จะแสดงค่าในระบบรายงานผล Conversion
|
ค่าจากระบบรายงานผล Conversion ของ SKAdNetwork
พารามิเตอร์นี้แสดงเครือข่ายโฆษณาที่แสดงโฆษณาของคุณ ซึ่งเป็นข้อมูลที่มีประโยชน์สําหรับมิติข้อมูลการเข้าชม "แหล่งที่มา" เช่นกัน
|
ขั้นตอนที่ 4: ยืนยันว่าได้รับ Hit จากแพลตฟอร์มการตลาด
เหตุการณ์ campaign_details ไม่ได้แสดงใน Google Analytics โดยตรง แต่การรายงานผล Conversion ของ SKAdNetwork จะเปลี่ยนเป็นเหตุการณ์และผสานรวมเข้ากับเหตุการณ์สำคัญ first_open และการรายงานเหตุการณ์ ซึ่งคุณแบ่งกลุ่มออกได้โดยเพิ่มแพลตฟอร์มแหล่งที่มาของมิติข้อมูล (แพลตฟอร์มแหล่งที่มา = SKAN)
หากต้องการยืนยันว่ามีการส่ง Hit เราขอแนะนําให้บันทึกเหตุการณ์การทดสอบด้วยการทำซ้ำเหตุการณ์ campaign_details โดยใช้ชื่อเหตุการณ์อื่น (เช่น campaign_details_skan_test) จากนั้นคุณจะยืนยันได้ว่าเหตุการณ์ทดสอบปรากฏในรายงานแบบเรียลไทม์ของ Google Analytics 4 หากคุณบันทึกเหตุการณ์และพารามิเตอร์ทดสอบ เหตุการณ์และพารามิเตอร์ดังกล่าวจะแสดงในการรายงานเฉพาะกิจเพิ่มเติมจากแบบเรียลไทม์
หมายเหตุ
- หากต้องการให้การรายงานผล Conversion ของ SKAdNetwork แสดงในการรายงาน คุณต้องบันทึกเหตุการณ์และพารามิเตอร์ที่ซ้ำกันดังที่ระบุข้างต้นด้วย นอกเหนือจากส่งแต่ละรายการเป็นเหตุการณ์
campaign.details หากคุณเลือกที่จะทำเช่นนี้ ก็ยังคงต้องมีการส่งการรายงานผล Conversion ของ SKAdNetwork โดยใช้เหตุการณ์ campaign.details มิฉะนั้น Google Analytics จะไม่จดจําและทำการประมาณ Conversion เพื่อปรับปรุงการรายงาน first_open ของ iOS ไม่ได้
- คุณต้องส่งการรายงานผล Conversion ของ SKAdNetwork ภายใน 4 วันหลังจากที่ได้รับ เพื่อให้ Google Analytics นำไปใช้ประโยชน์ในการประมาณและการรายงาน Conversion ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับขั้นตอนการยืนยันทั่วไป