فهم مفاتيح التجميع لإعداد تقارير تحديد المصدر

ما هي مفاتيح التجميع وكيفية استخدامها في Attribution Reporting API وكيفية ترجمة الأهداف إلى مفاتيح

بصفتك شركة لتكنولوجيا الإعلان تعرض حملات في مواقع جغرافية متعدّدة لفئات منتجات مختلفة، عليك مساعدة المعلِنين في الإجابة عن الأسئلة التالية:

1. كم عدد عمليات الشراء التي حقّقتها كل حملة من حملاتي في كل منطقة جغرافية لكل فئة منتج؟
2. ما هو مقدار الأرباح التي حقّقتها كل حملة من حملاتي في كل منطقة جغرافية لكل فئة منتجات؟

في حين تشجّع العديد من شركات تكنولوجيا الإعلان المعلِنين على إعداد مجموعة متنوّعة من أنواع الإحالات الناجحة، يُعدّ التركيز على الإحالات الناجحة الأكثر أهمية، مثل عمليات الشراء، طريقة جيدة للتأكّد من أنّ النتائج الموجزة مفصّلة ودقيقة لهذه الأحداث المهمة.

لإجراء ذلك، عليك التفكير في الأسئلة التي تريد الإجابة عنها قبل جمع البيانات.

السمات والمفاتيح والقيم

للإجابة عن هذه الأسئلة، لنلقِ نظرة على السمات والمفاتيح والقيم.

الأبعاد

لفهم كيف تحقّق حملاتك الإيرادات، كما هو موضّح هنا، عليك تتبُّع السمات التالية:

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

في حين أنّ سمة "رقم تعريف الحملة" وسمة "رقم تعريف المنطقة الجغرافية" تكونان معروفتَين عند عرض الإعلان (وقت عرض الإعلان)، ستكون "فئة المنتج" معروفة من حدث مشغِّل، وذلك عندما يُكمل المستخدِم إحالة ناجحة (وقت الإحالة الناجحة).

السمات التي تريد تتبُّعها في هذا المثال موضّحة في الصورة التالية:

ما هي مفاتيح التجميع (الحِزم)؟

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

مفتاح التجميع (المفتاح باختصار) هو جزء من البيانات يمثّل قيم السمات التي يتم تتبُّعها. يتم بعد ذلك تجميع البيانات على طول كل مفتاح تجميع.

على سبيل المثال، لنفترض أنّك تتتبّع السمات "فئة المنتج" و"معرّف الموقع الجغرافي" و"معرّف الحملة".

عندما يرى مستخدم مقيم في المنطقة الجغرافية ذات المعرّف 7 إعلانًا للحملة ذات المعرّف 12، ثم يُجري إحالة ناجحة من خلال شراء منتج في فئة المنتجات 25، يمكنك ضبط مفتاح تجميع يشبه المفتاح الوارد في الصورة التالية:

ستلاحظ لاحقًا أنّ مفتاح التجميع لا يبدو تمامًا على هذا النحو في الواقع، ولكن دعنا نركّز الآن على المعلومات الواردة في المفتاح.

ما هي القيم القابلة للتجميع؟

للإجابة عن أسئلتك بشأن السمات التي حدّدناها، عليك معرفة ما يلي:

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

كلّ من عدد عمليات الشراء لإحالة ناجحة واحدة وقيمة عمليات الشراء لإحالة ناجحة واحدة هما قيمتان يمكن تجميعهما. يمكنك اعتبار القيم القابلة للتجميع هي قيم أهداف القياس.

عندما يرى مستخدم في المنطقة الجغرافية التي تحمل المعرّف 7 إعلانًا للحملة التي تحمل المعرّف 12، ثمّ يُجري إحالة ناجحة من خلال شراء منتج من فئة المنتجات 25 مقابل 120 دولار أمريكي (بافتراض أنّ عملتك هي الدولار الأمريكي)، يمكنك ضبط مفتاح تجميع وقيم قابلة للتجميع على النحو التالي:

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

يتم جمع القيم القابلة للتجميع لإنشاء إحصاءات مجمّعة لأهداف القياس.

يُرجى العِلم أنّ هذا الرسم البياني لا يتضمّن فك التشفير ويمثّل مثالاً مبسطًا بدون تطبيق التشويش. في القسم التالي، سنوضّح هذا المثال مع الضوضاء.

من المفاتيح والقيم إلى التقارير

لنتحدّث الآن عن كيفية ارتباط المفاتيح والقيم القابلة للتجميع بالتقارير.

التقارير القابلة للتجميع

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

في مثالنا، عندما ينقر مستخدم على إعلان أو يشاهده ثمّ يُجري إحالة ناجحة لاحقًا، يمكنك توجيه المتصفّح لإنشاء مساهمتَين (واحدة لكلّ هدف قياس).

