หน้านี้ได้รับการแปลโดย Cloud Translation API

เครื่องมือวัด Conversion ของแอปและรีมาร์เก็ตติ้ง - ข้อกําหนดของคําขอ/การตอบสนอง

User-Agent ของแอป

เราได้พัฒนาข้อกำหนดที่ได้มาตรฐานสำหรับส่วนหัว User-Agent ที่ผลิตภัณฑ์วิเคราะห์/โฆษณาส่งในนามของผู้ใช้แอป ซึ่งเป็นส่วนหนึ่งของความพยายามในวงกว้างเพื่อต่อสู้กับสแปม User-Agent ของแอปสามารถได้มาจากโค้ดแบบเนทีฟเพื่อ ปฏิบัติตามข้อกำหนดต่อไปนี้

name version (os_and_version; locale; device; build; Proxy)

คำจำกัดความของฟิลด์เหล่านี้มีดังนี้

คอมโพเนนต์ของ User-Agent
`name`	ชื่อผลิตภัณฑ์ Analytics/Ads (`Google AdMob`) โปรดทราบว่าหากสร้าง User Agent ในฝั่งไคลเอ็นต์ `name` ควรเป็น Bundle ID ของแอปไคลเอ็นต์แทน Android // Specified by API consumer. iOS // Specified by API consumer.
`version`	เวอร์ชันของผลิตภัณฑ์ข้อมูลวิเคราะห์/โฆษณา (`7.10.1`) Android // Specified by API consumer. iOS // Specified by API consumer.
`os_and_version`	ระบบปฏิบัติการและเวอร์ชันของระบบปฏิบัติการที่แอป ทำงานอยู่ (`Android 6.0` ) Android String osAndVersion = "Android " + Build.VERSION.RELEASE; iOS UIDevice uid = [UIDevice currentDevice]; NSString osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]];
`locale`	แท็กภาษา IETF สำหรับอุปกรณ์ โดยใช้รหัสภาษาและรหัสประเทศ 2 ตัวอักษรที่คั่นด้วยขีดล่าง (`en_US`) Android String locale = Locale.getDefault(); iOS NSString *locale = [[NSLocale currentLocale] localeIdentifier]
`device`	ชื่อของอุปกรณ์จริงที่เรียกใช้ผลิตภัณฑ์ Analytics/Ads (`iPhone9,1`) Android String device = Build.MODEL; iOS @import Darwin.sys.sysctl; NSString device(void) { size_t bufferSize = 64; NSMutableData buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("hw.machine", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; }
`build`	"Build/" ตามด้วยหมายเลขบิลด์ของระบบปฏิบัติการ (`Build/13D15`) Android String build = "Build/" + Build.ID; iOS @import Darwin.sys.sysctl; NSString build(void) { size_t bufferSize = 64; NSMutableData buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("kern.osversion", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; }

รวมเฉพาะ ; Proxy ที่ส่วนท้ายของ User-Agent ของแอปเมื่อสร้าง User-Agent ของแอปในฝั่งเซิร์ฟเวอร์ หาก User-Agent ของแอปสร้างขึ้นที่ฝั่งไคลเอ็นต์ทั้งหมด ให้ยกเว้น ; Proxy ดังนั้น User-Agent ของแอปอาจเป็นดังนี้

Android : AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
iOS: AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)

คู่มือคำขอเครื่องมือวัด Conversion

จุดประสงค์ของคำขอเครื่องมือวัด Conversion คือการแจ้งให้ Google Ads ทราบถึงเหตุการณ์ในแอป ที่ควรติดตามเป็น Conversion และ/หรือใช้เพื่อสร้างรายการ รีมาร์เก็ตติ้ง รวมถึงเพื่อดึงข้อมูลเมตาที่อธิบายการคลิกใดๆ ที่เกิดขึ้นก่อน เหตุการณ์

การเรียก API ทั้งหมดจะดำเนินการกับโดเมน www.googleadservices.com คำขอ Conversion คือคำขอ POST ผ่าน HTTPS ในเส้นทางต่อไปนี้

/pagead/conversion/app/version

โดย version คือเวอร์ชันที่ต้องการของ Conversion Tracking API

คำขอ Conversion มาตรฐานของแอปจะมีพารามิเตอร์ต่อไปนี้สำหรับ App Conversion API v1.1

คำขอเครื่องมือวัด Conversion
`dev_token`	จำเป็น สถานที่ตั้ง: คำค้นหา โทเค็นนักพัฒนาแอปแบบคงที่ไม่ซ้ำกันที่ออกให้แก่ผู้ใช้ API Z_eErE4DkvcKjDM1OVE4c4
`link_id`	จำเป็น สถานที่ตั้ง: คำค้นหา ตัวระบุลิงก์ที่เชื่อมโยงโทเค็นของนักพัฒนาซอฟต์แวร์ของผู้ใช้ API กับแอปที่เฉพาะเจาะจง 31FF8D67E5BB5DD5029DCC2734C2F884
`app_event_type`	จำเป็น สถานที่ตั้ง: คำค้นหา ชื่อของเหตุการณ์ในแอปที่เกิดขึ้น ฟิลด์นี้เป็นการแจงนับ และ จะยอมรับเฉพาะค่าต่อไปนี้ • first_open • session_start • in_app_purchase • view_item_list • view_item • view_search_results • add_to_cart • ecommerce_purchase • custom ระบบควรส่งเหตุการณ์ `first_open` เสมอเพื่อระบุแหล่งที่มาของการติดตั้ง และควรส่งเหตุการณ์ `session_start` เสมอเพื่อระบุแหล่งที่มาของเซสชันอีกครั้ง ใช้ `in_app_purchase` สำหรับการซื้อที่ทำผ่าน App Store ของแพลตฟอร์มนั้นๆ และใช้ `ecommerce_purchase` สำหรับการซื้ออื่นๆ ทั้งหมด
`app_event_name`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา ชื่อของเหตุการณ์แอปที่กําหนดเองซึ่งไม่ยอมรับในช่อง`app_event_type` ฟิลด์นี้ควรมีอักขระ Unicode 1-64 ตัว (ใช้การเข้ารหัส UTF-8) ต้องระบุข้อมูลในช่องนี้หาก `app_event_type` เป็นกำหนดเอง level_achieved Level Achieved ช่องนี้ต้องไม่มีค่าใดๆ ที่สงวนไว้สำหรับ `app_event_type` หากใช้ชื่อเหตุการณ์ที่สงวนไว้ API จะ แสดงผล`APP_EVENT_NAME_RESERVED_VALUE`ข้อผิดพลาด
`app_event_data`	ไม่บังคับ ตำแหน่ง: เนื้อหา ส่งต่อข้อมูลเหตุการณ์ริชมีเดียเพิ่มเติมเป็นสตริงการแมปออบเจ็กต์ JSON อย่างง่าย คีย์ไปยังค่า โดยค่าที่ยอมรับคือสตริงและอาร์เรย์ของสตริง {"level": 5, "attempts": 20}
`odm_info`	ต้องระบุเมื่อใช้การวัด Conversion แบบรวมใน iOS สถานที่ตั้ง: คำค้นหา ค่าของพารามิเตอร์การค้นหา `info` ที่บันทึกเมื่อติดตั้งหรือติดตั้งแอป iOS อีกครั้งจาก Google On Device Measurement (ODM): Event Data SDK ฟิลด์นี้ช่วยให้ การวัด Conversion แบบรวมสําหรับ App Campaign ของ iOS XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg _CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23 หมายเหตุ: ต้องแคชฟิลด์นี้ในฝั่งแอปหรือเซิร์ฟเวอร์ เพื่อให้ส่งพร้อมกับ Conversion ดาวน์สตรีมที่เกิดขึ้นในแอปได้ หาก ODM SDK ไม่ได้สร้างค่าใดๆ ไว้ ก็ควรละเว้นฟิลด์นี้
`id_type`	จำเป็น ประเภทตัวระบุที่ส่งในช่อง `rdid` Android advertisingid appsetid หมายเหตุ: หาก `advertisingid` ไม่พร้อมใช้งานในเวลาที่เกิดเหตุการณ์ Conversion โปรดระบุ `appsetid` แทน iOS idfa idfv หมายเหตุ: หาก `idfa` ไม่พร้อมใช้งานในเวลาที่เกิดเหตุการณ์ Conversion โปรดระบุ `idfv` แทน
`rdid`	จำเป็น สถานที่ตั้ง: คำค้นหา สตริง UUID ที่ถูกต้องซึ่งแสดงรหัสอุปกรณ์ดิบ f10e1de2-e237-4f50-b6aa-843c45cc63d6 ในกรณีที่ไม่มีรหัสอุปกรณ์ เช่น รหัสอุปกรณ์จากผู้ใช้ที่ไม่ได้ให้ความยินยอม ATT ให้ตั้งค่าเป็น 0 ทั้งหมด 00000000-0000-0000-0000-000000000000
`ctry_c`	จำเป็น สถานที่ตั้ง: คำค้นหา รหัสประเทศ ISO แบบ 2 ตัวอักษรเพื่อระบุประเทศที่มาของการแปลง ต้องระบุฟิลด์นี้เพื่อเปิดใช้การวัด Conversion ของแอปในระดับที่ไม่ใช่ผู้ใช้ใน iOS และ Android US, IN
`eea`	ต้องระบุในบางกรณี สถานที่ตั้ง: คำค้นหา ขอบเขตของ EEA 0: กฎระเบียบของยุโรปไม่มีผลกับผู้ใช้และ Conversion นี้ 1: กฎระเบียบของยุโรปมีผลกับผู้ใช้และ Conversion นี้ ตัวอย่างเช่น หากผู้ใช้อยู่ในEEA ผู้ใช้จะอยู่ ในขอบเขตของกฎระเบียบของยุโรปที่เกี่ยวข้อง *Required to be sent when the value is known.
`ad_personalization`	ต้องระบุในบางกรณี สถานที่ตั้ง: คำค้นหา ค่าสถานะสำหรับโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ 0: ผู้ใช้ปลายทางปฏิเสธความยินยอมให้ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ 1: ผู้ใช้ปลายทางให้ความยินยอมให้ใช้การปรับโฆษณาตามโปรไฟล์ของผู้ใช้ *Required to be sent when the value is known.
`ad_user_data`	ต้องระบุในบางกรณี สถานที่ตั้ง: คำค้นหา ค่าสถานะความยินยอมสำหรับการใช้ข้อมูลผู้ใช้เพื่อวัตถุประสงค์ในการโฆษณา 0: ผู้ใช้ปฏิเสธความยินยอมในการส่งข้อมูลระดับผู้ใช้ไปยัง Google เพื่อวัตถุประสงค์ในการโฆษณา 1: ผู้ใช้ให้ความยินยอมในการส่งข้อมูลระดับผู้ใช้ไปยัง Google เพื่อวัตถุประสงค์ในการโฆษณา *Required to be sent when the value is known.
`lat`	จำเป็น สถานที่ตั้ง: คำค้นหา สถานะจำกัดการติดตามโฆษณาสำหรับอุปกรณ์ `0`: ผู้ใช้ไม่ได้เลือกที่จะจำกัดการติดตามโฆษณา `1`: ผู้ใช้ได้เลือกที่จะจำกัดการติดตามโฆษณา
`app_version`	จำเป็น สถานที่ตั้ง: คำค้นหา แอปเวอร์ชันปัจจุบัน ควรเป็นไปตามมาตรฐานดังนี้ Android packageManager.getPackageInfo(packageName(), PackageManager.GET_META_DATA).versionName iOS [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 1.2.4
`os_version`	จำเป็น สถานที่ตั้ง: คำค้นหา ระบบปฏิบัติการโฮสต์ของแอปเวอร์ชันปัจจุบัน โดยควรมีรูปแบบมาตรฐานดังนี้ Android android.os.Build.VERSION.RELEASE iOS [[UIDevice currentDevice] systemVersion]
`sdk_version`	จำเป็น สถานที่ตั้ง: คำค้นหา เวอร์ชันของ SDK ที่วัดเหตุการณ์ เนื่องจากส่วนนี้ใช้สำหรับการแก้ไขข้อบกพร่องเป็นหลัก จึงควรแสดงเวอร์ชันที่เผยแพร่ตรงตามที่เผยแพร่พร้อมกับการเผยแพร่ SDK หากแอปไม่ได้ใช้ SDK โปรดส่งค่าเดียวกับ `app_version` 1.9.5r6
`timestamp`	จำเป็น สถานที่ตั้ง: คำค้นหา การประทับเวลา UNIX ที่เหตุการณ์ Conversion เกิดขึ้นในหน่วยวินาทีที่มีความแม่นยำระดับไมโครวินาที 1432681913.123456
`fot`	จำเป็น สถานที่ตั้ง: คำค้นหา การประทับเวลา UNIX จาก `first_open` ที่เกี่ยวข้องเป็นวินาทีที่มีความแม่นยำระดับไมโครวินาทีสำหรับเซสชันและเหตุการณ์หลังการติดตั้งทั้งหมดในภายหลัง 1432681913.123456
`value`	ไม่บังคับ สถานที่ตั้ง: คำค้นหา มูลค่าทางการเงินของเหตุการณ์ (หากมี) ค่านี้ควรจัดรูปแบบเป็นค่าจุดลอยตัวที่เครื่องอ่านได้เสมอ โดยใช้จุดทศนิยมเพื่อแยกส่วนจำนวนเต็มและส่วนเศษส่วนของค่า 1.99
`currency_code`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา รหัสสกุลเงิน ISO 4217 สำหรับพารามิเตอร์ `value` ต้องระบุข้อมูลในช่องนี้หากระบุพารามิเตอร์ `value` และไม่ได้เว้นว่าง USD
`gclid`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา ค่าของพารามิเตอร์การค้นหา `gclid` จาก URL ของ Deep Link ที่ เปิดแอป ต้องระบุช่องนี้เมื่อ `app_event_type` เป็น `session_start` และเซสชันเริ่มต้นจาก Deep Link ที่มีพารามิเตอร์การค้นหา `gclid` ไม่เช่นนั้นก็ไม่ควรระบุ หมายเหตุ: เมื่อ rdid (advertisingid) ไม่พร้อมใช้งาน คุณต้องแคช gclid ไว้ที่ฝั่งแอปหรือฝั่งเซิร์ฟเวอร์เพื่อให้ส่งพร้อมกับการแปลงในอนาคตที่เกิดขึ้นในแอปได้ (นอกเหนือจาก session_start) `gclid` จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่ควรแปลงเป็นตัวพิมพ์ใหญ่/เล็กในคำขอ Cj0KEQjw0dy4BRCuuL_e5M
`market_referrer_gclid`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา ค่าของพารามิเตอร์การค้นหา `gclid` จาก URL ของ Deep Link ที่บันทึกจากค่า install_referrer ผ่าน Play Install Referrer API โปรดทราบว่าต้องแคชข้อมูลนี้ในฝั่งแอปหรือเซิร์ฟเวอร์เพื่อให้ส่งพร้อมกับการแปลงในอนาคตที่เกิดขึ้นในแอปได้ มิฉะนั้นก็ควรละเว้น `gclid` จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่ควรแปลงเป็นตัวพิมพ์ใหญ่/เล็กในคำขอ BX3QojHp4mY5MrJtFM_d1u
`gclid_only_request`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา ตัวระบุสำหรับการระบุแหล่งที่มาของ `gclid` ในสถานการณ์ที่ rdid (advertisingid) `not` พร้อมใช้งานหรือ `zeroes` ทั้งหมด และมี `gclid` หรือ `market_referrer_gclid` ต้องตั้งค่าเป็น `1`(จริง) เมื่อไม่มี rdid (advertisingid) ฟิลด์อื่นๆ ที่อิงตามรหัสอุปกรณ์ เช่น id_type และ lat ควร ส่งตามที่เป็นอยู่และไม่ควรข้ามสำหรับ `gclid_only_request` 1
`gbraid`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา ค่า `gbraid` ที่เห็นล่าสุดซึ่งส่งผ่าน URL ของ Deep Link ที่เปิดแอป โปรดทราบว่าต้องแคชค่านี้ในแอปเพื่อให้ส่งพร้อมกับ Conversion ในอนาคตที่เกิดขึ้นในแอปได้ ฟิลด์นี้ จำเป็นต้องใช้เพื่อเปิดใช้การวัด Conversion ของแอปในระดับที่ไม่ใช่ผู้ใช้ใน iOS และ Android `gbraid` จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่ควรแปลงเป็นตัวพิมพ์ใหญ่/เล็กในคำขอ ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
`app_open_source`	ต้องระบุภายใต้เงื่อนไขบางประการ สถานที่ตั้ง: คำค้นหา ค่าที่ใช้ระบุ Deep Link ของการคลิกโฆษณาหรือเซสชันแอปทั่วไป ต้องส่งพร้อมกับเหตุการณ์เริ่มต้นเซสชันเท่านั้น และต้องตั้งค่าเป็น `"ad_click"` เมื่อเหตุการณ์ session_start เกิดจาก Deep Link ที่มี gbraid หรือตั้งค่าเป็น `"organic"` เมื่อเหตุการณ์ session_start เกิดขึ้นโดยทั่วไป ไม่เช่นนั้น คุณควรละเว้นช่องนี้ ad_click or organic
`User-Agent`	จำเป็น ตำแหน่ง: ส่วนหัว User Agent ของแอปตามที่กำหนดไว้ในส่วนก่อนหน้า AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M)
`X-Forwarded-For`	จำเป็น ตำแหน่ง: ส่วนหัว ที่อยู่ IPv4 หรือ IPv6 สาธารณะของอุปกรณ์ที่วัดเหตุการณ์ 216.58.194.174

คำขอทั้งหมดต้องส่งผ่าน HTTPS ระบบจะปฏิเสธ Ping ที่ได้รับผ่าน HTTP

โปรดทราบว่าหากเนื้อหาของคำขอว่างเปล่า (ในกรณีที่ไม่มีข้อมูลเหตุการณ์ที่สมบูรณ์ ส่งในapp_event_dataเพย์โหลด) เซิร์ฟเวอร์ของเรากำหนดให้คุณ ตั้งค่าส่วนหัว Content-Length: 0 ในคำขออย่างชัดเจน

การเข้ารหัสข้อมูลเหตุการณ์

สําหรับพารามิเตอร์ app_event_data body โปรดใช้รูปแบบต่อไปนี้ สําหรับประเภทข้อมูลพื้นฐาน

ลอย
- ใช้อักขระจุดเป็นตัวคั่นทศนิยมโดยไม่ขึ้นอยู่กับการแปลแอป
- ใช้ความแม่นยำทศนิยม 2 หลักเพื่อแสดงมูลค่าที่เป็นตัวเงิน เช่น 2.99
- อย่าใช้สัญกรณ์ยกกำลัง เช่น 2E+9
- อย่าใช้เครื่องหมายจุลภาคเพื่อคั่นกลุ่มตัวเลข เช่น 1,000,000
- ตัวอย่างที่ถูกต้อง
  - -0.5
  - 2.99
  - 1000000.123
จำนวนเต็ม
- ส่งเฉพาะค่าจำนวนเต็มที่ไม่มีตัวเลขทศนิยม
- อย่าใช้เครื่องหมายจุลภาคเพื่อคั่นกลุ่มตัวเลข เช่น 1,000,000
- ตัวอย่างที่ถูกต้อง
  - 1000
  - -11
  - 0
วันที่
- รูปแบบวันที่: ปปปป-ดด-วว
  - yyyy = ปีแบบ 4 หลัก เช่น 2016
  - mm = เดือนแบบ 2 หลัก เช่น 09 สำหรับเดือนกันยายน
  - dd = วันที่ 2 หลัก เช่น 23 สำหรับวันที่ 23 ของเดือน
- ส่งจำนวนหลักตามที่ระบุไว้ข้างต้นเสมอ เช่น หากส่งค่าสำหรับ dd สำหรับวันที่ 5 ของเดือน ให้ส่ง 05
- ตัวอย่างที่ถูกต้อง
  - "2016-09-23"
  - "1990-12-31"
การประทับเวลา
- รูปแบบเวลา: การประทับเวลา Unix/Epoch ในหน่วยวินาทีที่กำหนดในเขตเวลา UTC ที่มีความแม่นยำระดับไมโครวินาที
- ตัวอย่างที่ถูกต้อง
  - 1478713087 for Wed, 09 Nov 2016 17:38:07 GMT
  - 1073513982.123000 สำหรับ Wed, 07 Jan 2004 22:19:42.123 GMT
อาร์เรย์
- ส่งเฉพาะอาร์เรย์ของค่าดั้งเดิม (สตริง ตัวเลข และบูลีน)
- ตัวอย่างที่ถูกต้อง
  - [123, 456, 789]
  - ["abc"]

คำขอตัวอย่าง

ตัวอย่างคำขอเปิดครั้งแรกที่มีการวัดผลในอุปกรณ์: ข้อมูลเหตุการณ์ SDK สำหรับการวัด Conversion แบบผสานรวม มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอเปิดครั้งแรกที่ไม่มีการวัดผลในอุปกรณ์: Event Data SDK สำหรับการวัด Conversion แบบผสานรวม มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอหลังการติดตั้งที่มี SDK การวัดผลบนอุปกรณ์: ข้อมูลเหตุการณ์ สําหรับการวัด Conversion แบบรวม

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &&fot=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอเปิดครั้งแรกที่ไม่มี SDK การวัดผลในอุปกรณ์: เหตุการณ์ Data มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอเปิดครั้งแรกสำหรับ Conversion ที่ไม่แน่นอนของ Android สำหรับ ACAPI v1.1 มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=appsetid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &ctry_c=IN
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (android 11; en-GB; RMX2040; Build/_; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอเครื่องมือวัด Conversion ที่ถูกต้องซึ่งมีประเภท เหตุการณ์ที่ไม่กำหนดเองและข้อมูลรายได้มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=0
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

{"app_event_data":{"item_id":["Crayons","Markers"]}}

ตัวอย่างคำขอเครื่องมือวัด Conversion ที่ถูกต้องซึ่งมีประเภทเหตุการณ์ที่ไม่กำหนดเอง และข้อมูลรายได้ที่ไม่มี rdid (advertisingid) มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

{"app_event_data":{"item_id":["Crayons","Markers"]}}

ตัวอย่างคำขอการเริ่มต้นเซสชันที่ถูกต้องมีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอการเริ่มต้นเซสชัน การระบุแหล่งที่มาใหม่ที่ถูกต้องสำหรับเซสชัน ซึ่งเริ่มต้นจาก Deep Link example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ตัวอย่างคำขอเครื่องมือวัด Conversion ที่ถูกต้องสำหรับผู้ใช้ใน EEA ซึ่งได้รับความยินยอมให้ใช้ข้อมูลผู้ใช้โฆษณา และปฏิเสธการปรับโฆษณาตามโปรไฟล์ของผู้ใช้มีดังนี้

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=1
       &ad_personalization=0
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

คู่มือการตอบกลับเกี่ยวกับเครื่องมือวัด Conversion

การตอบกลับเครื่องมือวัด Conversion มีรูปแบบดังนี้

{
  "ad_events": [<ad event objects>],
  "errors": [<error strings>],
  "attributed": true|false
}

ทั้งอาร์เรย์ ad_events และ errors อาจว่างเปล่า

เราคาดว่าข้อผิดพลาดจะเป็นรหัสข้อผิดพลาดที่เครื่องอ่านได้ เช่น invalid_timestamp

รหัสข้อผิดพลาด

invalid_timestamp - คำขอไม่มีการประทับเวลาที่ถูกต้อง
eea_missing_or_invalid - คำขอไม่ได้ตั้งค่าฟิลด์ "eea" หรือคำขอไม่ถูกต้อง
ad_user_data_missing - ไม่ได้ตั้งค่าฟิลด์คำขอ "ad_user_data" ต้องระบุข้อมูลในช่อง "ad_user_data" สำหรับคำขอ DMA ทั้งหมดที่อยู่ในขอบเขต
ad_user_data_invalid - ค่าคำขอ "ad_user_data" ไม่ถูกต้อง ต้องระบุข้อมูลในช่อง "ad_user_data" สำหรับคำขอ DMA ทั้งหมดที่อยู่ในขอบเขต
ad_personalization_missing_or_invalid - คำขอไม่ได้ตั้งค่าฟิลด์ "ad_personalization" หรือคำขอไม่ถูกต้อง ต้องระบุฟิลด์ "ad_personalization" สำหรับคำขอ DMA ทั้งหมดที่อยู่ในขอบเขต

เหตุการณ์โฆษณาคือออบเจ็กต์หลักของการระบุแหล่งที่มาของแอป และจะมีพร็อพเพอร์ตี้ต่อไปนี้

attributed จะแสดงผล true ได้ก็ต่อเมื่อมีการนำเข้าเหตุการณ์ไปยังบัญชีเครื่องมือวัด Conversion สำหรับบัญชี Google Ads ที่ กระตุ้นการโต้ตอบ

หมายเหตุสำคัญเกี่ยวกับลักษณะการทํางานของการตอบกลับซึ่งขึ้นอยู่กับความยินยอมของผู้ใช้
หาก Conversion มีความยินยอมให้ใช้ข้อมูลผู้ใช้ในโฆษณา และผู้ใช้มีความยินยอมให้ใช้ข้ามกัน ในการตั้งค่าผู้ใช้ Google แล้ว Google Ads จะตอบกลับด้วยการคลิกสุดท้ายเพียงครั้งเดียว ใน CPS ทั้งหมด หากผู้ใช้ไม่ยินยอมให้ใช้ข้อมูลร่วมกัน ภายในการตั้งค่าผู้ใช้ Google ของตน Google Ads จะตอบกลับด้วยการคลิกสุดท้ายหลายรายการ โดยอิงตาม CPS ต่อรายการ

หาก Conversion มี CPS บางรายการในความยินยอมให้ใช้ร่วมกันที่ผู้ใช้เลือก แต่ไม่มี CPS อื่นๆ Google Ads จะตอบกลับด้วยการคลิกครั้งสุดท้ายเพียงครั้งเดียวใน CPS ที่ได้รับความยินยอมให้ใช้ร่วมกัน แต่จะมีการคลิกครั้งสุดท้ายหลายครั้งต่อ CPS สำหรับ CPS ที่ไม่ได้รับความยินยอมให้ใช้ร่วมกัน

การตอบกลับเครื่องมือวัด Conversion
`ad_event_id`	พร้อมใช้งานเสมอ สตริง `ad_event_id` ทำหน้าที่เป็นตัวระบุที่ไม่ซ้ำกันสำหรับเหตุการณ์โฆษณา โดยจะ นำไปใช้ซ้ำในคำขอการระบุแหล่งที่มาข้ามเครือข่าย และควรบันทึก/เก็บรักษาไว้ เพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
`conversion_metric`	พร้อมใช้งานเสมอ สตริง เมตริก Conversion ที่ใช้สําหรับการระบุแหล่งที่มา โดยในระยะแรกเราจะรองรับเมตริก Conversion 1 รายการ conversion
`timestamp`	พร้อมใช้งานเสมอ ตัวเลข การประทับเวลา UNIX ที่เหตุการณ์โฆษณาเกิดขึ้นในหน่วยวินาทีที่มีความแม่นยำระดับไมโครวินาที ควรใช้ค่านี้สำหรับการระบุแหล่งที่มาของคลิกสุดท้าย 1432681913.123456
`campaign_type`	พร้อมใช้งานเสมอ สตริง ฟิลด์นี้จะระบุประเภทแคมเปญที่สร้างเหตุการณ์โฆษณา ค่าที่เป็นไปได้มีดังนี้ ACI ACE ACPre Search Display Video Shopping Hotel Performance_Max Other ACI เป็นตัวย่อของ App Campaign เพื่อการติดตั้ง ACE เป็นตัวย่อของ App Campaign เพื่อการมีส่วนร่วม
`campaign_id`	พร้อมใช้งานเสมอ ตัวเลข รหัสแคมเปญที่เป็นตัวเลขของแคมเปญที่สร้างเหตุการณ์โฆษณา ค่านี้รับประกันว่าไม่ซ้ำกัน 123456789
`campaign_name`	พร้อมใช้งานเสมอ สตริง ชื่อแคมเปญที่ผู้ลงโฆษณากําหนดของแคมเปญที่สร้างเหตุการณ์โฆษณา ค่านี้ไม่รับประกันว่าจะเป็นค่าที่ไม่ซ้ำกัน Occasional Gamers (Video)
`ad_type`	พร้อมใช้งานเสมอ สตริง ประเภทของโฆษณาที่ทำให้เกิดเหตุการณ์โฆษณา ค่านี้ใช้เพื่อ แยกความแตกต่างระหว่างพื้นที่โฆษณาประเภทต่างๆ ได้ดังนี้ การโปรโมตแอป ClickToDownload การมีส่วนร่วมในแอป AppDeepLink การมีส่วนร่วมในแอป - ขั้นตอนการติดตั้งและดำเนินการต่อ AppDeepLinkContinue ค่าอื่นๆ ทั้งหมด Unknown
`external_customer_id`	พร้อมใช้งานเสมอ ตัวเลข ตัวระบุผู้ลงโฆษณาสำหรับผู้ลงโฆษณาที่เป็นเจ้าของแคมเปญที่ สร้างเหตุการณ์โฆษณา ค่านี้ใช้เพื่อแยกความแตกต่างของบัญชี Google Ads ได้ 123456789
`location`	พร้อมใช้งานเสมอ ตัวเลข รหัสสถานที่ตั้งสำหรับสถานที่ตั้งทางภูมิศาสตร์ของเหตุการณ์โฆษณา ดู ข้อมูลอ้างอิง Google Ads API เพื่อตีความรหัสสถานที่ตั้ง
`network_type`	พร้อมใช้งานเสมอ สตริง ฟิลด์นี้จะระบุเครือข่ายโฆษณา Google Ads ที่เหตุการณ์โฆษณาเกิดขึ้น ค่าที่เป็นไปได้มีดังนี้ Search Display YouTube GoogleTv cross-network
`network_subtype`	จะเป็น `null` เมื่อ `campaign_type` เป็น `ACI` หรือ `ACE` และ `network_type` เป็น `Display` สตริง ฟิลด์นี้จะระบุ "ประเภทย่อย" ของเครือข่ายโฆษณา Google Ads ที่เกิดเหตุการณ์โฆษณา ค่าที่เป็นไปได้จะแตกต่างกันไปตามประเภทเครือข่ายหลัก ค้นหา Google Search ทั่วไป GoogleSearch พาร์ทเนอร์ในเครือข่ายการค้นหาของ Google SearchPartners ดิสเพลย์ ผู้เผยแพร่โฆษณาในเว็บบนอุปกรณ์เคลื่อนที่ mGDN ผู้เผยแพร่แอป Google AdMob YouTube เครือข่ายวิดีโอ YouTube YouTubeVideos เครือข่ายการค้นหาของ YouTube YouTubeSearch พาร์ทเนอร์วิดีโอ VideoPartners GoogleTv เครือข่ายวิดีโอ GoogleTV GoogleTvVideos ข้ามเครือข่าย Performance Max ในเครือข่ายต่างๆ cross-network
`video_id`	ระบุเมื่อ `network_type` เป็น `YouTube` และ `campaign_type` ไม่ใช่ `ACI` และ `ACE` เท่านั้น สตริง รหัสวิดีโอ YouTube ที่เชื่อมโยงกับเหตุการณ์โฆษณา dQw4w9WgXcQ
`keyword`	ระบุเมื่อ `network_type` เป็น `Search` และ `campaign_type` ไม่ใช่ `ACI` และ `ACE` เท่านั้น สตริง คีย์เวิร์ดในการค้นหาที่เชื่อมโยงกับเหตุการณ์โฆษณา +food +delivery
`match_type`	ระบุเมื่อ `network_type` เป็น `Search` และ `campaign_type` ไม่ใช่ `ACI` และ `ACE` เท่านั้น สตริง ประเภทการทำงานของคีย์เวิร์ดในเครือข่าย Search ตรงทั้งหมด e วลี p กว้าง b
`placement`	ระบุเมื่อ `network_type` เป็น `Display` และ `campaign_type` ไม่ใช่ `ACI` และ `ACE` เท่านั้น สตริง ตําแหน่งที่เชื่อมโยงกับเหตุการณ์โฆษณา mobileapp::1-343200656
`ad_group_id`	ระบุเมื่อ `campaign_type` ไม่ใช่ `Performance_Max` เท่านั้น ตัวเลข รหัสตัวเลขของกลุ่มโฆษณาที่สร้างขึ้นพร้อมกับเหตุการณ์โฆษณา ค่านี้ รับประกันว่าไม่ซ้ำกัน 123456789
`ad_group_name`	ระบุเมื่อ `campaign_type` เป็น `ACI`, `ACE` หรือ `ACPRE` เท่านั้น สตริง ชื่อกลุ่มโฆษณาที่ผู้ลงโฆษณากําหนดของกลุ่มโฆษณาที่สร้างเหตุการณ์โฆษณา ค่านี้ไม่รับประกันว่าจะเป็นค่าที่ไม่ซ้ำกัน My App AdGroup
`creative_id`	จะระบุเมื่อ `campaign_type` ไม่ใช่ `ACI`, `ACE`, `ACPRE` หรือ `Performance_Max` เท่านั้น ตัวเลข รหัสตัวเลขของหน่วยโฆษณาครีเอทีฟโฆษณาที่สร้างเหตุการณ์โฆษณา ค่านี้ รับประกันว่าไม่ซ้ำกัน 123456789
`interaction_type`	ช่องนี้จะเป็นการมีส่วนร่วมเสมอ สตริง
`is_deterministic`	ระบุว่าวิธีการระบุแหล่งที่มาเป็นแบบดีเทอร์มินิสติกหรือไม่ บูลีน true, false
`device_model`	รุ่นอุปกรณ์ที่สร้างเหตุการณ์โฆษณา สตริง sm-s936w, sm-3936w
`os_version`	เวอร์ชันหลักของระบบปฏิบัติการที่สร้างเหตุการณ์โฆษณา สตริง 14, 12
`country`	รหัสประเทศแบบ 2 ตัวอักษรที่สร้างเหตุการณ์โฆษณา สตริง CA, US
`city`	เมืองที่สร้างเหตุการณ์โฆษณา สตริง san jose, london
`region`	รัฐหรือจังหวัดที่สร้างเหตุการณ์โฆษณา สตริง california, british columbia

คำตอบตัวอย่าง

ตัวอย่างการตอบกลับสำหรับ Conversion ที่กำหนดได้มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "is_deterministic": true
    "timestamp": 1234567.898765,
  }],
  "errors": [],
  "attributed": true
}

