الترقية من Google Ads API

يمكنك ترقية عمليات تحميل الإحالات الناجحة من Google Ads API إلى Data Manager API للاستفادة من عدة تحسينات وميزات.

في ما يلي مقارنة بين استخدام Data Manager API وGoogle Ads API لإدارة الإحالات الناجحة.

Data Manager API Google Ads API
إتاحة إرسال الإحالات الناجحة غير الإلكترونية والإحالات الناجحة المحسّنة للعملاء المهتمين متوافقة. متوافقة.
إتاحة إرسال الإحالات الناجحة المسجّلة من علامة تتبُّع "إعلانات Google" كمصدر بيانات إضافي للإحالات الناجحة المسجّلة من علامة التتبُّع، وذلك لزيادة إشارات التفاعل مع الإعلان إلى أقصى حدّ وتعزيز بياناتك وأدائك العام متوافقة. غير متاح
نموذج بيانات نموذج بيانات موحّد في جميع حالات استخدام الإحالات الناجحة للإعلانات في "إعلانات Google" وجميع منتجات Google الإعلانية لا يُستخدَم نموذج البيانات إلا في حالات استخدام "إعلانات Google"، ويختلف باختلاف كل حالة استخدام.
التشفير يتيح التشفير. غير متاح
الرمز المميز للمطوِّر غير مطلوب. الحقل مطلوب.
إتاحة تحميل سمات الجلسات وعناوين IP للأحداث وهي متاحة لجميع مستخدمي واجهة برمجة التطبيقات. تتوفّر هذه الميزة لمستخدمي واجهة برمجة تطبيقات معيّنين فقط.
تعديلات قيم الإحالات الناجحة تتوفّر هذه الميزة في طريقة IngestEvents الموحّدة. يتطلّب ذلك استخدام ConversionAdjustmentUploadService بشكل منفصل.
الحصص والحدود الحصص والحدود لكل طلب المستندة إلى المشروع الحصص المستندة إلى الرمز المميّز للمطوّر والحدود القصوى لكل طلب
نموذج الخطأ يستخدم نموذج الفشل السريع. تستخدم نموذج تعذُّر جزئي.

الاختلاف في متطلبات حساب الوجهة

في Data Manager API، يجب أن يكون operating_account الوجهة هو عميل الإحالة الناجحة في "إعلانات Google". ويختلف ذلك عن Google Ads API.

تتيح Google Ads API إرسال الإحالات الناجحة لحساب على "إعلانات Google" باستخدام customer_id لأي مما يلي:

  1. عميل الإحالة الناجحة في "إعلانات Google":

    وتتيح Data Manager API استخدام هذا النهج.

  2. أي حساب رئيسي أو فرعي لعميل الإحالات الناجحة في "إعلانات Google".

    لا تتيح واجهة برمجة التطبيقات Data Manager API استخدام هذا الأسلوب. إذا كنت تستخدم هذا السلوك في Google Ads API، عليك تغيير operating_account لكل وجهة إلى مالك إجراء الإحالة الناجحة. قد يختلف ذلك عن customer_id الذي تستخدمه في طلبات Google Ads API.

تعديلات الإحالات الناجحة

تجمع واجهة Data Manager API بين عمليات تحميل الإحالات الناجحة الأولية وتعديلات الإحالات الناجحة اللاحقة في طريقة واحدة.

في Google Ads API:

  • يتطلّب تعديل الإحالات الناجحة استخدام طريقة UploadConversionAdjustments المنفصلة في ConversionAdjustmentUploadService.
  • إذا حاولت تحميل إحالات ناجحة متعددة باستخدام طريقة UploadClickConversions العادية لإجراء الإحالة الناجحة نفسه مع معرّف المعاملة نفسه (order_id)، سيتعذّر تنفيذ الطلب.
  • يجب تحديد ConversionAdjustmentType في الطلب.

في Data Manager API:

  • تستخدم عمليات تحميل الإحالات الناجحة وتعديلاتها نقطة النهاية الموحّدة IngestEvents.
  • عند تحميل حدث يتضمّن transaction_id حالي لإجراء الإحالة الناجحة نفسه مع قيم إحالات ناجحة أو بيانات مستخدمين معدَّلة، يتم التعامل معه تلقائيًا كتعديل. لن تعرض واجهة برمجة التطبيقات خطأ معرّف معاملة مكرّر.
  • لا يلزم تحديد نوع التعديل في الطلب. تستنتج واجهة برمجة التطبيقات Data Manager API كيفية معالجة التعديل استنادًا إلى الحقول المقدَّمة في الحدث.
  • على عكس Google Ads API، لا تتيح Data Manager API سحب الإحالات الناجحة، ما يؤدي إلى إزالة إحالة ناجحة تم تسجيلها سابقًا بالكامل من خلال ضبط قيمة الإحالة الناجحة وعددها على 0. يمكنك تعديل قيمة إحالة ناجحة، ولكن سيظل عدد الإحالات الناجحة كما هو.

لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة تعديلات قيم الإحالات الناجحة.

التالي
خطوات الترقية