ستلاحظ لاحقًا أنّ التقرير القابل للتجميع {aggregation key, aggregatable value} لا يبدو تمامًا على هذا النحو، ولكن لنركّز الآن على المعلومات الواردة في التقرير.

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

يتضمّن التقرير القابل للتجميع ما يلي:

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

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

تحتوي الحمولة على قائمة بالمساهمات، وكل مساهمة هي زوج {مفتاح تجميع، قيمة قابلة للتجميع}:

• bucket: مفتاح التجميع، ويتم ترميزه كسلسلة بايت.
• value: القيمة القابلة للتجميع لهدف القياس هذا، ويتم ترميزها كسلسلة بايت.

وفي ما يلي مثال لذلك:

{
  "data": [
    {
      "bucket": "111001001",
      "value": "11111010000",
    }
  ],
  "operation": "histogram"
}

من الناحية العملية، يتم ترميز التقارير القابلة للتجميع بطريقة تجعل الحِزم والقيم تبدو مختلفة عن المثال السابق (أي أنّ الحزمة قد تبدو على النحو التالي: \u0000\u0000\x80\u0000). الحزمة والقيمة هما سلسلتا بايت.

التقارير الموجزة

يتم تجميع التقارير القابلة للتجميع على مستوى العديد من المتصفّحات والأجهزة (المستخدمين) على النحو التالي:

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

والنتيجة هي تقرير ملخّص يحتوي على مجموعة من أزواج {مفتاح التجميع، القيمة الملخّصة}.

يحتوي تقرير الملخّص على مجموعة من أزواج المفاتيح والقيم بتنسيق قاموس JSON. يحتوي كل زوج على ما يلي:

• bucket: مفتاح التجميع، ويتم ترميزه كسلسلة بايت.
• value: القيمة الموجزة بالنظام العشري لهدف قياس معيّن، ويتم جمعها من جميع التقارير المتاحة القابلة للتجميع، مع إضافة مستوى من التشويش.

مثال:

[
  {"bucket": "111001001", "value": "2558500"},
  {"bucket": "111101001", "value": "3256211"},
  {...}
]

من الناحية العملية، يتم ترميز التقارير الموجزة بطريقة تجعل الحِزم والقيم تبدو مختلفة عن تلك المذكورة في المثال (أي أنّ الحزمة قد تبدو مثل \u0000\u0000\x80\u0000). الحزمة والقيمة هما سلسلتا بايت.

مفاتيح التجميع في التطبيق العملي

تحدّد شركة تكنولوجيا إعلانية مفاتيح التجميع (المجموعات)، وعادةً ما يتم ذلك في خطوتَين: عند النقر على إعلان أو مشاهدته، وعندما يُجري المستخدم إحالة ناجحة.

بنية المفتاح

سنستخدم مصطلح البنية الأساسية للإشارة إلى مجموعة السمات المرمّزة في مفتاح.

على سبيل المثال، "معرّف الحملة" × "المعرّف الجغرافي" × "فئة المنتج" هي بنية أساسية.

أنواع المفاتيح

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

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

باستخدام المثال السابق، سيكون لنوع هدف القياس هذا قيمتان محتملتان مختلفتان:

• عدد عمليات الشراء هو النوع الأول من أهداف القياس.
• قيمة الشراء هي النوع الثاني من أهداف القياس.

إذا كان لديك ن من أهداف القياس، سيكون لنوع هدف القياس ن من أنواع القيم المختلفة.

يمكنك اعتبار سمات المفتاح مقياسًا. على سبيل المثال، "عدد عمليات الشراء لمنتج معيّن لكل حملة في كل منطقة جغرافية".

حجم المفتاح، حجم السمة

يتم تحديد الحد الأقصى لحجم المفتاح بوحدة البت، أي عدد الأصفار والآحاد في النظام الثنائي لإنشاء المفتاح الكامل. تسمح واجهة برمجة التطبيقات بطول مفتاح يبلغ 128 بت.

يسمح هذا الحجم بمفاتيح دقيقة جدًا، ولكن من المرجّح أن تؤدي المفاتيح الأكثر دقة إلى قيم أكثر تشويشًا. يمكنك الاطّلاع على مزيد من المعلومات حول التشويش في مقالة فهم التشويش.

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

على سبيل المثال، قد يكون لسمة "البلد" عدد قيم فريدة يبلغ 200، لأنّ هناك حوالي 200 بلد في العالم. كم عدد وحدات البت المطلوبة لترميز هذا المقياس؟

يمكن لـ 7 بت تخزين 2⁷ = 128 خيارًا مختلفًا فقط، وهو عدد أقل من 200 خيار المطلوب.

