الترقية من 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. يمكنك تعديل قيمة الإحالة الناجحة، ولكن سيظل عدد الإحالات الناجحة كما هو.

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

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