تكاملات الشركاء

AdsGram متكامل مع Adjust و AppMetrica. كما يمكن العمل مع روابط من أدوات تتبع أخرى، لكن في هذه الحالة لن يتمكن AdsGram من نقل المعلومات الضرورية إلى أداة التحليل للحصول على تحليلات أكثر تفصيلاً.

مهم

يمكن للمعلنين الذين يستخدمون Adjust و AppMetrica لتطبيقاتهم المحمولة الآن الحصول على بيانات حول التحويلات التي قام بها المستخدمون بعد النقر على لافتات إعلانات AdsGram.

Adjust

1. اختيار الشبكة

في قسم Campaign Lab، انتقل إلى Partners

• انقر على New Partner.
• في شريط البحث، اكتب AdsGram واختر هذه الشبكة.
• بعد الاختيار، انقر على Next.

2. اختيار التطبيق

في الشاشة التالية، اختر التطبيق الذي تريد إنشاء الرابط له. استخدم شريط البحث للعثور على تطبيقك، أو تصفح القائمة للعثور عليه. يمكنك إعداد روابط لتطبيق واحد في كل مرة.
بعد اختيار التطبيق، انقر على Next.

3. تعيين خيارات مشاركة البيانات

في هذا القسم، ستقوم بتعيين معلمات مشاركة البيانات مع AdsGram، واختيار الأحداث ومعلمات التطبيق التي سيتم إرسالها إلى AdsGram للتحليل.
تتوفر تعليمات مفصلة في صفحة توثيق Adjust.

4. الحصول على رابط التتبع

بعد تكوين جميع المعلمات والتعيينات، ستتلقى رابط تتبع فريد، يجب استخدامه عند إنشاء الحملات الإعلانية في AdsGram.
بالإضافة إلى ذلك، يمكنك إضافة معلمات إضافية مثل علامات UTM لتتبع أكثر دقة لمصادر_traffic.

مهم

بعد إعداد روابط التتبع، سيتم عرض بيانات حول تحويلات المستخدمين إلى تثبيتات التطبيق وأحداث داخل التطبيق بعد النقر على إعلانات AdsGram فقط في واجهة Adjust.

AppMetrica

إنشاء أداة تتبع:

1. بعد التسجيل في حساب AppMetrica الشخصي، وتكامل SDK في التطبيق، وإعداد تتبع الإجراءات المستهدفة، يمكنك متابعة إنشاء أداة التتبع.
2. حدد اسم أداة التتبع.
3. أضف التطبيق.

تتوفر تعليمات مفصلة في صفحة توثيق AppMetrica.

نقل بيانات التثبيت:

4. اختر مستلم postback (AdsGram).
5. حدد نوع الحدث الذي يجب إرساله إلى AdsGram.
6. احصل على عنوان URL لـ Postback — الرابط الذي سيتم من خلاله إرسال الأحداث والتثبيتات إلى خادم AdsGram.
7. بعد إنشاء postbacks، ستتلقى رابط تتبع. يجب استخدام هذا الرابط عند إنشاء الحملات في AdsGram. بالإضافة إلى ذلك، يمكنك إضافة معلمات إضافية، مثل علامات UTM، إذا لزم الأمر.

Keitaro

1. إنشاء أداة تتبع في Keitaro

1. بعد تسجيل الدخول إلى لوحة Keitaro، انتقل إلى قسم Trackers.
2. انقر على Create tracker أو New tracker.
3. أدخل اسم أداة التتبع واختر AdsGram كنوع مصدر_traffic.
4. انقر على Save لإنشاء أداة التتبع.

2. تكوين Postback في Keitaro

1. في إعدادات أداة التتبع التي تم إنشاؤها، انتقل إلى قسم Postback أو API Integration.

2. في حقل Postback URL، أدخل نقطة نهاية AdsGram:

   https://api.adsgram.ai/confirm_conversion?

3. أضف معلمات الاستعلام المطلوبة التالية:

   token=YOUR_UNIQUE_TOKEN&record={_record_data}

   حيث YOUR_UNIQUE_TOKEN هو الرمز من ملفك الشخصي في AdsGram.

   تحذير

   للحصول على قيمة خام من نظام التتبع، أضف "_" (شرطة سفلية) قبل اسم الماكرو. هذا ينطبق فقط على أداة التتبع Keitaro وهو ضروري لمنع هجوم XSS.