ตัวอย่างการตอบกลับสําหรับ Conversion ที่ไม่แน่นอนของ iOS มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "is_deterministic": false
    },
    "device_info": {
        "device_model": "iphone12,3",
        "os_version": "14",
    },
    "timestamp": 1432681918.123456
    }],
  "errors": [],
  "attributed": true
}

ตัวอย่างการตอบกลับสำหรับ Conversion ที่ไม่แน่นอนของ Android มีดังนี้

{
  "ad_events": [
    {
      "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
      "conversion_metric": "conversion",
      "interaction_type": "click",
      "campaign_type": "ACI",
      "campaign_id": 123456789,
      "campaign_name": "My App Campaign",
      "network_type": null,
      "network_subtype": null,
      "ad_group_id": null,
      "ad_group_name": null,
      "is_deterministic": false
      "geo_info": {
        "city": "san jose"
        "country": "US"
        "region": "california"
      },
      "device_info": {
          "device_model": "sm-s926u",
          "os_version": "14",
      },
      "timestamp": 1432681918.123456
    },
    ],
    "errors": [],
    "warnings" [],
  }

ตัวอย่างการตอบกลับสำหรับ Conversion ของ iOS/Android ที่เกิดจาก gbraid มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "interaction_type": "engagement",
    "network_type": "NULL",
    "is_deterministic": true
    "timestamp": 0.000000,
  }],
  "errors": [],
  "attributed": true
  "warnings" [],
}