يمكن لـ 8 بت تخزين 2⁸ = 256 خيارًا مختلفًا، وهو أكثر من 200 خيار المطلوب، لذا يمكنك استخدام n=8 بت لترميز هذا البُعد.

ترميز المفتاح

عند ضبط المفاتيح في المتصفّح، يجب ترميزها بنظام الأرقام الستة عشرية. في تقارير الملخّص، ستظهر المفاتيح في شكل ثنائي (وسيتم تسميتها "حِزم").

ضبط قطعتَين أساسيتَين للحصول على مفتاح كامل

لنفترض أنّك تستخدم مفتاحًا لتتبُّع السمات التالية:

• الرقم التعريفي للحملة
• رقم تعريف الموقع الجغرافي
• فئة المنتج

في حين أنّ سمة "رقم تعريف الحملة" وسمة "رقم تعريف المنطقة الجغرافية" تكونان معروفتَين عند عرض الإعلان (وقت عرض الإعلان)، ستكون فئة المنتج معروفة من حدث مشغِّل، وذلك عندما يُكمل المستخدِم إحالة ناجحة (وقت الإحالة الناجحة).

يعني ذلك عمليًا أنّك ستضبط مفتاحًا في خطوتَين:

1. ستحدّد جزءًا واحدًا من المفتاح، وهو "رقم تعريف الحملة × رقم تعريف المنطقة الجغرافية"، عند النقر أو المشاهدة.
2. ستحدّد الجزء الثاني من المفتاح، أي فئة المنتج، في وقت الإحالة الناجحة.

تُسمّى هذه الأجزاء المختلفة من المفاتيح "أجزاء المفتاح".

يتم احتساب المفتاح من خلال أخذ OR (v) لأجزاء المفتاح.

مثال:

• جزء المفتاح من جهة المصدر = 0x159
• الجزء الرئيسي من مفتاح التفعيل = 0x400
• المفتاح = 0x159 v 0x400 = 0x559

مواءمة العناصر الأساسية

باستخدام جزأين من مفتاح 64 بت تم تمديدهما إلى 128 بت باستخدام حقول أو إزاحات 64 بت تم وضعها بعناية (الأصفار الستة عشر)، يكون ربط أجزاء المفتاح باستخدام OR مكافئًا لربطها، وهو ما يسهل فهمه والتحقّق منه:

• جزء المفتاح من جهة المصدر = 0xa7e297e7c8c8d0540000000000000000
• الجزء الرئيسي من مفتاح التفعيل = 0x0000000000000000674fbe308a597271
• المفتاح = 0xa7e297e7c8c8d0540000000000000000 v 0x0000000000000000674fbe308a597271 = 0xa7e297e7c8c8d054674fbe308a597271

مفاتيح متعدّدة لكل نقرة على الإعلان أو مشاهدة له

في الواقع، يمكنك ضبط مفاتيح متعدّدة لكل حدث مصدر تحديد مصدر (نقرة على الإعلان أو مشاهدة الإعلان). على سبيل المثال، يمكنك ضبط ما يلي:

• مفتاح يتتبّع رقم تعريف المنطقة الجغرافية × رقم تعريف الحملة.
• مفتاح آخر يتتبّع "نوع تصميم الإعلان" × "رقم تعريف الحملة".

يمكنك الاطّلاع على الاستراتيجية "ب" للحصول على مثال آخر.

ترميز السمات في المفاتيح

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

تحتوي تقارير الملخّص على أزواج {مفتاح، قيمة الملخّص} غير معالَجة، ولا تتضمّن أي معلومات إضافية عن المفتاح. ويعني هذا أنّ:

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

ترميز السمات باستخدام خرائط بنية المفاتيح

لتشفير السمات في المفاتيح، يمكنك إنشاء خريطة بنية مفاتيح والاحتفاظ بها مسبقًا عند تحديد مفاتيحك (قبل وقت عرض الإعلانات).

تمثّل خريطة البنية الأساسية كل سمة من سماتك وموضعها في المفتاح.

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

وفي ما يلي مثال لذلك:

لنفترض أنّك تخطّط لتتبُّع عمليات الشراء وقيمها لحملات ومناطق جغرافية ومنتجات معيّنة.

يجب أن تكون فئة المنتج ومعرّف الموقع الجغرافي ومعرّف الحملة سمات في مفاتيحك. بالإضافة إلى ذلك، بما أنّك تريد تتبُّع هدفَين مختلفَين للقياس، وهما عدد عمليات الشراء وقيمة عمليات الشراء، عليك إضافة سمة واحدة ضمن مفتاحك لتتبُّع نوع المفتاح. سيتيح لك ذلك تحديد ما تمثّله القيمة القابلة للتجميع عند تلقّي أزواج {المفتاح، القيمة القابلة للتجميع} في التقارير الموجزة.

