หากต้องการดึงข้อมูลอัตโนมัติหรือดึงข้อมูลขนาดใหญ่สำหรับการทดสอบ GeoX คุณต้องใช้ Google Ads API เพื่อดึงข้อมูลต้นทุนและค่าใช้จ่าย และต้องรวมข้อมูลนี้เข้ากับข้อมูล Conversion หรือรายได้แบบดิบที่ไม่ได้กรองและไม่ได้ระบุแหล่งที่มาจาก CRM ภายใน, ระบบ ณ จุดขาย (POS) หรือฐานข้อมูลการขายภายใน
สถาปัตยกรรมเวิร์กโฟลว์ API ที่แนะนำ
หากต้องการดึงข้อมูลแคมเปญและข้อมูลค่าใช้จ่ายตามกลุ่มภูมิศาสตร์อย่างถูกต้อง ให้ใช้สถาปัตยกรรมต่อไปนี้
- บริการ: ใช้
GoogleAdsServiceโดยเฉพาะเมธอดSearchหรือSearchStream แหล่งข้อมูล: ค้นหา
geographic_viewเพื่อ ดูสถานที่ตั้งจริงหรือสถานที่ที่ผู้ใช้สนใจ ซึ่งโดยปกติจะเป็น มาตรฐานสำหรับการทดสอบ GeoX หรือค้นหาlocation_viewเพื่อดูประสิทธิภาพตาม สถานที่ตั้งที่เฉพาะเจาะจงซึ่งแคมเปญกำหนดเป้าหมายฟิลด์ที่จะรวม:
campaign.idsegments.datesegments.geo_target_city(หรือภูมิภาคหรือประเทศ ทั้งนี้ขึ้นอยู่กับความละเอียดของ GeoX)metrics.cost_micros
ตัวอย่างคําค้นหา GAQL: สําหรับ GeoX ผู้ลงโฆษณาควรดึงข้อมูลเมตริกต้นทุนโดยใช้ Google Ads API แทนที่จะใช้ Conversion ที่ระบุแหล่งที่มา (ซึ่งควรมาจาก CRM ภายในหรือระบบของบุคคลที่สาม) คุณสามารถใช้คําค้นหาต่อไปนี้
SELECT campaign.id, segments.date, segments.geo_target_city, metrics.cost_micros FROM geographic_view WHERE segments.date DURING LAST_30_DAYS
การประมวลผลภายหลังและการดึงข้อมูล
การแมปกลุ่มภูมิศาสตร์: API จะไม่แสดงชื่อข้อความธรรมดา (เช่น "New York") หรือรหัสย่อ (เช่น "501" หรือ "ES") ในมุมมองการรายงาน ฟิลด์ต่างๆ เช่น
segments.geo_target_cityหรือsegments.geo_target_countryจะแสดงสตริงชื่อแหล่งข้อมูลที่ชี้ไปยังGeoTargetConstant(เช่นgeoTargetConstants/1023191) นักพัฒนาแอปสามารถค้นหาตารางgeo_target_constantได้โดยตรงSELECT geo_target_constant.canonical_name FROM geo_target_constant WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'หรือหากต้องการรวมข้อมูลในโค้ดภายใน ให้ดาวน์โหลด CSV ของเป้าหมายทางภูมิศาสตร์แบบคงที่ที่เป้าหมายทางภูมิศาสตร์
Conversion ต้นทุน: API จะแสดงค่าต้นทุนเป็นหน่วยไมโคร คุณต้องหาร
metrics.cost_microsด้วย 1,000,000 เพื่อแสดงค่าสกุลเงินมาตรฐานที่จำเป็นในไฟล์อัปโหลด
รหัสการกำหนดเป้าหมาย (DMA และประเทศ)
เมื่อดำเนินการเปลี่ยนแปลงการกำหนดเป้าหมาย ผู้ลงโฆษณาต้องค้นหาและส่งรหัส GeoTargetConstant ที่ถูกต้องสำหรับภูมิภาคที่เลือก คุณจะส่งรหัส ISO หรือ Nielsen แบบดิบไม่ได้
| ประเภทภูมิภาค | รหัส API ที่จำเป็น (GeoTargetConstant) |
รูปแบบเดิม (ห้ามใช้) |
|---|---|---|
| ภูมิภาค DMA | รหัส 200501 (สำหรับนิวยอร์ก) |
รหัส Nielsen (เช่น 501 สำหรับนิวยอร์ก) |
| ประเทศ | รหัส 2724 (สำหรับสเปน) |
รหัส ISO (เช่น "ES" สำหรับสเปน) |
แนวทางปฏิบัติแนะนำและข้อผิดพลาดในการจัดรูปแบบที่พบบ่อย
- การจัดรูปแบบวันที่: ฟิลด์
segments.dateจะแสดงข้อมูลในรูปแบบYYYY-MM-DDแอปพลิเคชันสเปรดชีต เช่น Excel มักจะเปลี่ยนรูปแบบวันที่โดยอัตโนมัติ ให้อัปโหลดไฟล์ไปยัง Google ชีตก่อนเพื่อให้มั่นใจว่าระบบจะอ่านช่วงวันที่ได้อย่างถูกต้องในรูปแบบYYYY-MM-DDที่กำหนด - เลข 0 ที่นำหน้า: ตรวจสอบว่าระบบไม่ได้ตัดเลข 0 ที่นำหน้าในรหัสไปรษณีย์ (เช่น
01234) ใช้ "รูปแบบตัวเลขที่กำหนดเอง" ใน Google ชีตเพื่อบังคับให้แสดงสตริง 5 หลัก - การรวม: หากทำการศึกษาแบบหลายเซลล์ คุณต้องระบุเมตริกค่าใช้จ่ายแยกกันสำหรับแต่ละกลุ่มการรักษา
- การรวมข้อมูล Conversion: เมื่อรวมกับข้อมูล Conversion จากระบบ CRM ภายในหรือฐานข้อมูลการขายภายใน ให้ตรวจสอบว่าข้อมูล Conversion มีคุณสมบัติต่อไปนี้เพื่อให้การประมวลผลข้อมูลกับข้อมูล Google Ads API และ GeoX เป็นไปอย่างราบรื่น
- อนุกรมเวลาแบบรายวัน: ต้องรวมข้อมูลตามวัน
- ระดับภูมิศาสตร์: ต้องแมป Conversion ทุกรายการกับหน่วยภูมิศาสตร์ที่แน่นอนที่คุณกำลังทดสอบ (เช่น การจับคู่รหัสไปรษณีย์สำหรับการจัดส่งของลูกค้ากับ DMA หรือกลุ่มไปรษณีย์ที่ใช้ในการออกแบบ)
- ค่ารวม: ข้อมูลต้องเป็นค่าสัมบูรณ์ที่ไม่ติดลบ เช่น รายได้รวมหรือจำนวน Conversion ทั้งหมด หาก CRM ติดตามรายได้สุทธิด้วยค่าติดลบสำหรับการคืนเงิน คุณต้องใช้ตัวเลขรวมสำหรับการทดสอบและใช้สัดส่วนการคืนเงินในภายหลัง