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

User Agent ของแอป

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

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

คําจํากัดความของช่องเหล่านี้มีดังนี้

คอมโพเนนต์ User Agent
name	ชื่อผลิตภัณฑ์วิเคราะห์/โฆษณา (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 เป็น API เครื่องมือวัด Conversion เวอร์ชันที่ต้องการ ปัจจุบันมีเวอร์ชันเดียวที่ใช้ได้คือ 1.0

คําขอ Conversion ของแอปมาตรฐานจะมีพารามิเตอร์ต่อไปนี้

คําขอเครื่องมือวัด 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}
rdid	จำเป็น ตําแหน่ง: ข้อความค้นหา สตริง UUID ที่ถูกต้องซึ่งแสดงถึงรหัสอุปกรณ์ดิบ f10e1de2-e237-4f50-b6aa-843c45cc63d6 ในกรณีที่ไม่มีรหัสอุปกรณ์ เช่น รหัสอุปกรณ์จากผู้ใช้ ATT ที่ไม่ได้รับความยินยอม ให้ตั้งค่ารหัสเป็น 0 ทั้งหมด 00000000-0000-0000-0000-000000000000
id_type	จำเป็น ตําแหน่ง: ข้อความค้นหา ประเภทของตัวระบุในช่อง rdid เราอาจยอมรับค่าอื่นๆ เพิ่มเติมได้ที่นี่ แต่ในขั้นต้น เราจะรองรับค่าต่อไปนี้ Android advertisingid iOS idfa
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
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 (รหัสโฆษณา) not พร้อมใช้งานหรือ zeroes ทั้งหมด และ gclid หรือ market_referrer_gclid มีอยู่ ต้องตั้งค่าเป็น 1(true) เมื่อ rdid (advertisingid) ไม่สามารถใช้ได้ ช่องอื่นๆ ที่อิงตามรหัสอุปกรณ์ เช่น id_type และ lat ควร ส่งตามที่ควรจะเป็น และต้องไม่ข้ามสําหรับ gclid_only_request 1
gbraid	ต้องระบุภายใต้เงื่อนไขบางประการ ตําแหน่ง: ข้อความค้นหา ค่า gbraid ครั้งล่าสุดที่ส่งผ่าน URL ของ Deep Link ที่เปิดแอป โปรดทราบว่าระบบต้องแคชค่านี้ในแอปเพื่อให้ส่งไปพร้อมกับ Conversion ในอนาคตซึ่งเกิดขึ้นในแอปได้ ช่องนี้จําเป็นสําหรับการเปิดใช้การวัด Conversion ของแอปที่สอดคล้องกับ ATT ใน iOS gbraid คํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และไม่ควรแปลงเป็นตัวพิมพ์ใหญ่/ตัวพิมพ์เล็กในคําขอ ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source	ต้องระบุภายใต้เงื่อนไขบางประการ ตําแหน่ง: ข้อความค้นหา ค่าที่ใช้ระบุ Deep Link ของการคลิกโฆษณาหรือเซสชันทั่วไปของแอป ต้องส่งพร้อมกับเหตุการณ์การเริ่มเซสชันเท่านั้นและต้องตั้งค่าเป็น "ad_click" เมื่อเหตุการณ์ session_start ขับเคลื่อนโดย Deep Link ที่มี Deep Link หรือตั้งค่าเป็น "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 ในคําขออย่างชัดเจน

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

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

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &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
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
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 โปรดใช้รูปแบบต่อไปนี้สําหรับประเภทข้อมูลพื้นฐาน

• ทศนิยม

  • ใช้อักขระจุดเป็นตัวคั่นทศนิยมโดยไม่เกี่ยวข้องกับการแปลแอป
  • ใช้ทศนิยม 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 สําหรับวันพุธที่ 9 พฤศจิกายน 2016 เวลา 17:38:07 น. ตามเขตเวลา GMT
    • 1073513982.123000 สําหรับวันพุธที่ 7 ม.ค. 2004 22:19:42.123 GMT

• อาร์เรย์

  • ส่งเฉพาะอาร์เรย์ของค่าพื้นฐาน (สตริง ตัวเลข และบูลีน)
  • ตัวอย่างที่ถูกต้อง
    • [123, 456, 789]
    • ["abc"]

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

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

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

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

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

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

