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

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

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

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

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

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

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

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

ملاحظة: إنّ مفاتيح التجميع التي تمت مناقشتها في هذا المستند خاصة بواجهة برمجة التطبيقات Attribuion Reporting API.

الأبعاد

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

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

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

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

• السمات المعروفة في وقت عرض الإعلان على خلفية خضراء
• السمات المعروفة في وقت الإحالة الناجحة على خلفية صفراء ومسطرة

تظهر الأبعاد التي تريد تتبعها في هذا المثال في الصورة التالية:

السمات التي يجب تتبّعها

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

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

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

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

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

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

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

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

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

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

السؤال	القيمة القابلة للتجميع = هدف القياس
		كم عدد عمليات الشراء...	عدد عمليات الشراء
ما مقدار الأرباح...	قيمة الشراء

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

مفتاح التجميع والقيم القابلة للتجميع. ملاحظة: تظهر القيم المجمّعة بخط غامق على خلفية زرقاء.

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

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

لاحظ أن هذا المخطّط البياني يغفل فك التشفير ويمثّل مثالاً مبسّطًا بدون تطبيق تشويش. في القسم التالي، سنوضح هذا المثال مع تضمين التشويش.

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

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

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

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

ملاحظة: في الأداة التوضيحية، يُسمّى الزوج {aggregation key, aggregatable value} أيضًا مساهمة المدرج التكراري: وهو يمثّل كيفية مساهمة هذه الإحالة الناجحة والسمات والقيم المرتبطة بها في تقرير الملخّص.

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

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

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

يحتوي التقرير القابل للتجميع على:

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

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

تحتوي الحمولة على قائمة بالمساهمات، كل منها عبارة عن زوج {aggregation key, aggregatable value} :

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

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

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

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

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

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

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

النتيجة هي تقرير ملخص يحتوي على مجموعة من أزواج {aggregation key, summary value}.

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

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

مثال:

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

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

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

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

البنية الأساسية

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

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

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

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

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

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

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

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

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

حجم المفتاح وحجم البُعد

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

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

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

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

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

ستؤدي 8 بت إلى تخزين 2⁸ = 256 خيارًا مختلفًا، ما يزيد عن الـ 200 الضرورية اللازمة، لذا يمكنك استخدام n=8 بت لترميز هذا البُعد.

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

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

ملاحظة: عادةً ما تبدأ البيانات السداسية العشرية بـ 0x. على سبيل المثال، 0x19 هو 19 بالنظام السداسي العشري؛ تساوي 25 في النظام العشري وليس 19. تبدأ الأرقام الثنائية عادةً بـ 0b. على سبيل المثال، 0b11001 هو 11001 في النظام الثنائي. 25 في النظام العشري، وليس 11,001.

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

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

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

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

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

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

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

تحذير: يصف هذا المستند بشكل خاطئ الأجزاء الرئيسية التي يتم دمجها باستخدام Bitwise-XOR، في حين أنه يتم دمجها في الواقع باستخدام bitwise-OR.

يتم حساب المفتاح من خلال أخذ XOR (^) من أجزاءه الرئيسية.

مثال:

• جزء المفتاح من جهة المصدر = 0x159
• جزء المفتاح من جهة المشغِّل = 0x400
• المفتاح = 0x159 ^ 0x400 = 0x559

محاذاة القطع الرئيسية

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

• جزء المفتاح من جهة المصدر = 0xa7e297e7c8c8d0540000000000000000
• جزء المفتاح من جهة المشغِّل = 0x0000000000000000674fbe308a597271
• المفتاح = 0xa7e297e7c8c8d0540000000000000000 ^ 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 بت من الأصفار إلى المحاذاة مع الجزء الرئيسي من جانب العامل المشغِّل ويسهل تفسير XOR.
   • قطعة رئيسية من جهة المصدر
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • يُرجى العلم أنّ COUNT ترميز المحتوى نفسه مثل measurementGoalType=0 في طريقة ترميز البنية الأساسية. عنوان URL الخاص بـ COUNT أقل قليلًا وصريحًا.
3. في وقت الإحالة الناجحة، أنشئ سلسلة تتضمّن جميع السمات التي تريد تتبُّعها. وقيمهم. لإنشاء جزء مفتاح من جهة المشغّل، يجب تجزئة هذه السلسلة وإضافة بادئة بتنسيق 64 بت من الأصفار:
   • جزء رئيسي من جهة المشغِّل = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. يقوم المتصفح XOR باستخدام هذه الأجزاء الرئيسية لإنشاء مفتاح.
   • مفتاح تجميع 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"))
   • تمامًا مثل المتصفح، تتيح XOR هذه الأجزاء الرئيسية إنشاء المفتاح نفسه الذي أنشأه المتصفح سابقًا.
     • مفتاح تجميع 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، والذي قررت تعريفه باعتباره purchase value.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الاستراتيجية "أ" أبسط؛ تتبع جميع البيانات نفس الهيكل الرئيسي، والذي يعني أنه ليس لديك سوى هيكل رئيسي واحد يجب صيانته.

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

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

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

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

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

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

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

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

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

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

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

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

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

