إعداد حساب الشريك

بعد التسجيل كشريك في برنامج "إدارة الأداء من Google"، ستحصل على حساب شريك. للوصول إلى إعدادات حساب الشريك، افتح Business Communications Developer Console وانقر على إعدادات حساب الشريك. من هنا، يمكنك إجراء ما يلي:

تعديل معلومات حساب الشريك

من صفحة الإعدادات، يمكنك الاطّلاع على رقم تعريف الشريك وتعديل المعلومات التالية:

الحقل الوصف
اسم الشريك اسم حساب الشريك
الاسم المعروض سيظهر الاسم في تقارير فوترة "إدارة الأداء على مستوى العملاء" التي تتلقّاها شركات الجوّال (كحقل owner_name ). ستستخدم شركات الجوّال هذه المعلومات لتحديدك كشريك موثوق ومحاولة التأكّد من إنشاء معلومات الفوترة الصحيحة لاستخدامك لميزة RBM للوصول إلى المشتركين. يجب أن يتطابق الاسم الذي تقدّمه هنا مع الاسم المستخدَم في عقود المراسلة مع مشغّل شبكة الجوّال.
جهة الاتصال الفنية

الجهة التي ستتواصل معها Google في حال حدوث أي مشاكل فنية متعلّقة بوكلائك. يمكنك تعديل

  • الاسم
  • عنوان البريد الإلكتروني الخاص بالشركة
  • رقم الهاتف
الردّ التلقائي على الويب هذا هو عنوان URL لنقطة نهاية الردّ التلقائي على الويب. انقر على ضبط لتعديله. عند ضبط webhook شريكك، ينطبق ذلك على جميع موظّفي الدعم. إذا كنت تريد استخدام مخطّط عمل مختلف لوكيل دعم، يمكنك ضبط مخطّط عمل وكيل دعم لن ينطبق إلا على هذا الوكيل.

إدارة العلامات التجارية

بصفتك شريكًا في برنامج "إدارة الأداء من خلال قنوات التسويق"، يمكنك إنشاء وكلاء نيابةً عن العلامات التجارية.

استخدِم صفحة العلامات التجارية في إعدادات الحساب لإضافة العلامات التجارية المرتبطة بحساب الشريك وتعديلها وإزالتها.

إضافة علامة تجارية

لإضافة علامة تجارية، أدخِل اسمها في حقل الإدخال وانقر على إضافة.

تعديل علامة تجارية

لتعديل علامة تجارية، اتّبِع الخطوات التالية:

  1. انقر على مربّع الاختيار بجانب اسم العلامة التجارية.
  2. انقر على الزر ، ثم انقر على تعديل الاسم.
  3. أدخِل التعديلات التي تريدها، ثم انقر على تم.

إزالة علامة تجارية

لا يمكن إزالة علامة تجارية إذا كانت مرتبطة بوكيل، حتى إذا لم يكن الوكيل مُطلقًا.

لإزالة علامة تجارية، انقر على مربّع الاختيار بجانب اسم العلامة التجارية، ثمّ انقر على حذف.

إدارة المستخدمين

يمكنك إدارة مستخدمي حساب الشريك من خلال صفحة المستخدمون في إعدادات الحساب. يكون للمستخدم الذي أنشأ حساب العميل دور "المالك". يمكن للمستخدمين الجدد الحصول على دور "مدير" أو "قارئ".

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

إضافة مستخدم

لإضافة مستخدم، أدخِل عنوان بريده الإلكتروني في حقل الإدخال واختَر دوره.

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

إزالة مستخدم

لإزالة مستخدم، يُرجى اتّباع الخطوات التالية:

  1. ابحث عن المستخدم الذي تريد إزالته، ثم انقر على الزر في صف الجدول الخاص به.
  2. اختَر إزالة المستخدم.
  3. أكِّد عملية الإزالة.

يتلقّى المستخدم الذي أزلته رسالة إلكترونية لإعلامه بأنّه لم يعُد لديه إذن بالوصول إلى حساب الشريك.

لا يمكنك إزالة مستخدم لديه دور "مالك". لتغيير المالك أو إزالته، عليك التواصل مع فريق الدعم.

تغيير دور المستخدم

لتعديل دور أحد المستخدمين، يُرجى اتّباع الخطوات التالية:

  1. ابحث عن المستخدم الذي تريد تعديل بياناته، ثم انقر على الزر في صفه في الجدول.
  2. اختَر تعديل الدور.
  3. اختَر دورًا جديدًا من القائمة المنسدلة.
  4. انقر على حفظ.

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

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

لمصادقة طلبات البيانات من واجهات برمجة التطبيقات بأمان، تحتاج أيضًا إلى أداة سطر الأوامر oauth2l.