การตอบกลับเครื่องมือวัด Conversion
ad_event_id	นําเสนอเสมอ สตริง ad_event_id ทําหน้าที่เป็นตัวระบุที่ไม่ซ้ําสําหรับเหตุการณ์โฆษณา โดยจะใช้ซ้ําในคําขอการระบุแหล่งที่มาข้ามเครือข่าย และควรบันทึก/เก็บไว้เพื่อแก้ไขข้อบกพร่อง Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric	นําเสนอเสมอ สตริง เมตริก Conversion ที่ใช้สําหรับการระบุแหล่งที่มา ในตอนแรก เราจะรองรับ เมตริก Conversion 1 รายการ conversion
timestamp	นําเสนอเสมอ number การประทับเวลา UNIX ที่เกิดเหตุการณ์โฆษณาขึ้น โดยมีหน่วยเป็นวินาทีที่มีความแม่นยําสูงสุดหน่วยไมโครวินาที ค่านี้ควรใช้สําหรับการระบุแหล่งที่มาของคลิกสุดท้าย 1432681913.123456
campaign_type	นําเสนอเสมอ สตริง ช่องนี้จะระบุประเภทของแคมเปญที่สร้างเหตุการณ์โฆษณา ค่าที่เป็นไปได้มีดังนี้ ACI ACE Search Display Video Shopping Hotel Performance_Max Other ACI เป็นตัวย่อของ App Campaign เพื่อการติดตั้ง ACE เป็นตัวย่อของ App Campaign เพื่อการมีส่วนร่วม
campaign_id	นําเสนอเสมอ number รหัสแคมเปญที่เป็นตัวเลขของแคมเปญที่สร้างเหตุการณ์โฆษณา เรารับประกันมูลค่านี้ไม่ซ้ํากัน 123456789
campaign_name	นําเสนอเสมอ สตริง ชื่อแคมเปญซึ่งผู้ลงโฆษณากําหนดของแคมเปญที่สร้างเหตุการณ์โฆษณา ค่านี้ไม่รับประกันว่าไม่ซ้ํากัน Occasional Gamers (Video)
ad_type	นําเสนอเสมอ สตริง ประเภทของโฆษณาที่ส่งผลให้เกิดเหตุการณ์โฆษณา ค่านี้สามารถใช้เพื่อแยกความแตกต่างระหว่างพื้นที่โฆษณาประเภทต่างๆ ได้ดังนี้ การโปรโมตแอป ClickToDownload การมีส่วนร่วมในแอป AppDeepLink การมีส่วนร่วมในแอป — ติดตั้งแล้วทําตามขั้นตอนต่อ AppDeepLinkContinue รับทั้งหมดเป็นค่าอื่นๆ Unknown
external_customer_id	นําเสนอเสมอ number ตัวระบุผู้ลงโฆษณาสําหรับผู้ลงโฆษณาที่เป็นเจ้าของแคมเปญที่สร้างเหตุการณ์โฆษณา คุณสามารถใช้ค่านี้เพื่อแยกแยะ บัญชี Google Ads 123456789
location	นําเสนอเสมอ number รหัสสถานที่ตั้งสําหรับสถานที่ตั้งทางภูมิศาสตร์ของเหตุการณ์โฆษณา โปรดดูเอกสารอ้างอิง Google Ads API เพื่อตีความโค้ดสถานที่ตั้ง
network_type	นําเสนอเสมอ สตริง ช่องนี้จะระบุเครือข่ายโฆษณาของ Google Ads ที่เกิดเหตุการณ์โฆษณา ค่าที่เป็นไปได้มีดังต่อไปนี้ Search Display YouTube
network_subtype	จะเป็น null เมื่อ campaign_type เป็น ACI หรือ ACE และ network_type คือ Display สตริง ช่องนี้จะระบุ "ประเภทย่อย" ของเครือข่ายการโฆษณาของ Google Ads ที่มีเหตุการณ์เกิดขึ้น ค่าที่เป็นไปได้จะแตกต่างกันไปตามประเภทเครือข่ายหลัก Search Google Search ทั่วไป GoogleSearch พาร์ทเนอร์ Google Search SearchPartners จอแสดงผล ผู้เผยแพร่เว็บบนอุปกรณ์เคลื่อนที่ mGDN ผู้เผยแพร่แอป Google AdMob YouTube เครือข่ายวิดีโอของ YouTube YouTubeVideos เครือข่ายการค้นหาของ YouTube YouTubeSearch พาร์ทเนอร์วิดีโอ VideoPartners
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 สตริง ประเภทการทํางานของคีย์เวิร์ดในการค้นหา แบบตรงทั้งหมด e วลี p แบบกว้าง b
placement	ระบุเมื่อ network_type คือ Display และ campaign_type ไม่ใช่ ACI และ ACE สตริง ตําแหน่งที่เชื่อมโยงกับเหตุการณ์โฆษณา mobileapp::1-343200656
ad_group_id	นําเสนอเสมอ number รหัสตัวเลขของกลุ่มโฆษณาที่สร้างด้วยเหตุการณ์โฆษณา ค่านี้รับประกันได้ว่าเป็นเอกลักษณ์ 123456789
ad_group_name	ระบุเมื่อ campaign_type คือ ACI,ACE หรือ ACPRE สตริง ชื่อกลุ่มโฆษณาที่กําหนดโดยผู้ลงโฆษณาของกลุ่มโฆษณาที่เกิดเหตุการณ์โฆษณา ค่านี้ไม่รับประกันว่าไม่ซ้ํากัน My App AdGroup
creative_id	ระบุเมื่อ campaign_type ไม่ใช่ ACI และ ACE เท่านั้น number รหัสตัวเลขของหน่วยโฆษณาครีเอทีฟโฆษณาที่สร้างเหตุการณ์โฆษณา ค่านี้รับประกันได้ว่าเป็นเอกลักษณ์ 123456789
interaction_type	ช่องนี้จะมีส่วนร่วมเสมอ สตริง

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

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

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

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

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

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

ตัวอย่างการตอบสนองของเครื่องมือวัด Conversion ที่ได้รับการยืนยันสําหรับ 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
}

ตัวอย่างการตอบสนองจากเครื่องมือวัด Conversion ที่ได้รับการยืนยันของแคมเปญ 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
}

ตัวอย่างการตอบสนองของเครื่องมือวัด Conversion ที่ได้รับการยืนยันสําหรับแคมเปญในเครือข่ายดิสเพลย์ ได้แก่

{
  "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
}

ตัวอย่างการตอบสนองจากเครื่องมือวัด Conversion ที่มีการยืนยันว่าเป็นจริงบน 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
}

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

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

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

/pagead/conversion/app/1.0/cross_network

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

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

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

POST /pagead/conversion/app/1.0/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 เสมอโดยไม่มีเนื้อหาการตอบกลับ