เชื่อม Apple Search Ads กับ Google Sheets

เชื่อม Apple Ads และ Google Drive กับ Hermoso แล้วทั้งสองจะเรียกใช้จากเอเจนต์ตัวเดียวกันได้ apple_ads_report ดึงแถวประสิทธิภาพ create_sheet และ append_to_sheet นำแถวเหล่านั้นไปวางในสเปรดชีตที่คุณเป็นเจ้าของ ไม่มีไฟล์ส่งออก ไม่มีคลังข้อมูล และไม่มีเครื่องมือที่สามถือ credential ของคุณ

หน้าตาเป็นแบบนี้

"ดึงค่าใช้จ่าย Apple Search Ads ของสัปดาห์ที่แล้วตามคีย์เวิร์ด แล้ว append ลงในชีต Apple Ads ของฉัน" เอเจนต์เรียกรายงาน จัดรูปแบบแถว แล้ว append ลงไป ถามอีกครั้งในวันจันทร์หน้า ชีตจะเพิ่มขึ้นอีกหนึ่งสัปดาห์

สโคป Drive ที่ Hermoso ขอคือ drive.file ซึ่งเข้าถึงได้เฉพาะไฟล์ที่มันสร้างเองหรือที่คุณเลือก ไม่ใช่ Drive ทั้งหมดของคุณ

วิธีเชื่อม Apple Search Ads กับ Google Sheets

1. เชื่อมทั้งสองบัญชี ใน แอป เปิด Connectors แล้วเชื่อม Apple Ads จากนั้นเชื่อม Google Drive Sheets และ Docs ใช้การอนุญาต Google ชุดเดียวกัน จึงมีหน้ายินยอมเพียงหน้าเดียว ไม่ใช่สามหน้า Apple Ads เป็นการแลกคีย์ ไม่ใช่การกดปุ่ม คู่มือการตั้งค่า Apple Search Ads อธิบายไว้แล้ว รวมถึงวิธี เชื่อม Apple Search Ads กับ Claude หรือ ChatGPT ซึ่งคุณจะพิมพ์คำขอของคุณที่นั่น
2. ขอการดึงครั้งแรก "ดึงประสิทธิภาพ Apple Search Ads ตามแคมเปญของ 30 วันที่ผ่านมา แล้วใส่ลงในชีตใหม่ชื่อ Apple Ads" เอเจนต์เรียก apple_ads_report จากนั้น create_sheet และส่งลิงก์กลับมา
3. ทำให้เป็นรอบต่อเนื่อง ประโยคเดิมแต่เปลี่ยนจาก "ชีตใหม่" เป็น "append" รันตามกำหนดเวลาจากไคลเอนต์ที่คุณใช้ (งานตามกำหนดเวลาใน Claude หรือ ChatGPT หรือ cron job ที่เรียก Hermoso CLI) จะเพิ่มบล็อกแถวใหม่ทุกครั้ง จะไม่มีอะไรถูกเขียนทับจนกว่าคุณจะขอ
4. ชี้แดชบอร์ดของคุณไปที่ชีต Looker Studio, Power BI และ Tableau อ่าน Google Sheets ผ่านตัวเชื่อมต่อของแต่ละตัวเอง

หน้าตาของชีต

หนึ่งแถวต่อหนึ่งออบเจ็กต์ต่อหนึ่งช่วงเวลา คอลัมน์เป็นไปตามระดับที่คุณขอ (แคมเปญ ad group, ad, คีย์เวิร์ด หรือคำค้น) บวกตัวชี้วัดที่ Apple รายงาน ได้แก่ impressions, taps, installs, spend, tap-through rate, cost per tap และ cost per acquisition ถ้าขอความละเอียดรายวัน แต่ละออบเจ็กต์จะได้หนึ่งแถวต่อวัน ถ้าขอยอดรวม จะได้หนึ่งแถว เอเจนต์เพิ่มแถวยอดรวมทั้งหมดได้ และในรายงาน App Store มันสามารถเก็บออบเจ็กต์ที่ไม่มีการแสดงผลไว้ได้ ดังนั้นคีย์เวิร์ดที่หยุดอยู่จะแสดงเป็นศูนย์ ไม่หายไป

เพราะเอเจนต์จัดรูปแบบแถวก่อนเขียน คุณจึงขอชีตที่ต้องการได้ตรงๆ เช่น เฉพาะคีย์เวิร์ดที่ค่าใช้จ่ายเกินเกณฑ์ ชื่อแคมเปญวางข้าง id ของมัน หรือการเปลี่ยนแปลงรายสัปดาห์ที่คำนวณไว้แล้วก่อนเขียน งานแบบนี้คือสิ่งที่การส่งออก CSV ปล่อยให้คุณทำเอง

