استخدِم Data Manager API لإرسال بيانات الأحداث من أجل الإحالات الناجحة غير الإلكترونية أو الإحالات الناجحة المحسّنة للعملاء المهتمين في "إعلانات Google".
إرسال الإحالات الناجحة غير الإلكترونية
إذا كنت تُجري الترقية من Google Ads API، يُرجى الاطّلاع على الترقية من Google Ads API.
نظرة عامة على سير العمل
لإرسال بيانات الأحداث باستخدام Data Manager API، أكمِل الخطوات التالية:
إعداد الوجهات: حدِّد عناصر
Destinationللحقلdestinationsفي طلب نقل البيانات لتحديد الحساب المستهدَف ووجهة الإحالة الناجحة أو الحدث. يُرجى الاطّلاع على إعداد الوجهات لمعرفة التفاصيل.إعداد بيانات الأحداث والمعرّفات: أنشئ كل
Eventوضمِّن أي حقول ومعرّفات مطلوبة. يجب تسوية أي معلومات اتصال للمستخدمين وتجزئتها باستخدام خوارزمية SHA-256 فيuserDataوفقًا لإرشادات التنسيق، وتشفيرها اختياريًا. لمزيد من التفاصيل، يُرجى الاطّلاع على إعداد بيانات الأحداث.إنشاء طلب نقل البيانات وإرساله: أرسِل طلب
events.ingestيحتوي علىdestinationsوسجلّاتEventوencryptionInfoإذا كنت قد شفّرتuserData. استخدِمvalidateOnly: trueلاختبار الحمولة بحثًا عن أخطاء الفشل السريع قبل إرسال بيانات الإنتاج. يُرجى الاطّلاع على إرسال الأحداث لمعرفة متطلبات الحقول وعينات التعليمات البرمجية.التحقّق من حالة الطلب وبيانات التشخيص وتعديل الإحالات الناجحة: يمكنك التحقّق من حالة المعالجة غير المتزامنة ومراجعة بيانات التشخيص باستخدام
requestStatus.retrieve، وتعديل الإحالات الناجحة المسجّلة سابقًا أو سحبها حسب الحاجة.