عبارات البحث هي الكلمات التي كتبها الناس فعلًا، لا الكلمات المفتاحية التي اشتريتها. والفجوة بين الاثنتين هي موضع معظم الإنفاق المهدور، وقراءتها استدعاء واحد لا يستطيع أن يغيّر شيئًا.
الاستدعاء
curl -sG https://top-rated.team/google-ads/v1/accounts/1234567890/report \ -H "X-API-KEY: $MAKEHYBRID_KEY" \ --data-urlencode 'query=SELECT search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC' \ --data-urlencode 'max_rows=200'
الاستعلام بلغة Google Ads Query Language، وكل ما يُبلِّغ عنه Google يمكن طلبه بهذه الطريقة: الحملات والمجموعات الإعلانية والكلمات المفتاحية والإعلانات والأصول والميزانيات والتحويلات والجماهير وسجل التغييرات. حتى 200 صف في الجواب الواحد.
قراءة ما يعود
- التكلفة بالمايكرو: 1,000,000 مايكرو هي وحدة واحدة من عملة الحساب. وعبارة تكلفتها 4,310,000 كلّفت 4.31.
- العبارة التي لها إنفاق ولا تحويلات خلال ثلاثين يومًا هي أول ما يُنظر فيه، والجواب المعتاد كلمة مفتاحية سلبية لا تعديل في سعر المزايدة.
- GET يأخذ الاستعلام في الرابط، وPOST إلى العنوان نفسه يأخذه في الجسم، للاستعلام الذي يطول فلا يتسع له الرابط. وكلاهما يقرأ فقط.
لا شيء في هذه الوصفة يستطيع تعديل الحساب. التقرير قراءة، والاستدعاء الذي يغيّر شيئًا استدعاء آخر، وفي طرفه إنسان.
أسئلة شائعة
هل أحتاج إلى معرفة GAQL؟
لكتابة استعلام يدويًا نعم، وهي قريبة من SQL بما يكفي لقراءتها دون تعلّم. وعمليًا يكتب وكيل الذكاء الاصطناعي على هذا المفتاح الاستعلام مما طلبته بالكلام، ويشغّله، ويقرأ عليك الصفوف.
لماذا المايكرو؟
هكذا يبلّغ Google عن المال، فهكذا يُجيب هذا: عدد صحيح من الأجزاء من المليون، يتفادى التقريب الذي تحصل عليه حين تتداول كسور العملة. اقسم على مليون تحصل على المبلغ الذي يقوله الإنسان.
هل يستطيع التقرير أن يلمس الحساب؟
لا. استدعاء التقرير يرفض كل ما ليس SELECT، فلا يوجد استعلام يمكن تمريره منه فيغيّر حسابًا — والخطأ هنا يكلّفك جوابًا محيّرًا لا غير.