نظرة عامة على إعداد التقارير

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فيديو: ورشة عمل GAQL

من خلال توحيد إعداد التقارير وطلبات البحث، لن تحتاج بعد ذلك إلى تعريف أي تقرير. يمكنك طلب الموارد مباشرةً باستخدام البيانات باستخدام SearchGoogleAdsStreamRequest أو SearchGoogleAdsRequest.

ابدأ في تخطيط ترحيل التقارير عن طريق الرجوع إلى جداول تعيين الحقول المناسبة. توضح هذه الجداول اسم حقل AdWords API وما يعادله في إعلانات Google API.

مثال

يعتبر تقرير أداء المجموعة الإعلانية وتقرير أداء الحملة من أكثر تقارير AdWords API استخدامًا. نحن نقدّم المقارنة بين طلبات البحث المكافئة في لغة طلب البحث في AdWords وAWQL في إعلانات Google:

تقرير أداء المجموعة الإعلانية
# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
تقرير أداء الحملة
# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
       metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

تقارير إحالة فردية في مقابل تقارير إحالة متعددة

أثناء الترحيل، قد تتطلب تقارير معينة في AdWords API معايير خاصة مثل تقرير أداء الكلمات الرئيسية أو تقرير أداء الفئة العمرية. وهناك نوعان من هذه التقارير:

  • تقارير الإحالة الفردية، مثل تقرير أداء المعايير أو تقرير أداء الكلمات الرئيسية، حيث يتم تسجيل معيار واحد فقط من المعايير التي تؤدي إلى الظهور (مثل موضع الإعلان والعمر والكلمة الرئيسية وما إلى ذلك) لمرة ظهور معيّنة: قد يتم عرض مرة ظهور من خلال معايير متعددة، ولكن في تقرير الإحالة الواحد، تتم إحالة الظهور وجميع إحصاءاته إلى معيار واحد فقط.

  • تقارير الإحالة المتعددة، مثل تقرير أداء الجنس أو تقرير أداء الموضع، حيث يتم تسجيل مرة ظهور واحدة حتى معيار واحد في كل بُعد يؤدي إلى مرة الظهور: يمكن اعتبار تقارير الإحالة المتعددة بمثابة تقارير خاصة بنوع المعايير. وعلى عكس الإحالة الفردية التي يمكن أن يحتوي فيها الصف على أنواع معايير مختلفة، يحتوي كل تقرير إحالة متعدد على معايير لنوع واحد من المعايير.

في إعلانات Google API، لا توجد تقارير إحالة فردية. جميع التقارير على مستوى معايير إعلانات Google API عبارة عن إحالة متعددة؛ بمعنى أن كل تقرير يخص مجموعة أنواع معايير واحدة فقط، ويلخص الإحصاءات وفقًا لمعايير هذا النوع. لا تضِف إحصاءات معًا من مصادر criteria_view مختلفة، لأنّ ذلك سيؤدّي إلى احتساب مزدوج للمجموع بشكل غير صحيح.

تضمين عنوان URL بدون مرات ظهور

AdWords API

في AdWords API، يمكنك استخدام الرأس includeZeroImpressions للتحكم في ما إذا كان سيتم عرض صفوف التقرير التي لا يتم عرض كل حقول المقاييس المحدّدة في طلب البحث بها أي قيم.

عيّن العنوان إلى true، فإخراج التقرير يتضمن هذه الصفوف؛ بالنسبة إلى false، لا يتضمن ذلك.

على الرغم من أن اسم رأس الصفحة يشير إلى "مرات الظهور"، يجب أن يكون صف التقرير صفرًا في جميع حقول المقاييس المحدّدة في الطلب (وليس مرات الظهور فقط) ليتم استبعاده عند ضبط العنوان على false.

لا يتوفر مثل هذا العنوان في إعلانات Google API؛ لذا لا يمكنك تعيين طلبات بحث AdWords API مباشرةً إلى طلبات البحث في إعلانات Google API.

كتقريب، يمكنك تحديد إسناد metrics.impressions > 0 في طلب البحث لاستبعاد صفوف التقرير التي تكون مرات الظهور لها صفرًا. في معظم الحالات، يؤدي ذلك إلى نتائج مكافئة عند ضبط عنوان AdWords API includeZeroImpressions على false. ونظرًا لأن مرات الظهور غير صفرية، غالبًا ما تكون قيم المقاييس الأخرى غير صفرية أيضًا.

ومع ذلك، يجب الانتباه إلى الحالات التي يكون فيها metrics.impressions صفرًا ولكن قيم المقاييس الأخرى (مثل metrics.search_impression_share المستند إلى التوقع) قد لا تكون كذلك، وبالتالي قد يتم عرض صف للتقرير.