مع أهداف القياس هذه، يتضمّن مفتاحك السمات التالية:

• فئة المنتج
• نوع هدف القياس
• رقم تعريف الموقع الجغرافي
• الرقم التعريفي للحملة

الآن، بالنظر إلى كل سمة، لنفترض أنّ حالة الاستخدام تتطلّب تتبُّع ما يلي:

• ‫29 فئة مختلفة من المنتجات
• 8 مناطق جغرافية مختلفة: أمريكا الشمالية وأمريكا الوسطى وأمريكا الجنوبية وأوروبا وأفريقيا وآسيا ومنطقة البحر الكاريبي وأوقيانوسيا
• ‫16 حملة مختلفة

في ما يلي عدد البتات التي تحتاج إليها لترميز كل سمة في مفتاحك:

• فئة المنتج: 5 بتات (2⁵ = 32 > 29).
• نوع هدف القياس: بت واحد هدف القياس هو إما عدد عمليات الشراء أو قيمة عمليات الشراء، ما يعني احتمالَين مختلفَين، وبالتالي يكفي بت واحد لتخزين ذلك.

• رقم تعريف الموقع الجغرافي: 3 بتات (2³ = 8). عليك أيضًا تحديد خريطة سمات لرقم التعريف الجغرافي لمعرفة المنطقة الجغرافية التي تمثّلها كل قيمة ثنائية. قد تبدو خريطة سمات "رقم التعريف الجغرافي" على النحو التالي:

  قيمة ثنائية في المفتاح	الموقع الجغرافي
  000	أمريكا الشمالية
  001	وسط أمريكا
  010	أميركا الجنوبية
  011	أوروبا
  100	أفريقيا
  101	آسيا
  110	جزر الكاريبي
  111	أوقيانوسيا

• رقم تعريف الحملة: 4 بتات (2⁴ = 16)

ستكون المفاتيح التي تتّبع هذه البنية بطول 13 بت (5 + 1 + 3 + 4).

في هذا المثال، ستبدو خريطة بنية المفاتيح لهذه المفاتيح على النحو التالي:

يعود إليك تحديد ترتيب السمات ضمن المفتاح.

لتوضيح كيفية تكوين السمات لبنية مفتاح، سنستخدم تمثيلاً ثنائيًا، ولهذا السبب يكون معرّف الحملة (البتات الأولى) هو الأيمن، وتكون فئة المنتج (البتات الأخيرة) هي اليسرى.

ضمن كل بُعد، يكون البت الأكثر أهمية، أي البت الذي يحمل أكبر قيمة عددية، هو البت الأيسر. إنّ البت الأقل أهمية، أي البت الذي يحمل أصغر قيمة رقمية، هو البت الأقصى على اليمين.

لنرى كيف يمكنك استخدام خريطة بنية المفتاح لفك ترميز مفتاح.

لنفترض أنّ لديك المفتاح العشوائي التالي: 0b1100100111100، وأنّ لديك طريقة لمعرفة أنّ هذا المفتاح يتّبع خريطة بنية المفتاح في الرسم التوضيحي السابق.

وفقًا لخريطة بنية المفتاح، سيتم فك ترميز هذا المفتاح إلى:

`11001 0 011 1100`

وبالتالي، يمثّل المفتاح 0b1100100111100 عدد عمليات شراء فئة المنتجات 25، وذلك للحملة التي تحمل المعرّف 12 والتي تم إطلاقها في أوروبا.

ترميز السمات باستخدام دالة تجزئة

بدلاً من استخدام خريطة بنية المفاتيح، يمكنك استخدام دالة تجزئة لإنشاء المفاتيح ديناميكيًا بطريقة متسقة وموثوقة.

تعمل هذه الميزة على النحو التالي:

1. اختَر خوارزمية تجزئة.
2. عند عرض الإعلان، أنشئ سلسلة تتضمّن جميع السمات التي تريد تتبُّعها وقيمها. لإنشاء جزء المفتاح من جهة المصدر، يجب إنشاء قيمة تجزئة لهذه السلسلة، ويمكنك إضافة لاحقة من الأصفار بطول 64 بت لمواءمتها مع جزء المفتاح من جهة المشغّل، ما يسهّل فهم عملية OR.
   • جزء مفتاح من جهة المصدر
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • يُرجى العِلم أنّ COUNT يرمّز إلى الشيء نفسه الذي يرمّز إليه measurementGoalType=0 في نهج خريطة بنية المفتاح. COUNT أكثر بساطة ووضوحًا.
3. عند حدوث الإحالة الناجحة، أنشئ سلسلة تتضمّن جميع السمات التي تريد تتبُّعها وقيمها. لإنشاء جزء من المفتاح من جهة المشغّل، يجب تشفير هذه السلسلة وإضافة بادئة من الأصفار بطول 64 بت:
   • Trigger-side key piece = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. يجمع المتصفّح هذه الأجزاء الرئيسية باستخدام عامل OR لإنشاء مفتاح.
   • مفتاح التجميع 128 بت
     = <64-bit hex source-side key piece hash><64-bit hex source-side key piece hash>
