ดึงข้อมูลทางภูมิศาสตร์สำหรับการทดสอบ

หากต้องการดึงข้อมูล GeoX Experiment โดยอัตโนมัติหรือในปริมาณมาก คุณต้องใช้ Google Ads API เพื่อดึงข้อมูลต้นทุนและค่าใช้จ่าย จากนั้นรวมข้อมูลนี้กับข้อมูล Conversion หรือรายได้แบบดิบที่ไม่ได้กรองและไม่ได้ระบุแหล่งที่มาจาก CRM ภายใน, ระบบ ณ จุดขาย (POS) หรือฐานข้อมูลการขายภายใน

หากต้องการดึงข้อมูลแคมเปญและข้อมูลค่าใช้จ่ายตามกลุ่มทางภูมิศาสตร์อย่างถูกต้อง ให้ใช้สถาปัตยกรรมต่อไปนี้

  • บริการ: ใช้ GoogleAdsService โดยเฉพาะเมธอด Search หรือ SearchStream

  • ทรัพยากร: ค้นหา geographic_view เพื่อดู ตำแหน่งทางกายภาพหรือความสนใจของผู้ใช้ ซึ่งโดยปกติจะเป็น มาตรฐานสำหรับ GeoX Experiment หรือค้นหา location_view เพื่อดูประสิทธิภาพตาม สถานที่เป้าหมายที่เฉพาะเจาะจงซึ่งแคมเปญกำหนดเป้าหมาย

  • ฟิลด์ที่จะรวม

  • ตัวอย่างคําค้นหา 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) แยก ID ตัวเลข (1023191) และค้นหาgeo_target_constant ทรัพยากรดังนี้

    SELECT
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.id = 1023191

    หรือหากต้องการรวมในโค้ดภายในเครื่อง ให้ดาวน์โหลด CSV ของเป้าหมายทางภูมิศาสตร์แบบคงที่ที่เป้าหมายทางภูมิศาสตร์

  • Conversion ต้นทุน: API จะแสดงค่าต้นทุนเป็นหน่วยไมโคร คุณต้องหาร metrics.cost_micros ด้วย 1,000,000 เพื่อแสดงค่าสกุลเงินมาตรฐานที่จำเป็นในไฟล์อัปโหลด

รหัสสถานที่ทางภูมิศาสตร์สำหรับการเปลี่ยนแปลงการกำหนดเป้าหมาย

เมื่อดำเนินการเปลี่ยนแปลงการกำหนดเป้าหมายตามสถานที่ของแคมเปญหรือกลุ่มโฆษณา ผู้ลงโฆษณาต้องค้นหาและส่ง ID GeoTargetConstant ที่แน่นอน (geoTargetConstants/ID) สำหรับภูมิภาคที่เลือก คุณจะส่งรหัส ISO หรือ Nielsen แบบดิบไม่ได้

ประเภทภูมิภาค ID API ที่จำเป็น (GeoTargetConstant) รูปแบบเดิม (ห้ามใช้)
ภูมิภาค DMA ID 200501 (สำหรับ New York) รหัส Nielsen (เช่น 501 สำหรับ New York)
ประเทศ ID 2724 (สำหรับสเปน) รหัส ISO (เช่น "ES" สำหรับสเปน)

แนวทางปฏิบัติแนะนำและข้อผิดพลาดในการจัดรูปแบบที่พบบ่อย

  • การจัดรูปแบบวันที่: ฟิลด์ segments.date จะแสดงสตริงวันที่ ISO-8601 ในรูปแบบ YYYY-MM-DD ในไปป์ไลน์ ETL ให้ซีเรียลไลซ์ฟิลด์วันที่อย่างชัดเจนเป็นสตริง YYYY-MM-DD และหลีกเลี่ยงการเปิดไฟล์ CSV ที่ส่งออกในแอปพลิเคชันสเปรดชีตที่จะจัดรูปแบบคอลัมน์วันที่ใหม่โดยอัตโนมัติ
  • เลข 0 นำหน้ารหัสไปรษณีย์: ถือว่ารหัสไปรษณีย์ (เช่น 01234) เป็นประเภทสตริง (VARCHAR หรือ STRING) ตลอดไปป์ไลน์ข้อมูลแทนที่จะเป็นจำนวนเต็ม เพื่อไม่ให้มีการนำเลข 0 นำหน้าออก
  • การรวม: หากทำการศึกษาแบบหลายเซลล์ คุณต้องระบุเมตริกค่าใช้จ่ายแยกกันสำหรับแต่ละกลุ่มการรักษา
  • การรวมข้อมูล Conversion: เมื่อรวมกับข้อมูล Conversion จากระบบ CRM ภายในหรือฐานข้อมูลการขายภายใน ให้ตรวจสอบว่าข้อมูล Conversion มีพร็อพเพอร์ตี้ต่อไปนี้เพื่อให้การประมวลผลข้อมูลกับข้อมูล Google Ads API และ GeoX เป็นไปอย่างราบรื่น
    • อนุกรมเวลาแบบรายวัน: ต้องรวมข้อมูลตามวัน
    • ระดับภูมิศาสตร์: ต้องแมป Conversion ทุกรายการกับหน่วยทางภูมิศาสตร์ที่แน่นอนที่คุณกำลังทดสอบ (เช่น การจับคู่รหัสไปรษณีย์สำหรับการจัดส่งของลูกค้ากับ DMA หรือกลุ่มไปรษณีย์ที่ใช้ในการออกแบบ)
    • ค่ารวม: ข้อมูลต้องเป็นค่าสัมบูรณ์ที่ไม่ติดลบ เช่น รายได้รวมหรือจำนวน Conversion รวม หาก CRM ติดตามรายได้สุทธิด้วยค่าติดลบสำหรับการคืนเงิน คุณต้องใช้ตัวเลขรวมสำหรับการทดสอบและใช้สัดส่วนการคืนเงินในภายหลัง
ก่อนหน้า
การรายงาน
ถัดไป
ข้อผิดพลาดแบบอะซิงโครนัส