الإحالات الناجحة غير الإلكترونية في "إعلانات Google"

استخدِم Data Manager API لإرسال بيانات الأحداث إلى الإحالات الناجحة غير الإلكترونية أو الإحالات الناجحة المحسّنة للعملاء المحتملين في "إعلانات Google".

إرسال الإحالات الناجحة غير الإلكترونية

إذا كنت تريد الترقية من Google Ads API، اطّلِع على مقالة الترقية من Google Ads API.

نظرة عامة على سير العمل

لإرسال بيانات الأحداث باستخدام Data Manager API، أكمل الخطوات التالية:

1. إعداد الوجهات: حدِّد عناصر Destination للحقل destinations في طلب الاستيعاب لتحديد الحساب المستهدف ووجهة الإحالة الناجحة أو الحدث. اطّلِع على إعداد الوجهات للحصول على التفاصيل.

2. إعداد بيانات الأحداث والمعرّفات: املأ حقول Event بتفاصيل الأحداث والمعرّفات المطلوبة (مثل معرّفات النقرات على الإعلانات أو العملاء أو نُسخ التطبيقات). إذا أدرجت معلومات الاتصال الخاصة بالمستخدم في userData، عليك تسوية المعرّفات وتجزئتها باستخدام خوارزمية SHA-256 وفقًا لإرشادات التنسيق، وتشفيرها اختياريًا. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد بيانات الأحداث.

3. إنشاء طلب الاستيعاب وإرساله: أرسِل طلبًا بتنسيق events.ingest يتضمّن سجلّات destinations وEvent وencryptionInfo إذا كنت قد userData. استخدِم validateOnly: true لاختبار الحمولة بحثًا عن أخطاء الإيقاف السريع قبل إرسال بيانات الإنتاج. يُرجى الاطّلاع على إرسال الأحداث لمعرفة متطلبات الحقول وعينات التعليمات البرمجية.

4. الاطّلاع على بيانات التشخيص وتعديل الإحالات الناجحة: يمكنك استرداد بيانات تشخيص المعالجة غير المتزامنة باستخدام requestStatus.retrieve وتعديل الإحالات الناجحة المسجّلة سابقًا أو سحبها حسب الحاجة.