ทรัพยากร 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 } ] }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
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 มิลลิวินาที UTC | |
conversion[].conversionTimestamp |
unsigned long |
เวลาที่เกิด Conversion ในหน่วย Epoch มิลลิวินาที 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 |
ตัวระบุการแบ่งกลุ่มที่เป็นตัวเลข (เช่น รหัสกิจกรรม Floodlight ของ DoubleClick Search) | |
conversion[].segmentationName |
string |
ตัวระบุการแบ่งกลุ่มที่เป็นมิตรกับผู้ใช้ (เช่น ชื่อกิจกรรม Floodlight ของ DoubleClick Search) | |
conversion[].segmentationType |
string |
ประเภทการแบ่งกลุ่มของ Conversion นี้ (เช่น FLOODLIGHT )
ค่าที่ยอมรับได้ ได้แก่
|
|
conversion[].state |
string |
สถานะของ Conversion ซึ่งก็คือ ACTIVE หรือ REMOVED หมายเหตุ: สถานะ "ลบแล้ว" เลิกใช้งานแล้ว
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
conversion[].storeId |
string |
รหัสของร้านค้าในพื้นที่ที่มีการโฆษณาผลิตภัณฑ์ ใช้ได้เมื่อช่องเป็น "local " เท่านั้น |
|
conversion[].type |
string |
ประเภทของ Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION เป็นการกระทําของผู้ใช้ที่ไม่มีมูลค่าที่วัดปริมาณได้ ขณะที่ Conversion TRANSACTION เป็นการกระทําที่มีมูลค่าที่เป็นตัวเงินได้ ตัวอย่างเช่น การลงชื่อสมัครใช้รายชื่ออีเมล (ACTION ) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION )
ค่าที่ยอมรับได้มีดังนี้
|
|
kind |
string |
ระบุว่าเป็นทรัพยากร ConversionList ค่า: สตริงคงที่ doubleclicksearch#conversionList |
วิธีการ
- รับ
- เรียกรายการ Conversion จากบัญชี DoubleClick Search Engine
- getByCustomerId
- เรียกรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่
- แทรก
- แทรก Conversion ใหม่เป็นกลุ่มใน DoubleClick Search
- อัปเดต
- อัปเดตกลุ่ม Conversion ใน DoubleClick Search
- updateAvailability
- อัปเดตความพร้อมใช้งานของกลุ่มกิจกรรม Floodlight ใน DoubleClick Search