Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

เครื่องมือวัด 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` ควรเป็นรหัสชุดของแอปไคลเอ็นต์แทน 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/โฆษณา (`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 ไว้ที่ฝั่งแอปหรือฝั่งเซิร์ฟเวอร์เพื่อให้ส่งพร้อมกับ Conversion ในอนาคตที่เกิดขึ้นในแอปได้ (นอกเหนือจาก session_start) `gclid` คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่ควรแปลงเป็น ตัวพิมพ์ใหญ่/ตัวพิมพ์เล็กในคำขอ Cj0KEQjw0dy4BRCuuL_e5M
`market_referrer_gclid`	ต้องระบุในบางกรณี ตำแหน่ง: คำค้นหา ค่าพารามิเตอร์การค้นหา `gclid` จาก URL ของ Deep Link ที่รวบรวมจากค่า install_referrer ผ่าน Play Install Referrer API โปรดทราบว่าต้องแคชข้อมูลนี้ในแอปหรือฝั่งเซิร์ฟเวอร์เพื่อให้ส่งพร้อมกับ Conversion ในอนาคตที่เกิดขึ้นในแอปได้ มิฉะนั้นก็ควรละเว้น `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-mm-dd
  - yyyy = ปีแบบ 4 หลัก เช่น 2016
  - mm = เดือน 2 หลัก เช่น 09 สำหรับเดือนกันยายน
  - dd = วันที่แบบ 2 หลัก เช่น 23 สำหรับวันที่ 23 ของเดือน
- ส่งจำนวนหลักที่ระบุไว้ข้างต้นเสมอ เช่น หากส่งค่าสำหรับ dd ในวันที่ 5 ของเดือน ให้ส่ง 05
- ตัวอย่างที่ถูกต้อง
  - "2016-09-23"
  - "1990-12-31"
การประทับเวลา
- รูปแบบเวลา: การประทับเวลา Unix/Epoch ในหน่วยวินาทีที่กำหนดในเขตเวลา UTC ที่มีความแม่นยำระดับไมโครวินาที
- ตัวอย่างที่ถูกต้อง
  - 1478713087 สำหรับ 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

ตัวอย่างคำขอเปิดครั้งแรกที่ไม่มีการวัดผลในอุปกรณ์: เหตุการณ์ 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

ตัวอย่างคำขอหลังการติดตั้งที่มีการวัดที่เกิดขึ้นบนอุปกรณ์: Event Data 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 การวัดผลในอุปกรณ์: Event 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 Search SearchPartners ดิสเพลย์ ผู้เผยแพร่โฆษณาในเว็บบนอุปกรณ์เคลื่อนที่ mGDN ผู้เผยแพร่แอป Google AdMob YouTube เครือข่ายวิดีโอ YouTube YouTubeVideos เครือข่ายการค้นหาของ YouTube YouTubeSearch พาร์ทเนอร์วิดีโอ VideoPartners GoogleTv เครือข่ายวิดีโอ Google TV GoogleTvVideos ข้ามเครือข่าย Performance Max ในเครือข่ายต่างๆ cross-network
`video_id`	ระบุเมื่อ `network_type` เป็น `YouTube` และ `campaign_type` ไม่ใช่ `ACI` และ `ACE` เท่านั้น สตริง รหัสวิดีโอ YouTube ที่เชื่อมโยงกับเหตุการณ์โฆษณา dQw4w9WgXcQ
`keyword`	ระบุเมื่อ `network_type` เป็น `Search` และ `campaign_type` ไม่ใช่ `ACI` และ `ACE` เท่านั้น สตริง คีย์เวิร์ดสำหรับโฆษณา Search ที่เชื่อมโยงกับเหตุการณ์โฆษณา +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` ตัวเลข รหัสตัวเลขของกลุ่มโฆษณาที่สร้างขึ้นพร้อมกับเหตุการณ์โฆษณา รับประกันว่าค่านี้ จะไม่ซ้ำกัน ฟิลด์นี้ไม่ได้มีไว้สำหรับเหตุการณ์โฆษณาที่ระบุแหล่งที่มาของ gbraid ซึ่งระบุแหล่งที่มาแบบดีเทอร์มินิสติก (`is_deterministic` คือ `true`) เช่น การระบุแหล่งที่มาของ Deep Link 123456789
`ad_group_name`	ระบุเมื่อ `campaign_type` เป็น `ACI`, `ACE` หรือ `ACPRE` เท่านั้น สตริง ชื่อกลุ่มโฆษณาที่ผู้ลงโฆษณากําหนดของกลุ่มโฆษณาที่สร้างเหตุการณ์โฆษณา ค่านี้ไม่รับประกันว่าจะไม่ซ้ำกัน ฟิลด์นี้ไม่ได้มีไว้สำหรับเหตุการณ์โฆษณาที่ระบุแหล่งที่มาของ gbraid ซึ่งระบุแหล่งที่มาแบบดีเทอร์มินิสติก (`is_deterministic` คือ `true`) เช่น การระบุแหล่งที่มาของ Deep Link My App AdGroup
`asset_group_id`	จะระบุให้เฉพาะเมื่อ `campaign_type` เป็น `Performance_Max` ตัวเลข รหัสตัวเลขของกลุ่มชิ้นงานที่สร้างเหตุการณ์โฆษณา ค่านี้ จะไม่ซ้ำกัน 123456789
`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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": 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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": 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": 123456789,
      "ad_group_name": "My App AdGroup",
      "asset_group_id": 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,
    "ad_group_id": null,
    "ad_group_name": null,
    "asset_group_id": 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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "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": null,
    "asset_group_id": null,
    "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": null,
    "asset_group_id": null,
    "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": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

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

{
  "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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

ตัวอย่างการตอบกลับการวัด Conversion ที่มีการระบุแหล่งที่มาซึ่ง Conversion ได้รับการระบุแหล่งที่มาจากการโต้ตอบกับโฆษณา Google Play + โฆษณา Search และมีการยอมรับความยินยอมในการใช้ข้าม 5(2)(b) + 5(2)(c) ระหว่าง CPS ของ Google 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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "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": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

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

เมื่อ Google Ads ตอบรับคำขอเครื่องมือวัด Conversion API Consumer จะต้องแจ้งให้ 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 มีดังนี้

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