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

مفاتيح التجميع وكيفية استخدامها في 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 بت، يمكن التعبير عن خيارين مختلفَين ⁿ.

على سبيل المثال، قد يكون عدد القيم الفريدة لسمة "البلد" هو 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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 بت من الأصفار:
   • قطعة المفتاح من جهة الالتقاط = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. يستخدم المتصفح هذه الأجزاء الرئيسية لإنشاء مفتاح.
   • مفتاح تجميع بسعة 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، والذي قرّرت تحديده على أنّه قيمة شراء.

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

يمكنك التفكير في الاستراتيجية A على أنها استراتيجية "شجرة واحدة عميقة":

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

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

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

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

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

الاستراتيجية ب: شجرتان ضحلتان (بنيتان رئيسيتان تقريبيتان)

في الاستراتيجية "ب"، تستخدِم اثنَين من بنى المفاتيح الأساسية، يتضمّن كلّ منهما مجموعة فرعية من السمات التي تحتاج إليها:

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

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

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

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

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

يمكنك اعتبار الاستراتيجية "ب" استراتيجية "شجرتَين سطحيتين":

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

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

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

الإستراتيجية أ أبسط؛ جميع البيانات تتبع نفس الهيكل الأساسي، مما يعني أيضًا أن لديك هيكلاً رئيسيًا واحدًا فقط ينبغي الحفاظ عليه.

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

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

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

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

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

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

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

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

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

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

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

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

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

عندما ينقر مستخدم على إعلان أو يعرضه، اضبط مفاتيح التجميع في العنوان 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 × 32768 = 32768
• 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.