ما الذي تفعله واجهة برمجة تطبيقات التحويل
واجهة برمجة تطبيقات التحويل (CAPI) ترسل أحداث التحويل من خادم Storeep مباشرة إلى منصة الإعلانات، متجاوزة متصفح المشتري. وبما أنها تعمل من خادم إلى خادم، فهي لا تتأثر بحاجبات الإعلانات أو إعدادات خصوصية المتصفح أو قيود التتبع في iOS، كما تنقل بيانات العملاء بشكل مشفر لتحسين جودة المطابقة للمزايدة الذكية والجماهير المشابهة. لمعلومات حول بيكسلات المتصفح، راجع المقال المصاحب بيكسلات المتصفح.
يمكنك تشغيل بيكسل المتصفح وCAPI لنفس المنصة في الوقت نفسه. يقوم Storeep بوضع معرف حدث مشترك مبني من نوع الحدث ورقم الطلب، حتى تقوم المنصة بدمجهما في تحويل واحد بدلاً من احتسابهما مرتين.
المنصات التي توفر CAPI
- فيسبوك / Meta: واجهة برمجة تطبيقات التحويل.
- تيك توك: واجهة برمجة أحداث.
- سناب شات: واجهة برمجة تطبيقات التحويل.
X وGoogle Ads لا توفران واجهة برمجة تطبيقات التحويل من جهة الخادم في Storeep؛ بل تعمل فقط من خلال المتصفح.
ما الذي يتم إرساله
عند كل طلب مؤهل، يرسل Storeep قيمة الطلب وعملته، عناصر المنتجات، وإشارات المشتري: البريد الإلكتروني المشفر، رقم الهاتف المشفر، معرف العميل المشفر (external_id)، عنوان IP، وكيل المستخدم، ولدى فيسبوك وسناب شات، الدولة السوقية المشفرة. كما يتم تمرير أي معرفات نقرات إعلانات موجودة في ملفات تعريف ارتباط المشتري (فيسبوك _fbc و_fbp، تيك توك ttclid، سناب شات ScCid) حتى تتمكن المنصة من ربط التحويل بالنقرة الأصلية.
أنواع أحداث التحويل
- فيسبوك: Lead أو Purchase فقط. لا ترسل CAPI لفيسبوك أحداث إضافة إلى السلة أو إتمام الشراء.
- تيك توك: Lead، Purchase، Place an order، أو Complete payment.
- سناب شات: Purchase أو Reserve.
العملة والطلبات بقيمة صفرية
يستخدم كل حدث عملة الطلب نفسه إذا كانت المنصة تدعم ذلك، وإلا يتم تحويل القيمة إلى الدولار الأمريكي. تتجاهل CAPI لفيسبوك أي طلب إجمالي قيمته 0، لأن Meta ترفض التحويلات بلا قيمة، وذلك للحفاظ على التوافق مع بيكسل المتصفح لفيسبوك.
تفعيل تتبع الطلبات المتروكة
هذا هو السلوك الأساسي الذي يجب فهمه. أي طلب جديد تماماً يُشغّل إرسال CAPI دائماً. أما الطلب المتروك فهو مختلف: لا يتم إرساله إلا إذا قمت بتفعيل خيار الطلبات المتروكة لهذا الإدخال في CAPI، وفقط عند تغيير حالة الطلب من متروك إلى أي حالة أخرى.
- مع إيقاف الطلبات المتروكة، لن يتم إرسال الطلبات المتروكة المستردة إلى المنصة أبداً.
- عند تفعيله، يتم إرسال الحدث عندما ينتقل الطلب من حالة المتروك، سواء غيرت الحالة يدوياً أو قام تطبيق Automator بتغييرها تلقائياً.
- إذا لم يكن Automator مثبتاً، يجب عليك نقل الطلب إلى حالة أخرى بنفسك حتى يتم إرسال الحدث.
- الخيار خاص بكل إدخال، لذا يمكنك تفعيل تتبع الطلبات المتروكة لمعرف بيكسل واحد وتركه مغلقاً لآخر.
تثبيت CAPI وحقوله
- افتح التطبيقات من القائمة الجانبية.
- ابحث عن تطبيق واجهة برمجة تطبيقات التحويل الذي تريده واضغط تثبيت ثم أكد العملية.
- افتح التطبيق مرة أخرى واضغط إضافة بيكسل جديد لإنشاء إدخال.
كل إدخال يحتوي على هذه الحقول:
- تفعيل: عند تشغيله، يتم إرسال أحداث التحويل من خادم إلى خادم. مفعّل افتراضياً.
- الطلبات المتروكة: خيار التفعيل الموضح أعلاه. مغلق افتراضياً.
- اسم حساب الإعلان: تسمية مرجعية لك فقط.
- معرف البيكسل: معرف بيكسل Meta أو تيك توك أو سناب شات الخاص بك.
- الأسواق: أسواق المتجر التي يغطيها هذا الإدخال. اختر سوقاً أو أكثر.
- نوع حدث التحويل: خيارات المنصة المذكورة أعلاه.
- رمز الوصول: رمز الوصول لواجهة برمجة تطبيقات التحويل الذي تنشئه في مدير أحداث المنصة. مطلوب.
- تفعيل وضع الاختبار: عند تشغيله، يتم إرسال الأحداث كأحداث اختبارية.
- رمز الاختبار: رمز الحدث التجريبي من المنصة، مثل TEST_1234. مطلوب عند تفعيل وضع الاختبار.
وضع الاختبار
عند تفعيل وضع الاختبار، تظهر الأحداث في عرض الأحداث التجريبية في المنصة حتى تتمكن من التأكد من التكامل دون التأثير على البيانات الحية. الأحداث التجريبية لا تدخل في مزايدة الإعلانات أو تحسينها، لذا قم بإيقاف وضع الاختبار قبل تشغيل الحملات الحية.
كيف تحدد الأسواق نطاق CAPI
يعمل إدخال CAPI فقط للطلبات التي تتم في الأسواق التي اخترتها له. الطلبات في سوق لم تحدده لن تُشغّل هذا الإدخال، لذا يمكنك استخدام معرف بيكسل ورمز وصول مختلفين لكل دولة من نفس المتجر.
أمور يجب التحقق منها
- استخدم نفس معرف البيكسل في بيكسل المتصفح وCAPI حتى تدمج المنصة الحدثين في تحويل واحد.
- إذا توقفت الأحداث عن الظهور في مدير أحداث المنصة، قد يكون رمز الوصول قد انتهت صلاحيته. أنشئ رمزاً جديداً وقم بتحديث الإدخال.
- كل إدخال مستقل. يمكنك إضافة عدة إدخالات لكل منصة، لكل منها معرف بيكسل ورمز وصول وأسواق ونوع حدث وإعداد تتبع الطلبات المتروكة خاص به.
- تذكر إيقاف وضع الاختبار قبل بدء الحملات الحية، وإلا فلن يتم احتساب التحويلات الحقيقية.