API คอนเวอร์ชั่นสำหรับเหตุการณ์ในแอพ
API คอนเวอร์ชั่นช่วยให้ผู้ลงโฆษณาสามารถส่งเหตุการณ์การส่งข้อความบนเว็บ ในแอพ ที่หน้าร้าน และในธุรกิจไปยัง Meta ผ่านตำแหน่งข้อมูลเดียว แทนที่จะต้องใช้หลายแหล่ง การรวมข้อมูลเช่นนี้จะช่วยลดความซับซ้อนของสแต็กเทคโนโลยีของผู้ลงโฆษณา และสร้างมุมมองที่ครอบคลุมมากขึ้นภายในตัวจัดการเหตุการณ์ของ Meta โดยใช้ชุดข้อมูล
เอกสารฉบับนี้จะให้คำแนะนำในการผสานการทำงานเหตุการณ์ในแอพเข้ากับ API คอนเวอร์ชั่น
ข้อกำหนดเบื้องต้น
1. ชุดข้อมูล
เหตุการณ์ในแอพที่ส่งผ่าน API คอนเวอร์ชั่นจะต้องเชื่อมโยงกับชุดข้อมูล
Datasets allow advertisers to connect and manage event data from web, app, store and business messaging event sources to the Conversions API. Datasets may show event data from any of these integrations that you choose to set up:
- Meta Pixel (website events)
- App Events API (app events, including Facebook SDK for iOS or Android, mobile measurement partners (MMPs))
- Offline Conversions API (Meta’s legacy API for offline events)
- Messaging Events API (messaging events)
Datasets enable you to view all customer activities from a single interface. They also allow you to reduce the effort to build and maintain multiple API integrations.
In Events Manager, advertisers have different options to create a dataset depending on their starting point. Or you can create a brand new dataset in Events Manager by linking during offline event set creation or through an existing mobile app or during messaging event set creation information. Note that linking a dataset to an application is required before sending mobile app events to the Conversions API and only one application can be linked to a dataset. See more details and instructions here.
คุณสามารถเรียกใช้ GET ไปยัง https://graph.facebook.com/v16.0/{ads-pixel-id}/is_consolidated_container เพื่อตรวจสอบว่าชุดข้อมูลของผู้ลงโฆษณาถูกรวมเข้าด้วยกันและมีสิทธิ์ส่งเหตุการณ์ในแอพผ่าน API คอนเวอร์ชั่นหรือไม่
2. สิทธิ์การอนุญาต
การกำหนดค่า
การส่งเหตุการณ์ในแอพไปยัง API คอนเวอร์ชั่น
a. การลิงก์ ID ชุดข้อมูลและ ID ของแอพ
ในตัวจัดการเหตุการณ์ จะมีวิธีลิงก์แอพของคุณกับชุดข้อมูลอยู่ 2 วิธีดังนี้
- เลือกแท็บ "แหล่งข้อมูล" ค้นหาแท็บ "การตั้งค่า" ของแอพ แล้วทำการลิงก์
- ในแท็บ "ภาพรวม" ของแอพ ให้เลือกแท็บ "แหล่งข้อมูล" จากนั้นให้ใช้ปุ่ม "ลิงก์กับชุดข้อมูล" ในส่วน "กิจกรรมทั้งหมด"
เมื่อคุณลิงก์เสร็จแล้ว ชุดข้อมูลจะมีแอพที่เชื่อมต่อด้วย
b. ช่องที่ต้องระบุ
คุณสามารถดูชุดพารามิเตอร์ปัจจุบันที่สามารถส่งผ่าน API คอนเวอร์ชั่นได้ที่นี่ สำหรับการส่งเหตุการณ์ในแอพ คุณสามารถแชร์ช่อง server_event ต่อไปนี้ในเพย์โหลด
- พารามิเตอร์
action_sourceต้องมีค่าappสำหรับเหตุการณ์ในแอพ - ต้องระบุ
event_idสำหรับกรณีการตั้งค่าการลบเหตุการณ์ซ้ำซ้อน
ช่องข้อมูลแอพ
| Parameter | Description |
|---|---|
advertiser_tracking_enabledboolean | Required for app events Use this field to specify ATT permission on an iOS 14.5+ device. Set to |
application_tracking_enabledboolean | Required for app events A person can choose to enable ad tracking on an app level. Your SDK should allow an app developer to put an opt-out setting into their app. Use this field to specify the person's choice. Use |
extinfoobject Please use the down arrow to the right to see the list of | Required for app events Extended device information, such as screen width and height. This parameter is an array and values are separated by commas. When using Note:
|
campaign_idsstring | Optional An encrypted string and non-user metadata appended to the outbound URL (for example, ad_destination_url) or deep link (for App Aggregated Event Manager) when a user clicked on a link from Facebook. Graph API definition: Parameter passed via the deep link for Mobile App Engagement campaigns. |
install_referrerstring | Optional |
installer_packagestring | Optional Used internally by the Android SDKs |
url_schemesarray | Optional Used internally by the iOS and Android SDKs. |
windows_attribution_idstring | Optional Attribution token used for Windows 10. |
พารามิเตอร์ข้อมูลลูกค้า
| พารามิเตอร์ | คำอธิบาย |
|---|---|
anon_idสตริง | ไม่ต้องแฮช |
madidสตริง | ไม่ต้องแฮช |
ข้อมูลแบบกำหนดเอง
| พารามิเตอร์ | คำอธิบาย |
|---|---|
descriptionสตริง | ระบุหรือไม่ก็ได้ |
levelสตริง | ระบุหรือไม่ก็ได้ |
max_rating_value | ระบุหรือไม่ก็ได้ |
successบูลีน | ระบุหรือไม่ก็ได้ |
โดยสรุปแล้ว เหตุการณ์ในแอพที่แชร์โดยใช้ API คอนเวอร์ชั่นจะต้องมีพารามิเตอร์ข้อมูลต่อไปนี้
action_source: ต้องตั้งเป็น "แอพ" (เมื่อคุณใช้ API คอนเวอร์ชั่น แสดงว่าคุณยอมรับว่าพารามิเตอร์action_sourceนั้นถูกต้องตามขอบเขตความเข้าใจสูงสุดที่คุณมี)event_id: จำเป็นต้องระบุสำหรับการตั้งค่าการลบเหตุการณ์ซ้ำซ้อน โปรดดูรายละเอียดในส่วน "ตั้งค่าการลบเหตุการณ์ซ้ำซ้อนสำหรับหลายช่องทาง"
ด้านล่างนี้คือตัวอย่างของ extinfo ตรวจสอบให้แน่ใจว่าได้กรอกพารามิเตอร์ย่อยทั้งหมดด้านล่างและเรียงตามลำดับ หากมีพารามิเตอร์ใดหายไป ให้ใช้สตริงเปล่าเป็นตัวยึดตำแหน่ง
| ชื่อพารามิเตอร์รอง | จำเป็น | ประเภทข้อมูล | ตัวอย่าง |
|---|---|---|---|
เวอร์ชั่นของ extinfo | ใช่ | สตริง |
|
ชื่อแพ็คเกจแอพ | ไม่ | สตริง |
|
แบบสั้น | ไม่ | สตริง |
|
แบบยาว | ไม่ | สตริง |
|
เวอร์ชั่นของระบบปฏิบัติการ | ใช่ | สตริง |
|
ชื่อรุ่นของอุปกรณ์ | ไม่ | สตริง |
|
ภาษา | ไม่ | สตริง |
|
ตัวย่อเขตเวลา | ไม่ | สตริง |
|
ผู้ให้บริการ | ไม่ | สตริง |
|
ความกว้างของหน้าจอ | ไม่ | สตริง |
|
ความสูงของหน้าจอ | ไม่ | สตริง |
|
ความหนาแน่นของหน้าจอ | ไม่ | สตริง |
|
จำนวน Core ของ CPU | ไม่ | สตริง |
|
ขนาดของพื้นที่เก็บข้อมูลภายนอก | ไม่ | สตริง |
|
พื้นที่ว่างในขนาดของพื้นที่เก็บข้อมูลภายนอก | ไม่ | สตริง |
|
โซนเวลาของอุปกรณ์ | ไม่ | สตริง |
|
c. ตั้งค่าการลบเหตุการณ์ซ้ำซ้อนสำหรับหลายช่องทาง
จะต้องมีกลไกการลบเหตุการณ์ซ้ำซ้อนเพื่อลบการรับส่งข้อมูลเหตุการณ์ที่ซ้ำกันระหว่างการผสานการทำงาน API คอนเวอร์ชั่นและการผสานการทำงานอื่นๆ ที่มีอยู่ทั้งหมดที่คุณมีกับเหตุการณ์ในแอพ ซึ่งประกอบด้วย SDK, MMP และ API เหตุการณ์ในแอพ
สำหรับเหตุการณ์ในแอพ เราใช้ฟังก์ชั่นการลบเหตุการณ์ซ้ำซ้อนแบบเดียวกับที่มีอยู่สำหรับเหตุการณ์บนเว็บ ตรรกะจะใช้ประโยชน์จากช่อง event_id และ event_name ตามการลบเหตุการณ์ซ้ำซ้อน (เหตุการณ์ API คอนเวอร์ชั่นและ SDK / API เหตุการณ์ในแอพที่มี event_id เดียวกัน) พารามิเตอร์ event_id คือตัวระบุที่สามารถแยกความแตกต่างระหว่างเหตุการณ์ที่คล้ายกันได้โดยไม่ซ้ำกัน ID เหตุการณ์ที่ไม่ถูกต้องอาจทำให้คอนเวอร์ชั่นของคุณมีการลบเหตุการณ์ซ้ำซ้อนอย่างไม่ถูกต้อง ซึ่งส่งผลต่อการรายงานคอนเวอร์ชั่นและประสิทธิภาพของแคมเปญ
คุณสามารถดูเอกสารสำหรับผู้พัฒนาต่อไปนี้เพื่อนำการตั้งค่าการลบเหตุการณ์ซ้ำซ้อนไปใช้
นี่คือตัวอย่างวิธีลงบันทึกเหตุการณ์ที่กำหนดเอง โดยมีวิธีคือ ให้ส่งชื่อของเหตุการณ์เป็น AppEvents.Name ใน SDK สำหรับ iOS:
AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])
สำหรับเหตุการณ์การติดตั้งแอพจะมีกลไกการลบเหตุการณ์ซ้ำซ้อนอยู่แล้ว ซึ่งจะช่วยให้แน่ใจว่าในกรอบเวลา 90 วันที่ผ่านมามีการติดตั้งเพียงครั้งเดียวเท่านั้น เราจะเก็บเหตุการณ์แรกไว้และทิ้งเหตุการณ์ที่เกิดขึ้นภายหลังไม่ว่าเหตุการณ์นั้นจะมาจากแหล่งที่มาของการดำเนินการใดก็ตาม ส่วนการดำเนินการลบเหตุการณ์ซ้ำซ้อนสำหรับเหตุการณ์ในแอพที่เกี่ยวข้องกับเหตุการณ์การติดตั้งนั้นไม่มีข้อกำหนดแต่อย่างใด
d. การส่งเหตุการณ์
หากต้องการส่งเหตุการณ์ใหม่ ให้ส่งคำขอ POST ไปยัง API คอนเวอร์ชั่นจากเส้นทางนี้: https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN} เมื่อคุณโพสต์ไปยังจุดเชื่อมโยงนี้ Meta จะสร้างเหตุการณ์บนเซิร์ฟเวอร์แอพใหม่ โปรดดูรายละเอียดเพิ่มเติมที่เอกสารสำหรับผู้พัฒนาต่อไปนี้
นี่คือการภาพรวมที่แสดงให้เห็นว่าพารามิเตอร์มีการปรับให้เข้ากับสกีมาโดยรวมในเพย์โหลดอย่างไร:
** การแก้ไขปัญหา**
คุณสามารถใช้เครื่องมือช่วยเหลือเพย์โหลดเพื่อสร้างข้อมูลเพย์โหลดได้
- เลือกแหล่งที่มาของการดำเนินการ
appเมื่อสามารถทำได้ - กรอกข้อมูลกิจกรรมที่จะถูกส่งไปยัง Meta
- การดำเนินการนี้จะสร้างเพย์โหลดเหตุการณ์ ซึ่งสามารถใช้เป็นเทมเพลตสำหรับการผสานการทำงาน API คอนเวอร์ชั่นของคุณได้
ใช้เครื่องมือทดสอบเหตุการณ์ในตัวจัดการเหตุการณ์สำหรับการทดสอบ