ตัวอย่างการตอบกลับการติดตาม Conversion เมื่อคำขอมีข้อผิดพลาดมีดังนี้

{
  "ad_events": [],
  "errors": ["INVALID_CURRENCY_CODE"],
  "attributed": false
}

ตัวอย่างการตอบกลับการวัด Conversion เชิงลบ

{
  "ad_events": [],
  "errors": [],
  "attributed": false
}

ระบบจะแสดงการตอบกลับเครื่องมือวัด Conversion สำหรับคำขอเครื่องมือวัด Conversion ทั้งหมด

ตัวอย่างการตอบกลับการวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับ Universal App Campaign มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

ตัวอย่างการตอบกลับเครื่องมือวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับแคมเปญ Search มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Search",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": "+space +birds",
    "match_type": "b",
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

ตัวอย่างการตอบกลับเครื่องมือวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับแคมเปญ Display มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Display",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "mGDN",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": "mobile-app::2-343200656",
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

ตัวอย่างการตอบกลับเครื่องมือวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับแคมเปญ YouTube มีดังนี้

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Video",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": "dQw4w9WgXcQ",
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

ตัวอย่างการตอบกลับการติดตาม Conversion ที่ระบุแหล่งที่มาซึ่ง Conversion มีการระบุแหล่งที่มาเป็นการโต้ตอบกับโฆษณา Play + Search แต่มีการปฏิเสธความยินยอมในการใช้ข้ามระหว่าง CPS ของ Play + Search ตามมาตรา 5(2)(b) + 5(2)(c) คือ

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