5. في وقت لاحق، عندما تكون مستعدًا لطلب تقرير ملخّص لهذا المفتاح، يمكنك إنشاؤه على الفور:
   • استنادًا إلى السمات التي تهمّك، أنشئ جزءًا رئيسيًا من جهة المصدر ومن جهة المشغّل كما فعلت سابقًا.
     • جزء مفتاح من جهة المصدر
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • جزء مفتاح التفعيل
       = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
     • جزء المفتاح من جهة المشغّل = toHex(hash("productCategory=25"))
   • تمامًا مثل المتصفّح، يمكنك ربط هذه الأجزاء الرئيسية لإنشاء المفتاح نفسه الذي أنشأه المتصفّح سابقًا.
     • مفتاح التجميع 128 بت
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

إليك بعض النصائح العملية إذا كنت تستخدم هذا الأسلوب المستند إلى التجزئة:

• استخدِم دائمًا الترتيب نفسه للأبعاد. يضمن ذلك إمكانية إعادة إنشاء التجزئات بشكل موثوق. (لن تنشئ "COUNT, CampaignID=12, GeoID=7" التجزئة نفسها التي تنشئها "COUNT, GeoID=7, CampaignID=12"). إحدى الطرق المباشرة لتحقيق ذلك هي ترتيب السمات أبجديًا رقميًا. هذا ما سنفعله في المثال، باستثناء أنّنا سنجعل دائمًا COUNT أو VALUE العنصر الأول في السمة، وهذا خيار لتسهيل القراءة، لأنّ COUNT أو VALUE يشفّر معلومات تختلف قليلاً من الناحية المفاهيمية عن جميع السمات الأخرى.
• تتبَّع مجموعة السمات التي تستخدمها في المفاتيح. عليك تجنُّب إنشاء مفاتيح استنادًا إلى مجموعة من السمات التي لم تستخدمها من قبل.
• تحدث تصادمات التجزئة بشكل نادر في حال استخدام دالة تجزئة مناسبة، ولكن يمكن تجنُّب إدخال مفاتيح جديدة تتصادم مع المفاتيح القديمة من خلال التحقّق من التجزئات المستخدَمة سابقًا (التي يجب تخزينها لتفسير النتائج من خدمة التجميع).

اطّلِع على كيفية استخدام المفاتيح المستندة إلى التجزئة عمليًا في مثال على إحالة ناجحة واحدة لكل نقرة أو مشاهدة.

القيم القابلة للتجميع في التطبيق

تحدّد شركة تكنولوجيا الإعلان قيمًا قابلة للتجميع عندما يُجري المستخدم إحالة ناجحة.

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

سنشير إلى هذا الحدّ باسم CONTRIBUTION_BUDGET. في الشرح، يُطلق على هذا الحدّ اسم ميزانية المستوى 1، ولكنّه مطابق CONTRIBUTION_BUDGET.

للحصول على مناقشة مفصّلة حول ميزانية المساهمة، يُرجى الاطّلاع على ميزانية المساهمة لتقارير الملخّصات.

مثال: إحالة ناجحة واحدة لكل نقرة أو مشاهدة

في هذا المثال، لنفترض أنّك تريد الإجابة عن الأسئلة التالية:

• ما هي فئات المنتجات الأكثر قيمة في كل منطقة؟
• ما هي استراتيجيات الحملات الأكثر فعالية في كل منطقة؟

لنفترض أيضًا أنّ حالة الاستخدام تتطلّب إحصاءات أسبوعية.

عليك أيضًا تتبُّع ما يلي:

• ‫16 حملة مختلفة
• 8 مناطق جغرافية مختلفة: أمريكا الشمالية وأمريكا الوسطى وأمريكا الجنوبية وأوروبا وأفريقيا وآسيا ومنطقة البحر الكاريبي وأوقيانوسيا
• ‫29 فئة منتجات مختلفة

ما يتم قياسه

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

في هذا المثال، سنركّز على إعدادات الحملة التي تقيس إحالة ناجحة واحدة فقط لكل نقرة أو مرّة مشاهدة: عملية شراء.

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

ماذا عن العملات؟

إنّ عرض الحملات في مناطق مختلفة يعني أنّه يجب أخذ العملات في الاعتبار. وفي هذا الإطار، يمكنك تنفيذ الإجراءات التالية:

