نظرة عامة

تمكن واجهة برمجة تطبيقات Pinterest للتحويلات المُعلِنين من إرسال التحويلات مباشرة إلى Pinterest عبر اتصال من خادم إلى خادم. كما يمكن بعد ذلك استخدام التحويلات التي تم تسجيلها باستخدام واجهة برمجة تطبيقات Pinterest لإعادة الاستهداف في الحملات الإعلانية ويمكن مراجعتها في تقارير التحويل لتحسين رؤية التحويل.

من خلال واجهة برمجة تطبيقات Pinterest للتحويلات، يمكن للمعلنين إرسال:

  • تحويلات الويب
  • تحويلات داخل التطبيق
  • تحويلات دون اتصال بالإنترنت
  • يمكن استلام الأحداث في الوقت الفعلي أو في غضون ساعة من وقوع الحدث وتسجيله. سيتم حساب الأحداث المستلمة خارج هذه النافذة أو كجزء من حدث دفعة متأخرة كتحويلات دون اتصال بالإنترنت. 

    يمكن أن يساعد استخدام واجهة برمجة تطبيقات Pinterest للتحويلات إلى جانب علامة Pinterest في زيادة الرؤية إلى أقصى حد في التحويلات التي تم تسجيلها. تتمثل أفضل الممارسات لدينا في استخدام كل من حلول تسجيل التحويل لضمان تلقيك عرضًا شاملًا لأداء الحملة الإعلانية للتحويل.

    واجهة برمجة تطبيقات Pinterest

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

    تحتوي منصة مطوري Pinterest على معلومات عن جميع منتجات واجهة برمجة تطبيقات Pinterest. 

    البدء

    يمكن لأي شخص لديه حساب أعمال على Pinterest الوصول إلى واجهة برمجة تطبيقات Pinterest للتحويلات.

    للبدء، ستحتاج أولًا إلى إنشاء رمز مميز للوصول. الرمز المميز للوصول هو سلسلة من الأحرف التي تتحقق من الطلبات التي يتم تقديمها وإرسالها مرة أخرى إلى حساب المستخدم الصحيح. 

    لإنشاء رمز مميز للوصول: 

  • قم بتسجيل الدخول إلى حساب أعمال Pinterest الخاص بك
  • انقر على الإعلانات في القائمة العلوية واختر التحويلات
  • حدد صفحة الرمز المميز للوصول إلى التحويل من التنقل الأيمن
  • انقر على الزر إنشاء رمز مميز جديد
  • انسخ الرمز المميز للوصول الجديد والعودة إلى عملية الإعداد.
  • إذا كنت تحاول الوصول إلى حساب لا تملكه، فستحتاج إلى إعداد Business Access أولًا. 

    تنفيذ

    أحداث التحويل: تتوفر جميع أنواع الأحداث المتاحة للتسجيل على علامة Pinterest أيضًا عبر واجهة برمجة تطبيقات Pinterest للتحويلات. يمكنك العثور على قائمة كاملة بالأحداث ومعلومات إضافية بشأن أهميتها في وثائق مطوري واجهة برمجة تطبيقات Pinterest لدينا.

    يتطلب إعداد تكامل واجهة برمجة التطبيقات من خادم إلى خادم موارد مطور وهندسة من مالك موقع الويب. سيختلف مقدار جهد المطور التقني اعتمادا على:

  • معرفة مطور البرامج بعمليات تكامل واجهة برمجة التطبيقات. إذا لم يسبق لهم إجراء تكامل واجهة برمجة التطبيقات من قبل ، فقد يحتاجون إلى عمل إضافي.  إذا كنت قد نفذت واجهة برمجة تطبيقات تحويل أخرى، فلن يحتاج مطور البرامج إلا إلى إجراء بعض التغييرات التدريجية.
  • سيتم إرسال عدد الأحداث التي يتم تتبعها وفي أي مرحلة من مراحل عملية التحويل إلى نا.
  • إذا كان المُعلِن يريد أو يحتاج إلى الاستعانة بجهة خارجية للتكامل (على سبيل المثال، Shopify، GTM، Tealium).
  • إذا كنت تستخدم علامة Pinterest بالفعل

    نوصي بشدة باستخدام واجهة برمجة تطبيقات Pinterest للتحويلات إلى جانب علامة Pinterest لضمان زيادة تحويلاتك إلى أقصى حد. 

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

    لتحقيق ذلك، ستحتاج إلى التأكد من المعلمة، ويتم تمرير event_id مرة أخرى باستخدام التحويلات التي تم تسجيلها بواسطة كل من علامة Pinterest وواجهة برمجة تطبيقات Pinterest للتحويلات. 

    سيتعرف نظامنا بعد ذلك على event_ids باعتبارها مكررة وسيحتفظ فقط بالتحويل الأول الذي تم تسجيله. لضمان نجاح إلغاء التكرار هذا، سيتعين أن تكون event_ids كما يلي:

  • يجب أن تكون event_ids متطابقة بين التحويلات نفسها - ينتقل الشخص إلى صفحة ويب ويتم تشغيل تحويل زيارة الصفحة من خلال كل من علامة Pinterest وواجهة برمجة تطبيقات Pinterest. سيحتاج التحويلان إلى إرسال event_ids متطابقة حتى يتعرف نظامنا على أنهما نفس التحويل. 
  • يجب أن تكون event_ids متطابقة بين التحويلات نفسها - ينتقل الشخص إلى صفحة ويب ويتم تشغيل تحويلات زيارة الصفحة من خلال كل من علامة Pinterest وواجهة برمجة تطبيقات Pinterest. ثم يضيف الشخص تي شيرتًا إلى عربته، ما يؤدي إلى تشغيل حدث AddToCart على كل من علامة Pinterest وواجهة برمجة تطبيقات Pinterest. وعلى الرغم من ضرورة مطابقة event_ids التي تم تشغيلها للأحداث نفسها، فإن event_ids التي يتم إرسالها لحدث زيارة الصفحة وحدث AddToCart يجب أن تكون فريدة. وبهذه الطريقة يتعرف نظامنا عليها باعتبارها أحداث منفصلة.
  • استنادًا إلى مُعرِّف الحدث وevent_name، سيزيل Pinterest أي أحداث مكررة من السجل، شريطة (أ) ألا يكون الحدث غير متصل بالإنترنت (action_source غير متصل بالإنترنت)، و(ب) أن يتلقى Pinterest الأحداث المتكررة في غضون 24 ساعة من بعضها.

    التحقق من إعدادك

    بمجرد الانتهاء من إعداد واجهة برمجة التطبيقات، يمكنك التحقق من تلقي أحداث التحويل عن طريق التحقق مما يلي:

  • رموز الاستجابة: يمكن للمطور الذي يعد تكامل واجهة برمجة التطبيقات مراجعة رموز الاستجابة التي تم إرجاعها مع كل طلب يتم إرساله مرة أخرى بعد إطلاق التحويل. 
  • صفحة إلغاء التكرار على مدير الإعلانات: ستظهر تحويلات ما بعد إلغاء التكرار في صفحة إلغاء التكرار على مدير الإعلانات. للوصول إلى صفحة إلغاء التكرار:
    • قم بتسجيل الدخول إلى حساب أعمال Pinterest الخاص بك
    • انقر على الإعلانات في القائمة العلوية واختر التحويلات
    • حدد إلغاء التكرار من التنقل الأيمن.
  • الجودة والمرونة

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

    حالة المرونة

    هناك فئتان من  حالة المرونة: جيدة وضعيفة. تظهر حالة المرونة الخاصة بك في قسم صحة التحويل في مدير الإعلانات.

    مرونة جيدة

    الخيار 1: تغطية محددة للمعرف

  • تغطية المعرف
    • يجب أن تحتوي 90% أو أكثر من الأحداث على IP/UA، 
    • يحتوي 10% أو أكثر من أحداث القمع الأدنى على بريد إلكتروني أو معرف MAID مجزأ، 
    • يحتوي 10% أو أكثر من الأحداث على معرف خارجي.
  • التداخل مع بيانات العلامة (عند الاقتضاء)
    • يجب استلام 90%* أو أكثر من أحداث العلامة من خلال CAPI 
  • أو:

    الخيار 2: تحقيق معدل المطابقة الأساسي

  • معدل مطابقة مستخدم CAPI يبلغ 60% أو أكثر
  • التداخل مع بيانات العلامة (عند الاقتضاء)
  • يجب استلام 90%* أو أكثر من أحداث العلامة من خلال CAPI 


  • مرونة ضعيفة

    أي إعداد غير جيد.

    المعرِّفات والإشارات الخاصة بالمرونة

    أرسل الإشارات التالية للوصول إلى حالة المعلن المرنة.

    معرِّف/إشارات واجهة برمجة التطبيقات الأوزان/التصنيف
    client_ip_address + client_user_agent مرتفع
    em مرتفع
    external_id مرتفع
    hashed_maid مرتفع
    click_id مرتفع
    fn + ln منخفض
    ph منخفض
    ge، bd، ct، st، zp، البلد منخفض

    *الأوزان/الرتبة بناء على احتمال زيادة معدل المطابقة

    تنفيذ الجهات الخارجية

    لدى Pinterest العديد من عمليات تكامل الجهات الخارجية للمساعدة في دعم عملية اعتماد واجهة برمجة التطبيقات. 

    إدارة العلامات من Google - جانب الخادم

    اربط حسابك في Google Tag Manager بواجهة برمجة تطبيقات Pinterest للتحويلات لمعرفة مدى تأثير Pinterest على الزيارات إلى متجرك ومبيعات منتجاتك.

    يتطلب منك هذا التكامل نشر حاوية خادم باستخدام مزود السحابة المفضل لديك ومعرفة وضع العلامات على جانب الخادم. لمزيد من المعلومات حول المتطلبات الأساسية، تفضل بزيارة موقع المطور

    Shopify

    تُتمم واجهة برمجة التطبيقات هذه تكامل تحويلات علامة Pinterest لضمان تغطية البيانات وجودتها بشكل عالٍ. إذا تم تثبيت التطبيق Shopify، فلا يلزم اتخاذ أي إجراء للاستفادة من هذا التحسين. وسيتم تطبيق التغييرات تلقائيًا على متجر التاجر.

    تيليوم

    يمكن للمُعلِنين المهتمين بـ Tealium إعداد واجهة برمجة التطبيقات لإجراء عمليات التحويل مباشرة مع الجهة الخارجية. يُنشئ Tealium القالب وسيساعد في تسهيل التكامل مع المُعلِن. 

    يتم تحديد عملية التنفيذ في مركز Tealium التعليمي. يمكن إرسال أي أسئلة عن دعم التنفيذ إلى support [at] tealium.com (support[at]tealium[dot]com)

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

    فهم المعالجة المحدودة للبيانات

    اعتبارًا من 1 يناير 2023، يمكن للمعلنين استخدام علامة المعالجة المحدودة للبيانات لمساعدتهم في الامتثال لقانون خصوصية المستهلك في كاليفورنيا، بصيغته المعدلة بموجب قانون حقوق الخصوصية في كاليفورنيا (يشار إليهما معًا بمصطلح "قانون خصوصية المستهلك في كاليفورنيا"). مع وجود هذه العلامة في مكانها الصحيح، ستقيد Pinterest من كيفية استخدامنا لبيانات معينة لمساعدة المعلنين في الامتثال لإعدادات خصوصية المستخدم. على سبيل المثال، قد ينفذ المعلن علامة المعالجة المحدودة للبيانات لمستخدمي كاليفورنيا الذين أوقفوا بيع بياناتهم أو مشاركتها بموجب قانون خصوصية المستهلك في كاليفورنيا. عند استخدام علامة المعالجة المحدودة للبيانات، سيعمل Pinterest بصفته مقدم خدمة بموجب قانون خصوصية المستهلك في كاليفورنيا فيما يتعلق بالبيانات التي تم وضع علامة عليها من المستخدمين في كاليفورنيا.

    يتحمل المعلنون مسؤولية الامتثال لإلغاء اشتراك المستخدم، بالإضافة إلى تحديد حالة إقامة المستخدم عند تنفيذ علامة المعالجة المحدودة للبيانات.

    End of Other articles Links
    هل ما زلت بحاجة إلى المساعدة؟ اتصل بنا
    User feedback
    هل كانت هذه المقالة مفيدة؟

    collection_fields

    كيف يمكننا تحسين هذه المقالة؟