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

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

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

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

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

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

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

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

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

الأبعاد

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

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

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

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

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

السمات المطلوب تتبُّعها

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: في <a href="https://github.com/WICG/conversion-measurement-api/blob/main/AGGREGATE.md">الشرح</a>، يُطلق على زوج {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). الحزمة والقيمة كلاهما سلاسل بايت.

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

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

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

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

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

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

مثال:

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

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

استخدام مفاتيح تجميع البيانات

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

بنية المفتاح

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

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

الأنواع الرئيسية

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

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

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

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

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

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

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

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

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

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

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

ستخزّن 7 وحدات بت فقط 27 =128 خيارًا مختلفًا، وهو ما يقل عن العدد اللازم البالغ 200.

ستخزِّن 8 بتات 28 =256 خيارًا مختلفًا وهو أكبر من العدد اللازم، لذا يمكنك استخدام n=8 بت لترميز هذه السمة.

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

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

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

تعيين قطعتين رئيسيتين لمفتاح كامل

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

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

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

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

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

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

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

مثال:

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

محاذاة الأجزاء الرئيسية

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

• جزء المفتاح من جهة المصدر = 0xa7e297e7c8c8d0540000000000000000
• جزء المفتاح من جهة العامل المشغِّل = 0x0000000000000000674fbe308a597271
• المفتاح =
  • 0xa7e297e7c8c8d0540000000000000000 ^ 0x0000000000000000674fbe308a597271 =
  • 0xa7e297e7c8c8d054674fbe308a597271

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

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

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

ألقِ نظرة على الاستراتيجية (ب) للاطّلاع على مثال آخر.

ترميز الأبعاد إلى مفاتيح

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ترتيب الأبعاد داخل المفتاح متروك لك.

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

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

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

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

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

11001 0 011 1100

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

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

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

ويتم ذلك على النحو التالي:

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

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

• استخدِم دائمًا ترتيب السمات نفسه. ويضمن ذلك إعادة إنشاء علامات التجزئة بشكل موثوق. (لن ينشأ "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، والذي تقرّر تعريفه على أنّه قيمة شراء.

تظهر تقارير الملخص على النحو التالي:

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

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

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

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

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

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

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

الاستراتيجية "ب": شجرتان ضحلان (هيكلان رئيسيان بسيطان)

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

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

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

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

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

تظهر تقارير الملخص على النحو التالي:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

// 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)	تجزئة سداسية عشرية بأصفار ملحقة simplify عملية XOR-ing. هذا هو الجزء الرئيسي من جهة المصدر.
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).

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

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

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

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

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

في النهاية، ستتلقى تقرير ملخص قد يبدو كما يلي:

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

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

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

تصغير القيم

• يشير الرقم 2,558,500 إلى عدد عمليات الشراء لهذا المفتاح، وقد تمت زيادته بعامل القياس الذي سبق لك حسابه. كان عامل القياس لعدد عمليات الشراء 32768. اقسِم 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.

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