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

bookmark_border تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

الأبعاد

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

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

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

في ما يلي السمات التي تريد تتبُّعها في هذا المثال:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تكون التقارير القابلة للتجميع بتنسيق 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). الحزمة والقيمة هما سلسلة من البايتات.

مفاتيح التجميع في الممارسة

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

بنية المفتاح

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

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

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

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

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

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

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

إذا كانت لديك n هدف قياس، سيتضمّن نوع هدف القياس n نوعًا مختلفًا من القيم.

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

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

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

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

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

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

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

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

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

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

ضبط قطعتَي مفتاح لكي تشكلا مفتاحًا كاملاً

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

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

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

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

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

وتُعرف هذه الأجزاء المختلفة من المفاتيح باسم "أجزاء المفتاح".

يتم احتساب المفتاح من خلال أخذ "أو" (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).
• نوع هدف القياس: 1 بت هدف القياس هو إما عدد عمليات الشراء أو قيمة الشراء، ما يعني احتمالين مختلفين، وبالتالي يكفي بت واحد لتخزين هذا.

• رقم تعريف الموقع الجغرافي: 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. يُجري المتصفّح عملية 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، والذي تحدّده على أنّه قيمة شراء.

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

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

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

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

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

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

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

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

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

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

• نوع هدف القياس = 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 × 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.