ตัวอย่างการตอบกลับการวัด Conversion ที่มาจากการระบุแหล่งที่มาซึ่ง Conversion มาจากการโต้ตอบกับโฆษณา Play + Search และยอมรับความยินยอมในการใช้ข้ามกัน 5(2)(b) + 5(2)(c) ระหว่าง CPS ของ Play + Search จะคล้ายกับพฤติกรรม Conversion ในปัจจุบัน

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

ตัวอย่างการตอบกลับการติดตาม Conversion ที่ระบุแหล่งที่มาซึ่ง Conversion มีการระบุแหล่งที่มาเป็นการโต้ตอบกับโฆษณา Play, Search และ YouTube และมีการยอมรับความยินยอมในการใช้ข้าม 5(2)(b) + 5(2)(c) ระหว่าง CPS ของ Play + Search แต่ปฏิเสธ CPS ของ YouTube คือ

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Youtube",
    "network_subtype": "YouTubeVideos",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

คำขอการระบุแหล่งที่มาข้ามเครือข่าย

เมื่อ Google Ads ตอบกลับคําขอเครื่องมือวัด Conversion ในเชิงบวก ผู้ใช้ API ต้องแจ้งให้ Google Ads ทราบถึงการตัดสินใจระบุแหล่งที่มาข้ามเครือข่ายหลังจาก ระบุคลิกสุดท้าย