• اجعل العملة سمة مخصّصة في مفاتيح التجميع.
• أو استنتاج العملة من رقم تعريف الحملة، وتحويل جميع العملات إلى عملات مرجعية

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

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

تحويل الأهداف إلى مفاتيح

باستخدام أهداف القياس والمقاييس، تتوفّر لك عدة خيارات لاستراتيجيتك الرئيسية. لنركّز على اثنتين من هذه الاستراتيجيات:

• الاستراتيجية (أ): بنية مفاتيح دقيقة واحدة
• الاستراتيجية (ب): هيكلان رئيسيان خشنان.

الاستراتيجية (أ): شجرة واحدة ذات مستويات متعددة (بنية مفتاح واحدة دقيقة)

في الاستراتيجية (أ)، يمكنك استخدام بنية مفتاح دقيقة تتضمّن جميع السمات التي تحتاج إليها:

تستخدم جميع مفاتيحك هذه البنية.

يمكنك تقسيم بنية المفتاح هذه إلى نوعَين رئيسيَين لتحقيق هدفَين متعلّقَين بالقياس.

• نوع المفتاح 0: نوع هدف القياس = 0، والذي تقرّر تعريفه على أنّه عدد عمليات شراء.
• نوع المفتاح 1: نوع هدف القياس = 1، والذي تقرّر تعريفه على أنّه قيمة شراء.

تبدو التقارير الموجزة على النحو التالي:

يمكنك اعتبار الاستراتيجية (أ) استراتيجية "شجرة واحدة بعمق واحد":

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

باستخدام الاستراتيجية (أ)، ستجيب عن أسئلتك على النحو التالي:

باستخدام الاستراتيجية "أ"، يمكنك أيضًا الإجابة مباشرةً عن السؤال الثالث:

"ما هو مقدار الأرباح التي حقّقتها كل حملة من حملاتي في كل منطقة جغرافية لكل منتج؟"

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

الاستراتيجية (ب): شجرتان غير عميقتين (بنيتان مفتاحيتان خشنتا التفاصيل)

في الاستراتيجية B، يمكنك استخدام بنيتَين رئيسيتَين غير دقيقة، تتضمّن كل منهما مجموعة فرعية من السمات التي تحتاج إليها:

يمكنك تقسيم كل بنية من هذه البنى الرئيسية إلى نوعَين رئيسيَّين لتحقيق هدفَين من أهداف القياس.

• نوع هدف القياس = 0، وهو ما تقرّر تعريفه على أنّه عدد عمليات شراء.
• نوع هدف القياس = 1، وهو ما تقرّر تعريفه على أنّه قيمة عملية شراء.

سينتهي بك الأمر بأربعة أنواع رئيسية:

• نوع المفتاح I-0: بنية المفتاح I، عدد عمليات الشراء
• النوع الرئيسي I-1: البنية الرئيسية I، قيمة الشراء
• نوع المفتاح II-0: بنية المفتاح II، عدد عمليات الشراء
• نوع المفتاح II-1: بنية المفتاح II، قيمة الشراء

تبدو التقارير الموجزة على النحو التالي:

يمكنك التفكير في الاستراتيجية "ب" على أنّها استراتيجية "شجرتان سطحيّتان":

• ترتبط قيم الملخّص في تقارير الملخّصات بإحدى مجموعتَين صغيرتَين من السمات.
• يمكنك تجميع قيم الملخّص هذه مع كل سمة من السمات في هذه المجموعات، ما يعني أنّ عمليات التجميع هذه ليست مفصّلة كما في الخيار (أ)، لأنّ هناك عددًا أقل من السمات التي يمكن التجميع على أساسها.

باستخدام الاستراتيجية "ب"، يمكنك الإجابة عن أسئلتك على النحو التالي:

القرار: الاستراتيجية (أ)

الإستراتيجية (أ) أبسط، إذ تتبع جميع البيانات بنية المفتاح نفسها، ما يعني أيضًا أنّ لديك بنية مفتاح واحدة فقط للحفاظ عليها.

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

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

كيف يمكنك تحديد الاستراتيجية المناسبة للاستخدام؟ بالنسبة إلى المعلِنين أو الحملات الحالية، يمكنك الاعتماد على البيانات السابقة لتحديد ما إذا كان عدد الإحالات الناجحة أنسب للاستراتيجية (أ) أو الاستراتيجية (ب). ومع ذلك، بالنسبة إلى المعلِنين أو الحملات الجديدة، يمكنك اتّخاذ أحد الإجراءَين التاليَين:

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

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

بما أنّ الاستراتيجية (أ) أبسط وتؤدي إلى تأثير ضوضاء لا يؤثر في قدرتك على اتخاذ القرارات، قررت استخدام الاستراتيجية (أ).

اختيار خوارزمية تجزئة

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

