تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

سحب البيانات الجغرافية للتجارب

بالنسبة إلى عمليات سحب البيانات الآلية أو الواسعة النطاق لتجارب GeoX، عليك استخدام Google Ads API لسحب بيانات التكلفة والإنفاق. بعد ذلك، يمكنك دمج هذه البيانات مع بيانات الإحالات الناجحة أو الإيرادات الأولية غير المفلترة وغير المنسوبة من نظام إدارة علاقات العملاء (CRM) الداخلي أو نقطة البيع أو قواعد بيانات المبيعات الداخلية.

بنية سير عمل واجهة برمجة التطبيقات المقترَحة

لسحب بيانات الحملة والتكلفة بدقة حسب الشرائح الجغرافية، اتّبِع هذه البنية:

الخدمة: استخدِم GoogleAdsService، وتحديدًا الطريقتَين Search أو SearchStream.
المورد: استخدِم طلب البحث geographic_view للاطّلاع على الموقع الجغرافي الفعلي للمستخدم أو الموقع الجغرافي الذي أبدى اهتمامًا به، وهو عادةً الإعداد التلقائي لتجارب GeoX. بدلاً من ذلك، استخدِم طلب البحث location_view للاطّلاع على الأداء استنادًا إلى المواقع الجغرافية المستهدَفة في الحملة.

ملاحظة: لا تستخدِم campaign_location_target_report، لأنّ هذا التقرير القديم في AdWords API تم إيقافه.
الحقول المطلوب تضمينها:
- campaign.id
- segments.date
- segments.geo_target_city (أو المنطقة أو البلد حسب درجة التفصيل في GeoX)
- metrics.cost_micros
نموذج طلب بحث بلغة GAQL: في GeoX، يسحب المعلنون مقاييس التكلفة باستخدام Google Ads API بدلاً من الإحالات الناجحة محدّدة المصدر (التي يجب أن تأتي من نظام إدارة علاقات العملاء الداخلي أو الأنظمة الخارجية). يمكنك استخدام طلب البحث التالي:
```
SELECT
  campaign.id,
  segments.date,
  segments.geo_target_city,
  metrics.cost_micros
FROM geographic_view
WHERE segments.date DURING LAST_30_DAYS
```
ملاحظة: geographic_view لا يعرض إلا صفوفًا للشرائح الجغرافية التي سجّلت مرّات ظهور أو إنفاقًا في تاريخ معيّن. لتضمين الأيام والمناطق التي لم يتم فيها الإنفاق في السلسلة الزمنية لـ GeoX، عليك إجراء عملية ربط خارجي من جهة اليسار في مسار البيانات مع الناتج الديكارتي الكامل للتاريخ والمناطق المستهدَفة.

المعالجة اللاحقة واستخراج البيانات

ربط الشرائح الجغرافية: لا تعرض واجهة برمجة التطبيقات أسماء نص عادي (مثل "نيويورك") أو رموزًا قصيرة (مثل "501" أو "ES") في الملفات الشخصية لإعداد التقارير. تعرض حقول مثل segments.geo_target_city أو segments.geo_target_country سلسلة اسم مورد تشير إلى GeoTargetConstant (على سبيل المثال، geoTargetConstants/1023191). استخرِج المعرّف الرقمي (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 الثابت للأهداف الجغرافية من الأهداف الجغرافية.
تكلفة الإحالة الناجحة: تعرض واجهة برمجة التطبيقات قيم التكلفة بالوحدات الصغيرة. عليك قسمة metrics.cost_micros على 1,000,000 لعرض قيمة العملة العادية المطلوبة في ملف التحميل.

معرّفات المواقع الجغرافية لتعديلات الاستهداف

عند تنفيذ تعديلات الاستهداف حسب الموقع الجغرافي للحملة أو المجموعة الإعلانية، على المعلنين البحث عن معرّف GeoTargetConstant الدقيق (geoTargetConstants/ID) للمناطق التي اختاروها وتمريره. لا يمكنك تمرير رموز ISO أو Nielsen الأولية.

نوع المنطقة	معرّف واجهة برمجة التطبيقات المطلوب (`GeoTargetConstant`)	التنسيق القديم (لا تستخدِمه)
منطقة سوق محددة	المعرّف `200501` (لنيويورك)	رمز Nielsen (مثلاً `501` لنيويورك)
البلد	المعرّف `2724` (لإسبانيا)	رمز ISO (مثلاً `"ES"` لإسبانيا)

أفضل الممارسات وأخطاء التنسيق الشائعة

تنسيق التاريخ: يعرض الحقل segments.date سلاسل التاريخ بتنسيق ISO-8601 بالتنسيق YYYY-MM-DD. في مسار ETL، عليك تسلسل حقول التاريخ بشكلٍ صريح كسلاسل YYYY-MM-DD وتجنُّب فتح ملفات CSV التي تم تصديرها في تطبيقات جداول البيانات التي تعيد تلقائيًا تنسيق أعمدة التاريخ.
الأصفار الأولية في الرموز البريدية: تعامَل مع الرموز البريدية (مثل 01234) كأنواع سلاسل (VARCHAR أو STRING) في مسار البيانات بدلاً من الأعداد الصحيحة حتى لا تتم إزالة الأصفار الأولية مطلقًا.
التجميع: إذا كنت تجري دراسة متعددة الخلايا، عليك تقديم مقاييس إنفاق منفصلة لكل مجموعة تجربة.
ربط بيانات الإحالات الناجحة: عند الربط ببيانات الإحالات الناجحة من نظام إدارة علاقات العملاء الداخلي أو قواعد بيانات المبيعات الداخلية، تأكَّد من أنّ بيانات الإحالات الناجحة تتضمّن الخصائص التالية لضمان معالجة البيانات بسلاسة باستخدام بيانات Google Ads API وGeoX:
- سلسلة زمنية يومية: يجب تجميع البيانات حسب اليوم.
- المستوى الجغرافي: يجب ربط كل إحالة ناجحة بالوحدات الجغرافية الدقيقة التي تختبرها (مثلاً، مطابقة الرمز البريدي لشحن العميل مع منطقة سوق محددة أو مجموعة الرموز البريدية المستخدَمة في التصميم).
- القيم الإجمالية: يجب أن تكون البيانات قيمًا مطلقة غير سالبة، مثل إجمالي الإيرادات أو إجمالي عدد الإحالات الناجحة. إذا كان نظام إدارة علاقات العملاء يتتبّع الإيرادات الصافية مع قيم سالبة لعمليات ردّ الأموال، عليك استخدام الأرقام الإجمالية للتجربة وتطبيق نسبة ردّ الأموال لاحقًا.

إعداد التقارير

الأخطاء غير المتزامنة