คำขอการระบุแหล่งที่มาแบบข้ามเครือข่ายจะเหมือนกับคำขอเครื่องมือวัด Conversion เดิม แต่มีเส้นทางคำขอเป็นดังนี้

/pagead/conversion/app/1.1/cross_network

และเพิ่มพารามิเตอร์ที่จำเป็น 2 รายการดังนี้

คำขอการระบุแหล่งที่มาข้ามเครือข่าย

คำขอการระบุแหล่งที่มาข้ามเครือข่าย
`ad_event_id`	จำเป็น สถานที่ตั้ง: คำค้นหา ตัวระบุ `ad_event_id` จากเหตุการณ์โฆษณาที่เชื่อมโยงกับการ ระบุแหล่งที่มาในคำขอก่อนหน้า `ad_event_id` จะพิจารณาตัวพิมพ์เล็กและใหญ่ และไม่ควรแปลง เป็นตัวพิมพ์ใหญ่/เล็กในคำขอ
`attributed`	จำเป็น สถานที่ตั้ง: คำค้นหา Google Ads ได้รับเครดิตสําหรับ Conversion จากผู้ใช้ API หรือไม่ `0` หรือ `1`

ad_event_id

จำเป็น

สถานที่ตั้ง: คำค้นหา

ตัวระบุ ad_event_id จากเหตุการณ์โฆษณาที่เชื่อมโยงกับการ ระบุแหล่งที่มาในคำขอก่อนหน้า

