الإحالات الناجحة غير الإلكترونية في "إعلانات 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 وتعديل الإحالات الناجحة المسجّلة سابقًا أو سحبها حسب الحاجة.