وصِل Apple Ads وGoogle Drive بـ Hermoso، فيصبح الاثنان قابلين للاستدعاء من الوكيل نفسه. يسحب apple_ads_report صفوف الأداء؛ وcreate_sheet وappend_to_sheet يضعانها في جدول تملكه. بلا ملف تصدير، ولا مستودع بيانات، ولا أداة ثالثة تحتفظ ببيانات اعتمادك.
كيف يبدو ذلك
"اسحب إنفاق Apple Search Ads للأسبوع الماضي حسب الكلمة المفتاحية وألحقه بجدول Apple Ads الخاص بي." يستدعي الوكيل التقرير، ويشكّل الصفوف ويلحقها. اسأل مرة أخرى يوم الاثنين القادم، فيكبر الجدول بأسبوع.
نطاق Drive الذي يطلبه Hermoso هو drive.file، الذي يصل إلى الملفات التي أنشأها أو اخترتها، لا إلى Drive كله.
كيف تربط Apple Search Ads بجداول Google
- اربط الحسابين. في التطبيق، افتح Connectors واربط Apple Ads ثم Google Drive. يتشارك Sheets وDocs موافقة Google نفسها، فهي شاشة موافقة واحدة لا ثلاث. Apple Ads تبادل مفاتيح لا زر؛ ويشرحه دليل إعداد Apple Search Ads، بما في ذلك كيفية ربطه بـ Claude أو بـ ChatGPT، حيث ستكتب الطلب.
- اطلب أول سحب. "اسحب أداء Apple Search Ads حسب الحملة للأيام الثلاثين الأخيرة وضعه في جدول جديد باسم Apple Ads." يستدعي الوكيل
apple_ads_report، ثمcreate_sheet، ويعيد إليك الرابط. - اجعله متكررًا. الجملة نفسها مع "append" بدلًا من "جدول جديد"، وتُشغَّل وفق جدول من العميل الذي تستخدمه (مهمة مجدولة في Claude أو ChatGPT، أو مهمة cron تستدعي CLI الخاص بـ Hermoso)، فتلحق كتلة صفوف في كل مرة. لا يُستبدل شيء إلا إذا طلبت ذلك.
- وجّه لوحتك إلى الجدول. تقرأ Looker Studio وPower BI وTableau جميعها جداول Google بموصلاتها الخاصة.
كيف يبدو الجدول
صف واحد لكل كيان في كل فترة. تتبع الأعمدة المستوى الذي طلبته (الحملة أو مجموعة الإعلانات أو الإعلان أو الكلمة المفتاحية أو عبارة البحث)، إضافة إلى المقاييس التي تُبلغ عنها Apple: الظهور والنقرات والتثبيتات والإنفاق ونسبة النقر وتكلفة النقرة وتكلفة الاكتساب. اطلب تقريرًا يوميًا فيحصل كل كيان على صف في اليوم؛ واطلب المجاميع فيحصل على صف واحد. يستطيع الوكيل إضافة صف للمجاميع الكلية، وفي تقارير App Store يستطيع الاحتفاظ بالكيانات التي لا تُعرض، فتظهر الكلمة المتوقفة بصفر بدلًا من أن تختفي.
ولأن الوكيل يشكّل الصفوف قبل كتابتها، تستطيع أن تطلب الجدول الذي تريده تمامًا: الكلمات التي تتجاوز حدًا معينًا من الإنفاق فقط، واسم الحملة بجانب معرّفها، وتغيّرات الأسبوع مقارنةً بالأسبوع السابق محسوبة قبل الكتابة. هذا عمل تتركه صادرات CSV لك.
الإلحاق أو الاستبدال أو التنسيق
تغطي أدوات 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، وحدد الجدول والتبويب الذي يلحق فيه الوكيل. ابنِ التقرير مرة واحدة واتركه. كل إلحاق يظهر في تحديث البيانات التالي للوحة، ما دامت عناوين الأعمدة ثابتة بين كل تشغيل وآخر. النمط نفسه يعمل مع 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؟
اربط Apple Ads وGoogle Drive في Hermoso، ثم اطلب من وكيلك وضع التقرير في جدول. يسحب الصفوف بـ apple_ads_report ويكتبها بـ create_sheet أو append_to_sheet، ويعيد إليك الرابط.
هل يحتاج Hermoso إلى الوصول إلى Google Drive بالكامل؟
لا. يطلب drive.file، وهو يشمل الملفات التي أنشأها Hermoso والملفات التي تختارها صراحةً.
ما المستويات والمقاييس التي يمكن أن تدخل الجدول؟
مستوى الحملة أو مجموعة الإعلانات أو الإعلان أو الكلمة المفتاحية أو عبارة البحث، مع الظهور والنقرات والتثبيتات والإنفاق ونسبة النقر وتكلفة النقرة وتكلفة الاكتساب، كمجاميع أو كسلسلة بالساعة أو اليوم أو الأسبوع أو الشهر.
هل سيستبدل التقرير المجدول جدولي؟
لا، إلا إذا طلبت ذلك. الإلحاق يضيف صفوفًا؛ والاستبدال هو مسح ثم كتابة على التبويب الذي تسميه، ولا يفعل الوكيل ذلك إلا عندما يطلبه الطلب صراحةً.
هل تستطيع Looker Studio أو Power BI قراءة النتيجة؟
نعم. لا يملك Hermoso موصلًا أصليًا لأي منهما، لكن كليهما يقرأ جداول Google بموصلاته الخاصة، فتتحدث اللوحة المبنية على الجدول مع كل إلحاق يقوم به الوكيل.
هل يمكن أن يعمل التقرير وفق جدول زمني؟
نعم، من العميل الذي يعمل فيه وكيلك: مهمة مجدولة في Claude أو ChatGPT، أو مهمة cron تستدعي CLI أو API الخاص بـ Hermoso. كل تشغيل يسحب الفترة الجديدة ويلحقها.