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

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

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

  • الخدمة: استخدِم GoogleAdsService، وتحديدًا Search أو SearchStream الطريقتَين.

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

  • الحقول المطلوب تضمينها:

  • نموذج طلب بحث بلغة 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

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

  • ربط الشرائح الجغرافية: لا تعرض واجهة برمجة التطبيقات أسماء نصية عادية (مثل "الإمارات") أو رموزًا قصيرة (مثل "501" أو "ES") في طرق عرض التقارير. تعرض حقول مثل segments.geo_target_city أو segments.geo_target_country سلسلة اسم مَورد تشير إلى GeoTargetConstant (على سبيل المثال، geoTargetConstants/1023191). ويمكن للمطوّرين استخدام طلب بحث عن جدول geo_target_constant مباشرةً:

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

    بدلاً من ذلك، لتنفيذ عملية الربط محليًا في الرمز، نزِّل ملف CSV الثابت للأهداف الجغرافية من الأهداف الجغرافية.

  • تكلفة الإحالة الناجحة: تعرض واجهة برمجة التطبيقات قيم التكلفة بالميكرو. يجب تقسيم metrics.cost_micros على 1,000,000 لعرض قيمة العملة العادية المطلوبة في ملف التحميل.

رموز الاستهداف (قانون الأسواق الرقمية والبلد)

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

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

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

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