เครื่องมือวัด 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 คำขอ การแปลงคือคำขอ POST ผ่าน HTTPS ในเส้นทางต่อไปนี้ 

/pagead/conversion/app/version
โดย version คือเวอร์ชันที่ต้องการของ Conversion Tracking API ปัจจุบันมีเพียงเวอร์ชัน 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
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
value

ไม่บังคับ

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

มูลค่าทางการเงินของเหตุการณ์ (หากมี) ค่านี้ควรจัดรูปแบบเป็นค่าจุดลอยตัวที่เครื่องอ่านได้เสมอ โดยใช้จุดทศนิยมเพื่อแยกส่วนจำนวนเต็มและส่วนเศษส่วนของค่า

1.99
currency_code

ต้องระบุภายใต้เงื่อนไขบางประการ

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

รหัสสกุลเงิน ISO 4217 สำหรับพารามิเตอร์ value ต้องระบุข้อมูลในช่องนี้หาก value ระบุพารามิเตอร์และไม่ได้เว้นว่าง

USD
gclid

ต้องระบุภายใต้เงื่อนไขบางประการ

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

ค่าของgclidพารามิเตอร์การค้นหาจาก URL ของ Deep Link ที่ เปิดแอป

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

ต้องระบุภายใต้เงื่อนไขบางประการ

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

ค่าของพารามิเตอร์การค้นหา gclid จาก URL ของ Deep Link ที่บันทึกจากค่า install_referrer ผ่าน Play Install Referrer API

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

ต้องระบุภายใต้เงื่อนไขบางประการ

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

ตัวระบุสำหรับการระบุแหล่งที่มาของ gclid ในสถานการณ์ที่ rdid (advertisingid) not พร้อมใช้งานหรือ zeroes ทั้งหมด และมี gclid หรือ market_referrer_gclid

1
gbraid

ต้องระบุภายใต้เงื่อนไขบางประการ

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

ค่า gbraidที่เห็นล่าสุดซึ่งส่งผ่าน URL ของ Deep Link ที่เปิดแอป โปรดทราบว่าต้องแคชค่านี้ในแอปเพื่อให้ส่งพร้อมกับ Conversion ในอนาคตที่เกิดขึ้นในแอปได้

ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source

ต้องระบุภายใต้เงื่อนไขบางประการ

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

ค่าที่ใช้ระบุ Deep Link ของการคลิกโฆษณาหรือเซสชันแอปทั่วไป

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
       &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.0
       ?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.0
       ?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.0
       ?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.0
       ?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

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

สําหรับพารามิเตอร์ 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"]

การตอบกลับเครื่องมือวัด 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 ทั้งหมดที่อยู่ในขอบเขต

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

หมายเหตุสำคัญเกี่ยวกับลักษณะการทํางานของการตอบกลับซึ่งขึ้นอยู่กับความยินยอมของผู้ใช้
หาก 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

ฟิลด์นี้จะเป็นการมีส่วนร่วมเสมอ

สตริง

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

ตัวอย่างการตอบกลับการติดตาม 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": []
}
 
{
  "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
}
 
{
  "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
}
 
{
  "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.0/cross_network

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

คำขอการระบุแหล่งที่มาข้ามเครือข่าย
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 ทั่วไปเสมอโดยไม่มีเนื้อหาการตอบกลับ