ทรัพยากร Conversion มีวิธีการที่อนุญาตให้ผู้ใช้สร้าง แก้ไข และดึง Conversion ของ Floodlight หลายรายการพร้อมกัน
ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอแหล่งข้อมูล
รายการ Conversion
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": long, "advertiserId": long, "engineAccountId": long, "campaignId": long, "customerId": string, "adGroupId": long, "criterionId": long, "adId": long, "clickId": string, "dsConversionId": long, "conversionId": string, "state": string, "type": string, "revenueMicros": long, "currencyCode": string, "quantityMillis": long, "segmentationType": string, "segmentationId": long, "segmentationName": string, "conversionTimestamp": unsigned long, "conversionModifiedTimestamp": unsigned long, "floodlightOrderId": string, "customMetric": [ { "name": string, "value": double } ], "customDimension": [ { "name": string, "value": string } ], "countMillis": long, "attributionModel": string, "productGroupId": long, "inventoryAccountId": long, "productId": string, "productCountry": string, "productLanguage": string, "channel": string, "storeId": string, "deviceType": string, "adUserDataConsent": string } ] }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
conversion[] |
list |
Conversion ที่ขอ | |
conversion[].adGroupId |
long |
รหัสกลุ่มโฆษณา DS | |
conversion[].adId |
long |
รหัสโฆษณา DS | |
conversion[].adUserDataConsent |
string |
แสดงความยินยอมสำหรับค่ากำหนดบริการแพลตฟอร์มหลัก (CPS) ในการตั้งค่า ไม่มีค่าเริ่มต้น ค่าที่ยอมรับได้คือ GRANTED: สถานะความยินยอมที่ต้องการคือให้สิทธิ์ อ่านค่ากำหนด CPS จากการตั้งค่า GTE DENIED: สถานะความยินยอมที่ต้องการคือปฏิเสธ รายการ CPS ว่างเปล่า | |
conversion[].advertiserId |
long |
รหัสผู้ลงโฆษณา DS | |
conversion[].agencyId |
long |
รหัสเอเจนซี DS | |
conversion[].attributionModel |
string |
พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search แล้วเท่านั้น | |
conversion[].campaignId |
long |
รหัสแคมเปญ DS | |
conversion[].channel |
string |
ช่องทางการขายสำหรับผลิตภัณฑ์ ค่าที่ยอมรับได้ มีดังนี้
|
|
conversion[].clickId |
string |
รหัสคลิก DS สำหรับ Conversion | |
conversion[].conversionId |
string |
สําหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะระบุรหัสนี้ ผู้ลงโฆษณาสามารถระบุรหัสที่มีความหมายต่อตนได้ Conversion แต่ละรายการในคำขอต้องระบุรหัสที่ไม่ซ้ำกัน และชุดค่าผสมของรหัสและการประทับเวลาจะต้องไม่ซ้ำกันกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา สำหรับ Conversion ออนไลน์ DS จะคัดลอก dsConversionId หรือ floodlightOrderId มายังพร็อพเพอร์ตี้นี้ตามคำสั่ง Floodlight ของผู้ลงโฆษณา |
|
conversion[].conversionModifiedTimestamp |
unsigned long |
เวลาที่แก้ไข Conversion ครั้งล่าสุด เป็น Epoch millis UTC | |
conversion[].conversionTimestamp |
unsigned long |
เวลาที่เกิด Conversion ในหน่วย Epoch millis UTC | |
conversion[].countMillis |
long |
พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search แล้วเท่านั้น | |
conversion[].criterionId |
long |
รหัสเกณฑ์ (คีย์เวิร์ด) ของ DS | |
conversion[].currencyCode |
string |
รหัสสกุลเงินสำหรับรายได้ของ Conversion ควรอยู่ในรูปแบบตัวอักษร ISO 4217 (อักขระ 3 ตัว) | เขียนได้ |
conversion[].customDimension[] |
list |
มิติข้อมูลที่กำหนดเองสำหรับ Conversion ซึ่งใช้กรองข้อมูลในรายงานได้ | |
conversion[].customDimension[].name |
string |
ชื่อมิติข้อมูลที่กำหนดเอง | |
conversion[].customDimension[].value |
string |
ค่ามิติข้อมูลที่กำหนดเอง | |
conversion[].customMetric[] |
list |
เมตริกที่กำหนดเองสำหรับ Conversion | |
conversion[].customMetric[].name |
string |
ชื่อเมตริกที่กำหนดเอง | |
conversion[].customMetric[].value |
double |
ค่าตัวเลขของเมตริกที่กำหนดเอง | |
conversion[].customerId |
string |
รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ ต้องเป็นบัญชีลูกค้า เมื่อตั้งค่าช่องนี้แล้ว ควรตั้งค่าช่องรหัสอื่นๆ ทั้งหมดเป็นรหัส Search Ads 360 เวอร์ชันใหม่ | |
conversion[].deviceType |
string |
ประเภทอุปกรณ์ที่เกิด Conversion
ค่าที่ยอมรับได้ มีดังนี้
|
|
conversion[].dsConversionId |
long |
รหัสที่ DoubleClick Search สร้างขึ้นสำหรับ Conversion แต่ละรายการ | |
conversion[].engineAccountId |
long |
รหัสบัญชีเครื่องมือค้นหา DS | |
conversion[].floodlightOrderId |
string |
รหัสคำสั่งซื้อของ Floodlight ที่ผู้ลงโฆษณาระบุสำหรับ Conversion | |
conversion[].inventoryAccountId |
long |
รหัสที่ DS สร้างและใช้เพื่อระบุบัญชีสินค้าคงคลังที่มีผลิตภัณฑ์โดยไม่ซ้ำกัน | |
conversion[].productCountry |
string |
ประเทศที่ลงทะเบียนฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 3166 เพื่อระบุประเทศ | |
conversion[].productGroupId |
long |
รหัสกลุ่มผลิตภัณฑ์ DS | |
conversion[].productId |
string |
รหัสผลิตภัณฑ์ (SKU) | |
conversion[].productLanguage |
string |
ภาษาที่ลงทะเบียนสำหรับฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 639 เพื่อระบุภาษา | |
conversion[].quantityMillis |
long |
ปริมาณของ Conversion นี้ หน่วยเป็นมิลลิวินาที | เขียนได้ |
conversion[].revenueMicros |
long |
จำนวนรายได้ของ Conversion TRANSACTION นี้ เป็นไมโคร (ค่าคูณด้วย 1000000 ไม่มีทศนิยม) เช่น หากต้องการระบุค่ารายได้เป็น "10" ป้อน "10000000" (10 ล้าน) ในคำขอ |
เขียนได้ |
conversion[].segmentationId |
long |
ตัวระบุการแบ่งกลุ่มที่เป็นตัวเลข (เช่น รหัสกิจกรรม DoubleClick Search Floodlight) | |
conversion[].segmentationName |
string |
ตัวระบุการแบ่งกลุ่มลูกค้าที่ใช้งานง่าย (เช่น ชื่อกิจกรรม DoubleClick Search Floodlight) | |
conversion[].segmentationType |
string |
ประเภทการแบ่งกลุ่มของ Conversion นี้ (เช่น FLOODLIGHT )
ค่าที่ยอมรับได้ มีดังนี้
|
|
conversion[].state |
string |
สถานะของ Conversion ซึ่งก็คือ ACTIVE หรือ REMOVED หมายเหตุ: สถานะ "DELETED" เลิกใช้งานแล้ว
ค่าที่ยอมรับได้ มีดังนี้
|
เขียนได้ |
conversion[].storeId |
string |
รหัสของร้านค้าในพื้นที่ที่โฆษณาผลิตภัณฑ์ ใช้ได้เฉพาะเมื่อช่องเป็น "local " |
|
conversion[].type |
string |
ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION เป็นการกระทำของผู้ใช้ที่ไม่มีมูลค่าที่วัดจำนวนเงินได้ ส่วน Conversion TRANSACTION เป็นการกระทำที่มีมูลค่าวัดปริมาณได้ เช่น การลงชื่อสมัครใช้รายชื่ออีเมล (ACTION ) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION )
ค่าที่ยอมรับได้ มีดังนี้
|
|
kind |
string |
ระบุว่าข้อมูลนี้เป็นทรัพยากร ConversionList ค่า: สตริงคงที่ doubleclicksearch#conversionList |
เมธอด
- รับ
- ดึงรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search
- getByCustomerId
- ดึงรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่
- แทรก
- แทรกกลุ่ม Conversion ใหม่ลงใน DoubleClick Search
- อัปเดต
- อัปเดตกลุ่ม Conversion ใน DoubleClick Search
- updateAvailability
- อัปเดตความพร้อมใช้งานของกลุ่มกิจกรรม Floodlight ใน DoubleClick Search