ad_event_id จะพิจารณาตัวพิมพ์เล็กและใหญ่ และไม่ควรแปลง เป็นตัวพิมพ์ใหญ่/เล็กในคำขอ

attributed

จำเป็น

สถานที่ตั้ง: คำค้นหา

Google Ads ได้รับเครดิตสําหรับ Conversion จากผู้ใช้ API หรือไม่ 0 หรือ 1

ตัวอย่างคำขอการระบุแหล่งที่มาข้ามเครือข่ายที่ถูกต้องมีดังนี้

POST /pagead/conversion/app/1.1/cross_network
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=custom
       &app_event_name=level_achieved
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
       &attributed=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

คำขอการระบุแหล่งที่มาแบบข้ามเครือข่ายที่ถูกต้องจะได้รับการตอบกลับ 200 ทั่วไปเสมอโดยไม่มีเนื้อหาการตอบกลับ

User-Agent ของแอป

Android

iOS

Android

iOS

Android

iOS

Android

iOS

Android

iOS

Android

iOS

คู่มือคำขอเครื่องมือวัด Conversion

Android

iOS

Android

iOS

Android

iOS

การเข้ารหัสข้อมูลเหตุการณ์

คำขอตัวอย่าง

คู่มือการตอบกลับเกี่ยวกับเครื่องมือวัด Conversion