3. إعداد حملة في AdsGram

1. انسخ Click URL من إعدادات أداة التتبع في Keitaro (على سبيل المثال: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. في لوحة AdsGram، عند إنشاء حملة، الصق هذا الرابط في حقل Click URL.
3. أضف الماكرو المطلوبة من AdsGram إلى الرابط:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. تأكد من تضمين الماكرو {record_data} في الرابط النهائي.

4. إعداد الأهداف في Keitaro

1. في إعدادات أداة التتبع في Keitaro، انتقل إلى قسم Goals أو Conversions.
2. أنشئ هدفاً جديداً أو اختر هدفاً موجوداً.
3. فعّل إرسال postback إلى عنوان URL المحدد مسبقاً لهذا الهدف.
4. حدد شروط التشغيل (على سبيل المثال، عند تأكيد التحويل أو حالة معينة).

Kochava

1. إنشاء أداة تتبع في Kochava

1. بعد تسجيل الدخول إلى لوحة Kochava، انتقل إلى قسم Apps & Assets.
2. انقر على Add New واختر App لإنشاء أداة تتبع تطبيق جديدة.
3. املأ الحقول المطلوبة:
   • Platform: اختر منصة التطبيق (iOS، Android، Web).
   • App Name: أدخل اسم تطبيقك.
   • Store ID: أدخل معرف متجر التطبيق (App Store ID، Package Name، إلخ).
4. انقر على Save لإنشاء التطبيق.

2. إعداد تكامل الشركاء

1. في صفحة التطبيق الذي تم إنشاؤه، انتقل إلى قسم Partner Management.
2. انقر على Add Partner.
3. ابحث عن AdsGram واختره من قائمة الشركاء.
4. انقر على Next للانتقال إلى إعدادات التكوين.

3. تكوين معلمات التكامل

1. في قسم Integration Settings، حدد نوع التتبع (Click-Through، View-Through، أو Hybrid).

2. فعّل خيار Server-to-Server Postbacks.

3. في حقل Postback URL، أدخل نقطة نهاية AdsGram:

   https://api.adsgram.ai/confirm_conversion

4. أضف المعلمات التالية إلى Postback Parameters:

   • المعلمة المطلوبة: {record_data} (يتم إدراجها تلقائياً بواسطة Kochava).
   • أضف معلمة: token مع القيمة YOUR_UNIQUE_TOKEN (مأخوذة من ملفك الشخصي في AdsGram).

5. قم بإعداد ماكرو تعيين البيانات:

   • {campaign_id} → campaign_id
   • {click_id} → click_id
   • {publisher_id} → publisher_id

4. إعداد حملة في AdsGram

1. ارجع إلى قسم Tracking Links في Kochava وأنشئ رابط تتبع (على سبيل المثال: https://your-app.kochava.com/install?data={encrypted_data}).
2. في لوحة AdsGram، عند إنشاء حملة، الصق هذا الرابط في حقل Click URL.
3. أضف الماكرو الإلزامية من AdsGram إلى الرابط كمعلمات:

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. تأكد من تضمين الماكرو {record_data} في عنوان URL النهائي.

5. إعداد الأحداث في Kochava

1. في لوحة Kochava، انتقل إلى قسم Events.
2. أنشئ حدثاً جديداً أو اختر حدثاً قياسياً (على سبيل المثال، install، purchase).
3. قم بتكوين postback للحدث المحدد:
   • فعّل Send Postback.
   • اختر تكامل AdsGram الذي تم إنشاؤه مسبقاً.
   • حدد عوامل التصفية وشروط التشغيل.
4. احفظ تكوين الحدث.

6. اختبار التكامل

1. استخدم Test Mode في Kochava للتحقق من تتبع التثبيتات.
2. تحقق من الطلبات الواردة في سجلات Kochava و AdsGram.
3. تأكد من تمرير معلمة record_data بشكل صحيح.