لنفترض أنّك اخترت SHA-256. يمكنك أيضًا استخدام خوارزمية أبسط وأقل أمانًا، مثل MD5.

في المتصفّح: ضبط المفاتيح والقيم

بعد تحديد بنية المفتاح وخوارزمية التجزئة، يمكنك تسجيل المفاتيح والقيم عندما ينقر المستخدمون على الإعلانات أو يعرضونها ثم يُجرون إحالات ناجحة.

في ما يلي نظرة عامة على العناوين التي ستضبطها لتسجيل المفاتيح والقيم في المتصفّح:

ضبط أجزاء المفتاح من جهة المصدر

عندما ينقر المستخدم على إعلان أو يشاهده، اضبط مفاتيح التجميع في العنوان Attribution-Reporting-Register-Aggregatable-Source. في هذه المرحلة، يمكنك ضبط جزء المفتاح فقط، أو جزء المفتاح، المعروف في وقت عرض الإعلان.

لننشئ الأجزاء الرئيسية:

لنحدّد الآن الأجزاء الرئيسية:

// Upon receiving the request from the publisher site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Source",
  JSON.stringify([
    {
      "id": "key_purchaseCount",
      "key_piece": "0x3cf867903fbb73ec0000000000000000"
    },
    {
      "id": "key_purchaseValue",
      "key_piece": "0x245265f432f16e730000000000000000"
    }
  ])
);

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

اختياري: التقارير على مستوى الحدث

إذا كنت بحاجة إلى استخدام تقارير على مستوى الحدث إلى جانب التقارير القابلة للتجميع، تأكَّد من إمكانية مطابقة البيانات على مستوى الحدث (معرّف حدث المصدر وبيانات عامل التشغيل) ومفتاح التجميع لمصدر معيّن.

يمكنك استخدام كلا التقريرَين إذا كنت تخطّط مثلاً لاستخدام التقارير على مستوى الحدث لتشغيل نماذج تحدّد أنواع الإعلانات التي تؤدي عادةً إلى أكبر عدد من عمليات الشراء.

إجراء مستخدم لإحالة ناجحة

عندما يُجري المستخدم إحالة ناجحة، يتم عادةً إرسال طلب بكسل إلى خادم تكنولوجيا الإعلان. عند تلقّي هذا الطلب:

• اضبط الأجزاء الرئيسية على جهة الإحالة الناجحة (جهة المشغّل) لإكمال المفتاح. يمكنك ضبط هذه الأجزاء الرئيسية باستخدام العنوان Attribution-Reporting-Register-Aggregatable-Trigger-Data.
• اضبط القيمة القابلة للتجميع لهذه الإحالة الناجحة باستخدام العنوان Attribution-Reporting-Register-Aggregatable-Values.

ضبط أجزاء المفتاح من جهة المشغّل لإكمال المفتاح

لننشئ الأجزاء الرئيسية:

لنحدّد الآن الأجزاء الرئيسية:

// Upon receiving the pixel request from the advertiser site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Trigger-Data",
  JSON.stringify([
    // Each dictionary independently adds pieces to multiple source keys
    {
      "key_piece": "0x0000000000000000f9e491fe37e55a0c",
      "source_keys": ["key_purchaseCount", "key_purchaseValue"]
    },
  ])
);

لاحظ كيف تتم إضافة جزء المفتاح نفسه إلى عدة مفاتيح، وذلك من خلال إدراج عدة معرّفات مفاتيح في source_keys، وسيتم إضافة جزء المفتاح إلى كلا المفتاحين.

ضبط القيم القابلة للتجميع

قبل ضبط القيم القابلة للتجميع، عليك توسيع نطاقها من أجل تقليل التشويش.

لنفترض أنّه تم إجراء عملية شراء واحدة لنوع المنتج 25 بقيمة 52 دولارًا أمريكيًا.

لن يتم ضبط هذه القيم مباشرةً كقيم قابلة للتجميع:

• ‫key_purchaseCount: إحالة ناجحة واحدة
• key_purchaseValue: 52 دولار أمريكي

بدلاً من ذلك، قبل تسجيل هذه القيم القابلة للتجميع، عليك توسيع نطاقها لتقليل التشويش إلى الحدّ الأدنى.

لديك هدفان لإنفاق ميزانية المساهمة، لذا يمكنك تقسيمها إلى قسمَين.

في هذه الحالة، يتم تخصيص CONTRIBUTION_BUDGET/2 كحد أقصى لكل هدف (=65,536/2=32,768).

لنفترض أنّ الحدّ الأقصى لقيمة الشراء لمستخدم واحد، استنادًا إلى سجلّ الشراء لجميع مستخدمي الموقع الإلكتروني، هو 1,500 دولار أمريكي. قد تكون هناك قيم متطرفة، مثل عدد قليل جدًا من المستخدمين الذين أنفقوا أكثر من هذا المبلغ، ولكن يمكنك تجاهل هذه القيم المتطرفة.