اتّبِع الخطوات التالية لإنشاء مفتاح حساب خدمة:

  1. في إعدادات الحساب، انتقِل إلى صفحة حساب الخدمة.
  2. انقر على إنشاء مفتاح، ثمّ على إنشاء. ينزّل المتصفّح مفتاح حساب الخدمة.

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

ضبط رابط الردّ التلقائي على الويب الخاص بالشريك

رابط البيانات المجمّعة هو طلب استدعاء HTTPS ينشئه الشريك ويحدّد كيفية ردّ موظّف الدعم على الرسائل والأحداث. بعد ضبط رابط البيانات في الخادم، يمكنك بدء تلقّي الرسائل والأحداث.

إذا كنت تريد استخدام ردّ تلقائي على الويب مختلف لأيّ من موظّفي الدعم، يمكنك إعداد ردّ تلقائي على الويب على مستوى موظّف الدعم الذي سيلغي ردّ تلقائي على الويب الخاص بالشريك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط رابط ويب مخصّص للوكيل.

لضبط رابط webhook الخاص بالشريك، اتّبِع الخطوات التالية:

  1. افتح Business Communications Developer Console وسجِّل الدخول باستخدام حسابك على Google الخاص بشريكك في برنامج "الإعلانات على شبكة البحث".

  2. افتح إعدادات الحساب.

  3. بالنسبة إلى عنوان URL لردّ التلقائي على الويب في ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)"، انقر على ضبط.

  4. بالنسبة إلى عنوان URL لنقطة نهاية الردّ التلقائي على الويب، أدخِل عنوان URL للردّ التلقائي على الويب الذي يبدأ بحرف "https://".

  5. دوِّن قيمة clientToken. ستحتاج إلى ذلك للتحقّق من أنّ الرسائل التي تتلقّاها واردة من Google.

  6. عليك ضبط معلومات الردّ التلقائي على الويب لقبول طلب POST باستخدام المَعلمة clientToken المحدّدة وإرسال استجابة 200 OK مع قيمة النص العادي للمَعلمة secret كنص الاستجابة.

    على سبيل المثال، إذا تلقّى الويب هوك طلب POST يتضمّن محتوى يليه: 

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"1234567890"
}

    بعد ذلك، من المفترض أن يؤكّد رابط البيانات في خدمة ويب قيمة clientToken، وإذا كانت clientToken صحيحة، أن يعرض الردّ 200 OK مع 1234567890 كأحد عناصر الردّ:

    // clientToken from Configure
const myClientToken = "SJENCPGJESMGUFPY";

// Example endpoint
app.post("/rbm-webhook", (req, res) => {
  const msg = req.body;
  if (msg.clientToken === myClientToken) {
      res.status(200).send(msg.secret);
      return;
  }
  res.send(400);
});

  7. في Developer Console، انقر على إثبات الملكية. عندما يتحقّق "نظام إدارة الأداء من Google" من صحة مخطّط عمل الويب، يتم إغلاق مربّع الحوار.

للتعامل مع حالات تعذُّر إرسال وحدات الربط لطلبات البحث وضمان معالجة الرسائل بشكل موثوق، اطّلِع على التعامل مع الرسائل.

التحقّق من الرسائل الواردة

بما أنّ وحدات الربط بالويب يمكنها تلقّي رسائل من أي مُرسِلين، عليك التأكّد من أنّ Google أرسلت الرسائل الواردة قبل معالجة محتوى الرسالة.

للتأكّد من أنّ Google أرسلت رسالة تلقّيتها، اتّبِع الخطوات التالية:

  1. استخرِج عنوان X-Goog-Signature للرسالة. هذه نسخة مجزّأة ومشفّرة بترميز base64 من الحمولة في نص الرسالة.
  2. فك ترميز الحمولة في ميزة "الإعلانات المتجاوبة على شبكة البحث" باستخدام Base-64 في عنصر message.body من الطلب.
  3. استخدِم رمز العميل الخاص بتطبيقك على webhook (الذي حدّدته عند إعداد webhook) كمفتاح، وأنشئ دالة SHA512 HMAC من وحدات البايت الخاصة بحمولة الرسالة التي تم فك ترميزها باستخدام ترميز base-64 وقم بترميز النتيجة باستخدام ترميز base64.
  4. قارِن تجزئة X-Goog-Signature بتجزئة المحتوى التي أنشأتها.
    • إذا تطابقت التجزئات، يعني ذلك أنّك أكّدت أنّ Google أرسلت الرسالة.

    • إذا لم تتطابق التجزئات، تحقَّق من عملية التجزئة على رسائل معروفة بأنّها صالحة.

      إذا كانت عملية التجزئة تعمل بشكل صحيح وتلقّيت رسالة تعتقد أنّها تم إرسالها إليك عن طريق الاحتيال، تواصَل معنا.

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);

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

بعد إعداد حساب الشريك، حان وقت إنشاء وكيلك الأول.

السابق
التسجيل كشريك
التالي
إنشاء وكيلك الأول