append, แทนที่ หรือจัดรูปแบบ

เครื่องมือของ Sheets ครอบคลุมการแก้ไขทั้งหมด append_to_sheet เพิ่มแถว update_sheet เขียนช่วงในที่เดิม clear_sheet_range ล้างช่วงก่อนเมื่อคุณต้องการการแทนที่แทนการสะสม format_sheet จัดการหัวตาราง ความกว้าง และรูปแบบตัวเลข และ manage_sheet_tabs ให้แต่ละแคมเปญหรือแต่ละเดือนมีแท็บของตัวเอง คำขอ "รีเฟรชชีตแดชบอร์ด" คือการล้างแล้วเขียนต่อ บนแท็บที่คุณระบุ

ส่งออก Apple Search Ads ไปยัง Looker Studio จากชีต

Hermoso ไม่มีตัวเชื่อมต่อ Looker Studio โดยตรง ชีตคือสะพาน ใน Looker Studio สร้างแหล่งข้อมูล เลือก Google Sheets แล้วเลือกสเปรดชีตและแท็บที่เอเจนต์ append ลงไป สร้างรายงานครั้งเดียวแล้วปล่อยไว้ ทุกการ append จะปรากฏในการรีเฟรชข้อมูลครั้งถัดไปของแดชบอร์ด ตราบใดที่หัวคอลัมน์ไม่เปลี่ยนระหว่างการรันแต่ละครั้ง รูปแบบเดียวกันใช้กับ Power BI และ Tableau ได้

ต้องการ JSON แทนชีตหรือไม่

รายงานเดียวกันนี้มีให้เป็น JSON ดิบจาก Hermoso API (POST /v1/tools/apple_ads_report) หรือ CLI ดู ส่งออก Apple Search Ads เป็น JSON และ ส่งออกข้อมูลจาก Apple Search Ads สำหรับปลายทางอื่นทั้งหมด

คำถามที่พบบ่อย

ฉันจะเชื่อม Apple Search Ads กับ Google Sheets ได้อย่างไร

เชื่อม Apple Ads และ Google Drive ใน Hermoso แล้วขอให้เอเจนต์ใส่รายงานลงชีต มันดึงแถวด้วย apple_ads_report และเขียนด้วย create_sheet หรือ append_to_sheet จากนั้นส่งลิงก์กลับมา

Hermoso ต้องเข้าถึง Google Drive ทั้งหมดของฉันหรือไม่

ไม่ต้อง Hermoso ขอ drive.file ซึ่งครอบคลุมไฟล์ที่ Hermoso สร้างขึ้นและไฟล์ที่คุณเลือกอย่างชัดเจนเท่านั้น

ระดับและตัวชี้วัดใดบ้างที่ใส่ลงชีตได้

ระดับแคมเปญ ad group, ad, คีย์เวิร์ด หรือคำค้น พร้อม impressions, taps, installs, spend, tap-through rate, cost per tap และ cost per acquisition ทั้งเป็นยอดรวมหรือเป็นชุดข้อมูลรายชั่วโมง รายวัน รายสัปดาห์ หรือรายเดือน

รายงานที่ตั้งเวลาไว้จะเขียนทับชีตของฉันหรือไม่

จะไม่เขียนทับ เว้นแต่คุณจะขอ การ append เพิ่มแถว การแทนที่คือการล้างแล้วเขียนต่อบนแท็บที่คุณระบุ และเอเจนต์ทำเช่นนั้นเฉพาะเมื่อคำขอระบุไว้เท่านั้น

Looker Studio หรือ Power BI อ่านผลลัพธ์ได้ไหม

ได้ Hermoso ไม่มีตัวเชื่อมต่อโดยตรงไปยังทั้งสองตัว แต่ทั้งสองอ่าน Google Sheets ด้วยตัวเชื่อมต่อของตัวเอง ดังนั้นแดชบอร์ดที่สร้างบนชีตจะรีเฟรชเมื่อเอเจนต์ append ลงไป

รายงานรันตามกำหนดเวลาได้ไหม

ได้ จากไคลเอนต์ที่เอเจนต์ของคุณรันอยู่: งานตามกำหนดเวลาใน Claude หรือ ChatGPT หรือ cron job ที่เรียก Hermoso CLI หรือ API แต่ละรอบจะดึงช่วงเวลาใหม่และ append ลงไป