يجب أن يكون عامل القياس لقيمة الشراء كما يلي:

((CONTRIBUTION_BUDGET/2) / 1,500) = 32,768/1,500 = 21.8 ≈ 22

عامل القياس لعدد عمليات الشراء هو 32,768/1 = 32,768، لأنّك قرّرت تتبُّع عملية شراء واحدة على الأكثر لكلّ نقرة على الإعلان أو مشاهدة (حدث المصدر).

يمكنك الآن ضبط القيم التالية:

• ‫key_purchaseCount: 1 × 32,768 = 32,768
• key_purchaseValue: 52 × 22 = 1,144

في الواقع، يمكنك ضبطها على النحو التالي باستخدام العنوان المخصّص Attribution-Reporting-Register-Aggregatable-Values:

// Instruct the browser to schedule-send a report
res.set(
  "Attribution-Reporting-Register-Aggregatable-Values",
  JSON.stringify({
    "key_purchaseCount": 32768,
    "key_purchaseValue": 1144,
  })
);

يتم إنشاء التقرير القابل للتجميع

يُطابق المتصفّح الإحالة الناجحة مع عرض أو نقرة سابقَين وينشئ تقريرًا قابلاً للتجميع يتضمّن الحمولة المشفّرة بجانب بيانات التقرير الوصفية.

في ما يلي مثال على البيانات التي يمكن العثور عليها ضمن حمولة التقرير القابل للتجميع، إذا كان من الممكن قراءتها بنص عادي:

[
  {
    key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece OR conversion-side key piece for the key key_purchaseCount
    value: 32768 // the scaled value for 1 conversion, in the context of [CONTRIBUTION_BUDGET/2]
  },
  {
    key: 0x245265f432f16e73f9e491fe37e55a0c, // source-side key piece OR conversion-side key piece for the key key_purchaseValue
    value: 1144 // the scaled value for $52, in the context of [CONTRIBUTION_BUDGET/2]
  },
]

يمكنك هنا الاطّلاع على مساهمتَين منفصلتَين ضمن تقرير واحد قابل للتجميع.

طلب تقرير ملخّص

• التقارير المجمّعة القابلة للتجميع اتّبِع النصائح الواردة في مقالة التجميع.
• أنشئ المفاتيح التي تريد الاطّلاع على بياناتها. على سبيل المثال، للاطّلاع على بيانات الملخّص الخاصة بـ COUNT (إجمالي عدد عمليات الشراء) وVALUE (إجمالي قيمة الشراء) لمعرّف الحملة 12 × معرّف المنطقة الجغرافية 7 × فئة المنتج 25:
  • أنشئ جزء المفتاح من جهة المصدر، كما فعلت عند ضبطه في المتصفّح.
  • أنشئ جزء مفتاح مشغّل الإعلانات، كما فعلت عند ضبطه في المتصفّح.

• اطلب بيانات ملخّصة من "خدمة تجميع البيانات" لهذه المفاتيح.

التعامل مع تقرير الملخّص

في النهاية، ستتلقّى تقريرًا موجزًا قد يبدو على النحو التالي:

[
  {"bucket": "00111100111110000110011110010000001111111011101101110011111011001111100111100100100100011111111000110111111001010101101000001100",
    "value": "2558500"},
  {"bucket": "00100100010100100110010111110100001100101111000101101110011100111111100111100100100100011111111000110111111001010101101000001100",
    "value": "687060"},
  …
]

الحزمة الأولى هي مفتاح COUNT في النظام الثنائي. المجموعة الثانية هي VALUE بالمخطط الثنائي. يُرجى العِلم أنّه على الرغم من أنّ المفاتيح غير متجانسة (COUNT مقابل VALUE)، إلا أنّها مضمّنة في التقرير نفسه.

تقليل القيم

• يشير الرقم 2,558,500 إلى عدد عمليات الشراء لهذا المفتاح، مع مضاعفة العدد حسب عامل المضاعفة الذي سبق أن حسبته. كان عامل القياس لعدد عمليات الشراء هو 32,768. قسِّم 2,558,500 على ميزانية مساهمة الهدف: 2,558,500/32,768 = 156.15 عملية شراء.
• ‫687,060 → 687,060/22 = 31,230 دولار أمريكي إجمالي قيمة الشراء

نتيجةً لذلك، تمنحك التقارير الموجزة الإحصاءات التالية:

- Within the reporting time period, campaign #12
  run in Europe drove about 156 purchases (± noise)
  for the product category #25
  ```

  ```text
- Within the reporting time period, campaign #12
  run in Europe drove $31,230 of purchases (± noise)
  for the product category #25.