ค้นหา

ดิสเพลย์

YouTube

GoogleTv

ข้ามเครือข่าย

คำตอบตัวอย่าง

ตัวอย่างการตอบกลับสำหรับ Conversion ที่กำหนดได้มีดังนี้

ตัวอย่างการตอบกลับสําหรับ Conversion ที่ไม่แน่นอนของ iOS มีดังนี้

ตัวอย่างการตอบกลับสำหรับ Conversion ที่ไม่แน่นอนของ Android มีดังนี้

ตัวอย่างการตอบกลับสำหรับ Conversion ของ iOS/Android ที่เกิดจาก gbraid มีดังนี้

ตัวอย่างการตอบกลับการติดตาม Conversion เมื่อคำขอมีข้อผิดพลาดมีดังนี้

ตัวอย่างการตอบกลับการวัด Conversion เชิงลบ

ตัวอย่างการตอบกลับการวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับ Universal App Campaign มีดังนี้

ตัวอย่างการตอบกลับเครื่องมือวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับแคมเปญ Search มีดังนี้

ตัวอย่างการตอบกลับเครื่องมือวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับแคมเปญ Display มีดังนี้

ตัวอย่างการตอบกลับเครื่องมือวัด Conversion ที่ยืนยันสําหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA สําหรับแคมเปญ YouTube มีดังนี้

คำขอการระบุแหล่งที่มาข้ามเครือข่าย