ضبط الأجزاء الرئيسية من جهة المصدر

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

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

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

مفتاح من جهة المصدر لمعرّف المفتاح...	سلسلة تحتوي على قيم السمات التي تريد ضبطها	تجزئة هذه السلسلة بقيمة سداسية عشرية، يتم اقتطاعها إلى أول 64 بت (64/4 = 16 حرفًا^1)	تجزئة سداسية عشرية مع إلحاق أصفار لتبسيط مشاركة XOR. وهذا هو الجزء الرئيسي من جهة المصدر.
key_purchaseCount	COUNT, CampaignID=12, GeoID=7	0x3cf867903fbb73ec	0x3cf867903fbb73ec0000000000000000
key_purchaseValue	VALUE, CampaignID=12, GeoID=7	0x245265f432f16e73	0x245265f432f16e73000000000000000

¹يمثل كل رقم سداسي عشري أربع وحدات بت (أرقام ثنائية).

لنقم الآن بتعيين الأجزاء الرئيسية:

// 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

عليك ضبط مفاتيح التشفير من جهة المشغِّل لإكمال عملية المفتاح

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

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

جزء من مفتاح التشغيل لمعرّف المفتاح...	سلسلة تحتوي على قيم السمات التي تريد ضبطها	تجزئة هذه السلسلة بقيمة سداسية عشرية، يتم اقتطاعها إلى أول 64 بت (64/4 = 16 حرفًا^1)	تجزئة سداسية عشرية مع إلحاق أصفار لتبسيط استخدام XOR وهذا هو الجزء الرئيسي من جهة المصدر.
key_purchaseCount	ProductCategory=25	0x1c7ce88c4904bbe2	0x0000000000000000f9e491fe37e55a0c
key_purchaseValue	(نفسه)	(نفسه)	(نفسه)

¹يمثل كل رقم سداسي عشري أربع وحدات بت (أرقام ثنائية).

لنقم الآن بتعيين الأجزاء الرئيسية:

// 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).

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

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

((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 = 1144

عمليًا، يمكنك إعدادها على النحو التالي، باستخدام العنوان المخصص 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 XOR 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 XOR 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:
  • إنشاء مفتاح من جهة المصدر، كما فعلت عند إعداده في المتصفّح.
  • أنشِئ جزء المفتاح من جهة المشغّل، كما فعلت عند ضبطه في المتصفّح.

المقياس الذي تريد طلبه^1	مفتاح من جهة المصدر	جزء رئيسي من جهة المشغِّل	مفتاح طلب خدمة التجميع^2
إجمالي عدد عمليات الشراء (COUNT)	0x3cf867903fbb73ec 0000000000000000	0x00000000000000 00f9e491fe37e55a0c	0x3cf867903fbb73 ecf9e491fe37e55a0c
إجمالي قيمة الشراء (VALUE)	0x245265f432f16e73 000000000000000	0x0000000000000000 f9e491fe37e55a0c	0x245265f432f16e73 f9e491fe37e55a0c

¹المقياس الذي تريد طلبه (للرقم التعريفي للحملة 12 × رقم تعريف الموقع الجغرافي 7 × فئة المنتج 25). ²المفتاح المطلوب استخدامه في خدمة التجميع = قطعة المفتاح من جهة المصدر XOR المفتاح من جهة المشغِّل.

• يمكنك طلب بيانات موجزة إلى خدمة التجميع لهذه المفاتيح.

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

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

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

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

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

تصغير القيم

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

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

• خلال الفترة الزمنية المشمولة بالتقارير، الحملة رقم 12 في أوروبا أدت إلى حوالي 156 عملية شراء (+ الضوضاء) لفئة المنتج رقم 25.
• خلال الفترة الزمنية المشمولة بالتقارير، الحملة رقم 12 في أوروبا أدت إلى 31,230 دولارًا أمريكيًا (أو ما يعادل هذا المبلغ بالعملة المحلية) لفئة المنتج رقم 25.