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

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

التكاملات المتاحة هي:

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

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

Adjust

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

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

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

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

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

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

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

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

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

5. نقل بيانات التحويلات

بشكل افتراضي، تُنقل بيانات نشاط المستخدمين من Adjust إلى AdsGram وتُعيَّن تلقائياً إلى الأهداف المقابلة:

• الجلسات (Sessions) - إلى Goal 1
• التثبيتات (Installs) - إلى Goal 2

مهم

لتشغيل حملة tCPA، يجب الحصول على 10 تحويلات على الأقل للهدف المحدد. على سبيل المثال، إذا تم تشغيل الحملة على Goal 2، يجب الحصول على 10 تحويلات على الأقل لـ Goal 2.

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 المطلوبة ومعلمة record. يجب أن يطابق اسم المعلمة معلمة record المحددة في Tracking Link.

   على سبيل المثال، إذا كنت تمرر ماكرو AdsGram في Tracking Link على النحو التالي:

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

   فيجب تحديد ما يلي في postback الخاص بـ Keitaro:

   https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}

   حيث:

   • YOUR_UNIQUE_TOKEN — الرمز من ملفك الشخصي في AdsGram
   • record — المعلمة التي تمررها في Tracking Link
   • {_record} — ماكرو ينقل القيمة الأصلية لمعلمة record إلى postback

   تحذير

   للحصول على قيمة خام من نظام التتبع، أضف "_" (شرطة سفلية) قبل اسم الماكرو. هذا ينطبق فقط على أداة التتبع 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 بشكل صحيح.

AppsFlyer

يتيح تكامل AdsGram مع AppsFlyer إرسال بيانات حول تثبيتات التطبيق وإجراءات المستخدمين داخل التطبيق إلى AdsGram.

بعد إعداد التكامل، سيحصل AdsGram على:

• تثبيتات التطبيق (Installs) - يتم تعيينها تلقائياً إلى Goal 1
• جميع الأحداث الأخرى داخل التطبيق (In-App Events) - يتم تعيينها تلقائياً إلى Goal 2

لا حاجة إلى أي إعداد إضافي أو ربط الأحداث بالأهداف في AdsGram. على سبيل المثال، إذا تم إرسال أحداث مثل registration وpurchase وdeposit وغيرها من AppsFlyer، فسيتم احتسابها جميعاً تلقائياً ضمن Goal 2.

IMPORTANT

يمكن تشغيل حملات tCPA فقط على Goal 1. هذا يعني أن حملات tCPA يمكن تحسينها فقط بناءً على تثبيتات التطبيق. لا يمكن استخدام الأحداث داخل التطبيق (In-App Events) المرسلة إلى Goal 2 كهدف لحملات tCPA.

1. ربط AdsGram عبر Integrated Partners

AdsGram هو شريك متكامل مع AppsFlyer. للربط:

• انتقل إلى Collaboration → Partner Marketplace في AppsFlyer
• ابحث عن AdsGram (الاسم التسويقي) أو adsgram1e_int (الاسم التقني) واختر الشريك

2. إعداد Postback الخاص بالتثبيتات

افتح تبويب Integration:

• فعّل Activate Partner
• عطّل AAP (يجب تعطيله في إعدادات التطبيق وفي هذا التبويب معاً)
• في Install Postback، اختر This partner only. هذا يعني أن AdsGram سيحصل على التثبيتات المنسوبة إلى AdsGram. سيتم احتساب هذه التثبيتات ضمن Goal 1 في AdsGram.

IMPORTANT

إذا كنت ترغب في تشغيل حملة محسّنة للتثبيتات، تأكد من أن التثبيتات تُرسل إلى AdsGram وتظهر ضمن Goal 1. لا يمكن تشغيل حملات tCPA المحسّنة للتثبيتات إلا على Goal 1.

3. إعداد Postback الخاص بالأحداث داخل التطبيق

قم بتكوين postbacks للأحداث داخل التطبيق (المشتريات، التسجيلات، إلخ) في قسم In-App Event Postbacks:

• أضف الأحداث المطلوبة، على سبيل المثال:
  • purchase - المشتريات
  • af_complete_registration - التسجيلات
• في حقل For users from، اختر This partner only
• يستقبل AdsGram الحدث نفسه فقط، دون معلماته أو الإيرادات المرتبطة به. لذلك يمكنك اختيار No values & no revenue في حقل Including

موصى به:

• السماح بتكوين التكامل (باستثناء postbacks الأحداث داخل التطبيق)
• السماح بتكوين postbacks الأحداث داخل التطبيق

الأذونات الأخرى (تقارير الاحتفاظ، الإيرادات، إلخ) اختيارية.

بعد إعداد التكامل، انقر على Save Integration.

4. إعداد Tracking Link

افتح تبويب Tracking Link:

• سيقوم AppsFlyer تلقائياً بإنشاء رابط تتبع لـ AdsGram وإضافة معرّف الشريك المطلوب: pid=adsgram1e_int
• سيتم ملء ماكرو AdsGram الأربعة تلقائياً (af_storeid، c، إلخ)
• أضف معلمات ثابتة إضافية إذا لزم الأمر
• في Click-through attribution، اختر نافذة الإسناد. الافتراضي 7 أيام، ويمكنك تغييرها إذا لزم الأمر

5. إعداد Permissions

افتح تبويب Permissions وفعّل الأذونات المطلوبة:

• الوصول إلى لوحة معلومات التطبيقات
• التحويلات المجمّعة
• الأحداث
• Protect360

👉 انقر على Save Integration

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

عند إنشاء حملة في AdsGram:

• أدخل Click link في حقل Link. سيقوم النظام تلقائياً بإنشاء رابط تتبع AppsFlyer وإضافة الماكرو المطلوبة
• حدد اسم package/bundle الخاص بك في رابط تتبع AppsFlyer إذا لم يكن مدرجاً بالفعل (مثال: id12345678 أو com.app.name)
• في حقل Link الذي يظهر، أدخل الرابط المباشر لمنتجك على Google Play / App Store / RuStore

7. ملاحظات

• ينطبق هذا الإعداد على جميع اللافتات ضمن الحملة
• المعلن مسؤول عن صحة معلمات الرابط والإسناد
• عند استخدام رابط مخصص، يجب أيضاً تحديد رابط مباشر للمنتج في حقل Link