ماهية مفاتيح تجميع البيانات، وكيفية استخدامها في Attribution Reporting API وكيفية تحويل الأهداف إلى مفاتيح
بما أنك شركة تعمل في مجال تكنولوجيا الإعلان وتطلق حملات في مواقع جغرافية متعددة لفئات منتجات مختلفة، ننصحك بمساعدة المعلنين في الإجابة عن الأسئلة التالية:
- كم عدد عمليات الشراء لكل فئة منتج نتجت عن كل حملة من حملاتي في كل منطقة جغرافية؟
- ما مقدار الإيرادات التي حققتها كل حملة من حملاتي في كل منطقة جغرافية من كل فئة منتجات؟
على الرغم من أنّ العديد من شركات تكنولوجيا الإعلان تشجّع المعلِنين على ضبط مجموعة متنوعة من أنواع الإحالات الناجحة، فإنّ التركيز على الإحالات الناجحة الأكثر أهمية، مثل عمليات الشراء، هو طريقة جيدة لضمان الحصول على تفاصيل ودقة النتائج الموجزة لهذه الأحداث المهمة.
للقيام بذلك، ستحتاج إلى التفكير في الأسئلة التي تريد الإجابة عليها قبل جمع البيانات.
السمات والمفاتيح والقيم
للإجابة عن هذه الأسئلة، لنلقِ نظرة على السمات والمفاتيح والقيم.
الأبعاد
لفهم كيفية تحقيق حملاتك للأرباح، كما هو موضّح هنا، ستحتاج إلى تتبُّع السمات التالية:
- رقم تعريف الحملة الإعلانية: رقم تعريف الحملة المحددة.
- الرقم التعريفي للموقع الجغرافي: المنطقة الجغرافية التي تم عرض الإعلان فيها.
- فئة المنتج: نوع المنتج كما حدَّدته.
على الرغم من أنّ سمتَي "رقم تعريف الحملة" و"رقم تعريف الموقع الجغرافي" معروفتان عند عرض الإعلان (وقت عرض الإعلان)، ستُعرَف فئة المنتج من خلال حدث يؤدي إلى تشغيل الحدث، عندما يُكمل المستخدم إحالة ناجحة (وقت الإحالة الناجحة).
تظهر الأبعاد التي تريد تتبعها لهذا المثال في الصورة التالية:
![رقم تعريف الحملة، ورقم تعريف الموقع الجغرافي، وفئة المنتج.](https://developers.google.cn/static/privacy-sandbox/assets/images/campaign-id-geography-id-223ed5327b057.png?authuser=8&hl=ar)
ما هي مفاتيح التجميع (الحِزم)؟
يشير مصطلحا مفتاح التجميع والحزمة إلى الشيء نفسه. يُستخدَم مفتاح التجميع في واجهات برمجة التطبيقات الخاصة بالمتصفِّح المستخدَمة لإعداد التقارير. يتم استخدام المصطلح bucket في التقارير القابلة للتجميع والتقارير التلخيصية، وفي واجهات برمجة تطبيقات خدمة التجميع.
مفتاح التجميع (مفتاح اختصار) هو جزء من البيانات يمثل قيم الأبعاد التي يتم تتبعها. ويتم تجميع البيانات لاحقًا مع كل مفتاح تجميع.
على سبيل المثال، لنفترض أنّك تتتبّع سمات "فئة المنتج" و"رقم تعريف الموقع الجغرافي" و"رقم تعريف الحملة".
عندما يشاهد مستخدم مقيم في الموقع الجغرافي 7 إعلانًا للحملة رقم 12، ثم يُجري إحالة ناجحة لاحقًا عن طريق شراء منتج في فئة المنتج 25، يمكنك ضبط مفتاح تجميع يشبه المفتاح الوارد في الصورة التالية:
![مفتاح التجميع للإحالة الناجحة.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregation-key-a-conver-0cd37e4079fee.png?authuser=8&hl=ar)
وسترى لاحقًا أنّ مفتاح التجميع لا يشبه هذا الشكل من الناحية العملية، ولكن لنركّز في الوقت الحالي على المعلومات التي يحتوي عليها المفتاح.
ما هي القيم القابلة للتجميع؟
للإجابة عن أسئلتك بشأن السمات التي حدّدناها، عليك أن تعرف ما يلي:
- عدد عمليّات الشراء (عدد عمليّات الشراء) بعد تجميع البيانات وإتاحتها في تقرير ملخّص، سيكون إجمالي عدد عمليات الشراء (القيمة التلخيصية).
- الأرباح لكل عملية شراء (قيمة الشراء). بعد تجميع هذا التقرير وإتاحته في تقرير ملخّص، يمثّل هذا المبلغ إجمالي الأرباح (القيمة التلخيصية).
وتكون كلّ من هذه القيم، وهي عدد عمليات الشراء لإحالة ناجحة واحدة وقيمة الشراء لإحالة ناجحة واحدة، قيمة مجمّعة. يمكنك اعتبار القيم القابلة للتجميع بمثابة قيم لأهداف القياس.
السؤال | القيمة القابلة للتجميع = هدف القياس |
---|---|
كم عدد عمليات الشراء... | عدد عمليات الشراء |
ما مقدار الأرباح... | قيمة الشراء |
عندما يشاهد مستخدم مقيم في الموقع الجغرافي 7 إعلانًا للحملة 12، ثم يُجري إحالة ناجحة لاحقًا عن طريق شراء منتج من فئة المنتج 25 مقابل 120 دولارًا أمريكيًا (بافتراض أنّ عملتك هي الدولار الأمريكي)، يمكنك ضبط مفتاح تجميع وقيم قابلة للتجميع تشبه ما يلي:
![مفاتيح وقيم التجميع.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregation-keys-values-912b4f69661bd.png?authuser=8&hl=ar)
ويتم جمع القيم القابلة للتجميع لكل مفتاح على مستوى العديد من المستخدمين لإنشاء إحصاءات مجمّعة، على شكل قيم ملخّصة في التقارير التلخيصية.
![جارٍ إنشاء إحصاءات مجمّعة.](https://developers.google.cn/static/privacy-sandbox/assets/images/generating-aggregated-ins-e7ef89ea0a238.png?authuser=8&hl=ar)
يتم جمع القيم القابلة للتجميع لإنشاء إحصاءات مجمّعة لأهداف القياس.
لاحظ أن هذا المخطّط البياني يغفل فك التشفير ويمثّل مثالاً مبسّطًا بدون تطبيق تشويش. في القسم التالي، سنوضح هذا المثال مع تضمين التشويش.
من المفاتيح والقيم إلى التقارير
لنناقش الآن كيفية ارتباط المفاتيح والقيم القابلة للتجميع بالتقارير.
التقارير القابلة للتجميع
عندما ينقر أحد المستخدمين على إعلان أو يعرضه ثم يُجري إحالة ناجحة لاحقًا، يمكنك توجيه المتصفّح إلى تخزين زوج من {aggregation key, aggregatable value}.
في المثال الذي ذكرناه، عندما ينقر مستخدم على إعلان أو يشاهده ثم يُجري إحالة ناجحة لاحقًا، عليك توجيه المتصفّح لإنشاء مساهمتَين (واحدة لكل هدف قياس).
![جارٍ إنشاء مساهمتَين.](https://developers.google.cn/static/privacy-sandbox/assets/images/generating-contributions-fa8bc97295bc7.png?authuser=8&hl=ar)
ستلاحظ لاحقًا أنّ التقرير القابل للتجميع {aggregation key, aggregatable value} لا يشبه تمامًا هذا التقرير، ولكن لنركّز في الوقت الحالي على المعلومات الواردة في التقرير.
عندما تطلب من المتصفّح إنشاء مساهمتَين، ينشئ المتصفّح تقريرًا قابلاً للتجميع (إذا كان بإمكانه مطابقة الإحالة الناجحة مع عرض أو نقرة سابقة).
يحتوي التقرير القابل للتجميع على:
- المساهمات التي أعددتها
- البيانات الوصفية عن حدث النقرة أو المشاهدة وحدث الإحالة الناجحة: الموقع الإلكتروني الذي حدثت فيه الإحالة الناجحة، وغير ذلك. اطّلع على جميع الحقول في تقرير قابل للتجميع.
![التقرير القابل للتجميع.](https://developers.google.cn/static/privacy-sandbox/assets/images/the-resulting-aggregatabl-3df86364f7725.png?authuser=8&hl=ar)
تكون التقارير القابلة للتجميع بتنسيق JSON، وتشمل، إلى جانب أشياء أخرى، حقل حمولة سيتم استخدامه كإدخال بيانات لتقرير الملخص النهائي.
تحتوي الحمولة على قائمة بالمساهمات، كل منها عبارة عن زوج {aggregation key, aggregatable value} :
bucket
: مفتاح التجميع، الذي تم ترميزه كسلسلة بايت.value
: القيمة القابلة للتجميع لهدف القياس هذا، والمشفرة كسلسلة بايت.
وفي ما يلي مثال لذلك:
{
"data": [
{
"bucket": "111001001",
"value": "11111010000",
}
],
"operation": "histogram"
}
من الناحية العملية، يتم ترميز التقارير القابلة للتجميع بطريقة تجعل المجموعات والقيم تبدو مختلفة عن تلك التي كانت في المثال السابق (أي أنّ الحزمة قد تبدو على النحو \u0000\u0000\x80\u0000
). وتكون الحزمة والقيمة سلسلتَي بايت.
التقارير الموجزة
يتم تجميع التقارير القابلة للتجميع على مستوى العديد من المتصفّحات والأجهزة (المستخدِمون) على النحو التالي:
- تطلب تقنية الإعلان تقارير موجزة لمجموعة معيّنة من المفاتيح، ومجموعة معيّنة من التقارير القابلة للتجميع الواردة من العديد من المتصفّحات (المستخدمين).
- يتم فك تشفير التقارير القابلة للتجميع عن طريق خدمة التجميع.
- لكل مفتاح، يتم جمع القيم القابلة للتجميع من التقارير القابلة للتجميع.
- تتم إضافة التشويش إلى قيمة الملخّص.
![التقارير القابلة للتجميع بالإضافة إلى التجميع وفك التشفير والتشويش في التقرير الموجز](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregatable-reports-plus-9bd26966f76f7.png?authuser=8&hl=ar)
النتيجة هي تقرير ملخص يحتوي على مجموعة من أزواج {aggregation key, summary value}.
يحتوي تقرير الملخص على مجموعة من أزواج المفتاح/القيمة بنمط قاموس JSON. يحتوي كل زوج على:
bucket
: مفتاح التجميع، الذي تم ترميزه كسلسلة بايت.value
: القيمة التلخيصية بالنظام العشري لهدف قياس معيّن، مجمّعة من جميع التقارير القابلة للتجميع المتاحة، مع مستوى إضافي من التشويش.
مثال:
[
{"bucket": "111001001", "value": "2558500"},
{"bucket": "111101001", "value": "3256211"},
{...}
]
من الناحية العملية، يتم ترميز التقارير التلخيصية بطريقة تجعل الحِزم والقيم تبدو مختلفة عمّا هو مذكور في المثال (أي أنّ الحزمة قد تبدو على النحو \u0000\u0000\x80\u0000
). وتكون الحزمة والقيمة سلسلتَي بايت.
تطبيق مفاتيح التجميع
يتم تحديد مفاتيح تجميع البيانات (مجموعات البيانات) من قِبل شركة تكنولوجيا الإعلان، ويتم ذلك عادةً في خطوتَين: عندما يتم النقر على إعلان أو عرضه، وعندما يُجري المستخدم إحالة ناجحة.
البنية الأساسية
سنستخدم مصطلح بنية المفتاح لتحديد مجموعة السمات المشفرة في مفتاح.
على سبيل المثال، رقم تعريف الحملة × رقم تعريف الموقع الجغرافي × فئة المنتج هو بنية أساسية.
![البنية الأساسية.](https://developers.google.cn/static/privacy-sandbox/assets/images/key-structure-17b99e9ad0974.png?authuser=8&hl=ar)
أنواع المفاتيح
يتم جمع القيم القابلة للتجميع لمفتاح معين عبر عدة مستخدمين/متصفحات. وقد لاحظنا أنّ القيم المجمّعة يمكن أن تتتبّع أهداف القياس المختلفة، مثل قيمة الشراء أو عدد عمليات الشراء. وتريد التأكد من أنّ خدمة التجميع ستجمع القيم القابلة للتجميع من النوع نفسه.
للقيام بذلك، داخل كل مفتاح، قم بترميز جزء من البيانات الذي يخبرك بما تمثله قيمة الملخص - هدف القياس الذي يشير إليه هذا المفتاح. ويمكنك إجراء ذلك من خلال إنشاء سمة إضافية لمفتاحك تمثّل نوع هدف القياس.
باستخدام المثال السابق، سيكون لنوع هدف القياس هذا قيمتان محتملتان مختلفتان:
- عدد عمليات الشراء هو النوع الأول من أهداف القياس.
- قيمة الشراء هي النوع الثاني من أهداف القياس.
![أهداف القياس وأنواع أهداف القياس](https://developers.google.cn/static/privacy-sandbox/assets/images/measurement-goals-measur-6f6f8b6468ec3.png?authuser=8&hl=ar)
إذا كانت لديك n من أهداف القياس، سيكون لنوع هدف القياس n أنواع مختلفة من القيم.
يمكنك اعتبار أبعاد المفتاح بمثابة مقياس. على سبيل المثال، "عدد عمليات الشراء لمنتج معيّن لكل حملة حسب الموقع الجغرافي".
حجم المفتاح وحجم البُعد
يتم تحديد الحد الأقصى لحجم المفتاح بوحدات البت، أي عدد الأصفار والآحاد في النظام الثنائي لإنشاء المفتاح الكامل. تسمح واجهة برمجة التطبيقات بطول مفتاح يبلغ 128 بت.
يسمح هذا الحجم بالمفاتيح الدقيقة للغاية، ولكن من المرجح أن تؤدي المفاتيح الأكثر دقة إلى قيم أكثر تشويشًا. يمكنك الاطّلاع على مزيد من المعلومات عن الضوضاء في قسم فهم الضوضاء.
كما أشرنا سابقًا، يتم ترميز السمات في مفتاح التجميع. لكل سمة عدد عناصر في الحقل معيّن، أي عدد القيم المختلفة التي يمكن أن تتخذها السمة. اعتمادًا على عدد القيم الفريدة للسمة، يجب تمثيل كل سمة بعدد معيّن من وحدات البت. باستخدام n بت، يمكن التعبير عن خيارين مختلفَين n.
على سبيل المثال، قد يكون عدد القيم الفريدة لسمة البلد 200، لأنّ هناك حوالي 200 بلد في العالم. كم عدد وحدات البت اللازمة لترميز هذا البُعد؟
يمكن أن تخزن 7 بت فقط 27 = 128 خيارًا مختلفًا، أي أقل من العدد الضروري البالغ 200.
تؤدي 8 بت إلى تخزين 28 = 256 خيارًا مختلفًا، ما يزيد عن الـ 200 الضرورية اللازمة، لذا يمكنك استخدام n=8 بت لترميز هذا البُعد.
ترميز المفتاح
عند تعيين المفاتيح في المتصفح، يجب أن تكون بترميز سداسي عشري. في التقارير الموجزة، ستظهر المفاتيح بشكل ثنائي (ويُطلق عليها اسم مجموعات بيانات).
ضبط قطعتين رئيسيتين للحصول على مفتاح كامل
لنفترض أنّك تستخدِم مفتاحًا لتتبّع السمات التالية:
- معرّف الحملة
- الرقم التعريفي للموقع الجغرافي
- فئة المنتج
على الرغم من أنّ سمتَي "رقم تعريف الحملة" و"رقم تعريف الموقع الجغرافي" معروفتان عند عرض الإعلان (وقت عرض الإعلان)، ستُعرَف فئة المنتج من خلال حدث يؤدي إلى عرض النتيجة، عندما يُكمل المستخدم إحالة ناجحة (وقت الإحالة الناجحة).
عمليًا، هذا يعني أنك ستقوم بتعيين مفتاح في خطوتين:
- وعليك ضبط جزء واحد من المفتاح - رقم تعريف الحملة × رقم تعريف الموقع الجغرافي - عند النقر أو وقت المشاهدة.
- وستضبط الجزء الثاني من المفتاح - فئة المنتج - في وقت الإحالة الناجحة.
تسمى هذه الأجزاء المختلفة من المفاتيح أجزاء المفاتيح.
يتم حساب المفتاح من خلال أخذ XOR (^
) من أجزاءه الرئيسية.
![استخدام عناصر XOR-ing](https://developers.google.cn/static/privacy-sandbox/assets/images/xoring-key-pieces-6c7b39f58a41f.png?authuser=8&hl=ar)
مثال:
- جزء المفتاح من جهة المصدر =
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 بت (25 = 32 > 29).
- نوع هدف القياس: بت واحد. هدف القياس هو إما عدد عمليات الشراء أو قيمة الشراء، وهذا يعني احتمالين مختلفين، وبالتالي، تكفي وحدة بت واحدة لتخزين هذا.
رقم تعريف الموقع الجغرافي: 3 بت (23 = 8). يمكنك أيضًا تعريف خريطة أبعاد للرقم التعريفي للموقع الجغرافي من أجل معرفة المنطقة الجغرافية التي تمثلها كل قيمة ثنائية. قد تبدو خريطة الأبعاد لسمة رقم تعريف الموقع الجغرافي كما يلي:
القيمة الثنائية في المفتاح الموقع الجغرافي 000 أمريكا الشمالية 001 وسط أمريكا 010 جنوب أمريكا 011 أوروبا 100 أفريقيا 101 آسيا 110 جزر الكاريبي 111 أوقيانوسيا رقم تعريف الحملة: 4 بت (24 = 16)
قد يكون طول المفاتيح التي تتبع هذه البنية 13 بت (5 + 1 + 3 + 4).
في هذا المثال، ستبدو خريطة بنية المفاتيح لهذه المفاتيح على النحو التالي:
![خريطة البنية الرئيسية.](https://developers.google.cn/static/privacy-sandbox/assets/images/key-structure-map-4664a0905c7de.png?authuser=8&hl=ar)
لك مطلق الحرية في ترتيب أبعاد المفتاح.
لتوضيح كيفية تكوين الأبعاد لبنية مفتاح، سنستخدم تمثيلاً ثنائيًا، لذلك يكون رقم تعريف الحملة (وحدات البت الأولى) هو في أقصى اليمين، وفئة المنتج (البتات الأخيرة) هو أقصى اليسار.
في كل بُعد، الجزء الأكثر أهمية، وهو البت الذي يحمل أكبر قيمة عددية، هو البت الموجود في أقصى اليسار. البت الأقل أهمية - وهو البت الذي يحمل أصغر قيمة عددية - هو البت الموجود في أقصى اليمين.
لنرَ كيف ستستخدم خريطة بنية المفاتيح لفك ترميز مفتاح.
لنأخذ 0b1100100111100 كمثال عشوائي، ونفترض أن لديك طريقة لمعرفة أن هذا المفتاح يتبع خريطة البنية الرئيسية في الرسم التوضيحي السابق.
وفقًا لخريطة البنية الرئيسية، سيتم فك ترميز هذا المفتاح ليصبح 11001 0 011 1100
.
وبالتالي فإن المفتاح 0b1100100111100 يمثل عدد عمليات الشراء لفئة المنتج 25، لرقم تعريف الحملة 12 الذي تم إطلاقه في أوروبا.
ترميز السمات باستخدام دالة تجزئة
بدلاً من استخدام خريطة بنية المفاتيح، يمكنك استخدام وظيفة تجزئة لإنشاء المفاتيح ديناميكيًا بطريقة متسقة وموثوقة.
يتم ذلك على النحو التالي:
- اختَر خوارزمية التجزئة.
- وفي وقت عرض الإعلان، أنشئ سلسلة تتضمّن جميع السمات التي تريد تتبُّعها وقيمها. لإنشاء الجزء الرئيسي من جهة المصدر، عليك تجزئة هذه السلسلة والتفكير في إضافة لاحقة بحجم 64 بت من الأصفار لمحاذاة الجزء الرئيسي من جهة المشغِّل لتسهيل فهم دالة XOR.
- قطعة المفتاح من جهة المصدر
=<64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
- يُرجى العلم أنّ
COUNT
ترميز المحتوى نفسه مثلmeasurementGoalType=0
في طريقة ترميز البنية الأساسية. عنوان URL الخاص بـCOUNT
أقل قليلًا وصريحًا.
- قطعة المفتاح من جهة المصدر
- في وقت الإحالة الناجحة، أنشئ سلسلة تتضمّن جميع السمات التي تريد تتبُّعها وقيمها. لإنشاء جزء مفتاح من جهة المشغِّل، يجب تجزئة هذه السلسلة وإضافة بادئة بتنسيق 64 بت من الأصفار:
- جزء المفتاح من جهة المشغِّل
=
<64-bit 00000000…><64-bit hex hash("productCategory=25")>
- جزء المفتاح من جهة المشغِّل
=
- يقوم المتصفح XOR باستخدام هذه الأجزاء الرئيسية لإنشاء مفتاح.
- مفتاح تجميع 128 بت
=<64-bit hex source-side key piece hash><64-bit hex source-side key piece hash>
- مفتاح تجميع 128 بت
- في وقت لاحق، عندما تكون مستعدًا لطلب تقرير ملخّص لهذا المفتاح، يمكنك إنشاؤه بسرعة:
- استنادًا إلى السمات التي تهتم بها، أنشئ جزءًا رئيسيًا من جهة المصدر ومن جهة المشغّل كما فعلت سابقًا.
- قطعة المفتاح من جهة المصدر
=<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>
- مفتاح تجميع 128 بت
- استنادًا إلى السمات التي تهتم بها، أنشئ جزءًا رئيسيًا من جهة المصدر ومن جهة المشغّل كما فعلت سابقًا.
إليك بعض النصائح العملية إذا كنت تستخدم هذا الأسلوب المستند إلى التجزئة:
- واستخدِم دائمًا نفس ترتيب السمات. وهذا يضمن إمكانية إعادة إنشاء علامات التجزئة بشكل موثوق. (لن تنشئ
"COUNT, CampaignID=12, GeoID=7"
نفس قيمة التجزئة كـ"COUNT, GeoID=7, CampaignID=12"
). ويمكن إجراء ذلك بطريقة مباشرة وهي ترتيب السمات أبجديًا. هذا ما سنفعله في المثال، باستثناء حقيقة أننا سنجعلCOUNT
أوVALUE
العنصر الأول دائمًا في البُعد، وهو اختيار لسهولة القراءة، حيث تعملCOUNT
أوVALUE
على ترميز معلومات تختلف من الناحية النظرية عن جميع السمات الأخرى. - تتبّع مجموعة الأبعاد التي تستخدمها في المفاتيح. تريد تجنُّب إنشاء مفاتيح استنادًا إلى مجموعة من السمات التي لم يسبق لك استخدامها.
- نادرًا ما يحدث تضارب مع التجزئة في حال استخدام وظيفة تجزئة مناسبة، ولكن التحقّق من التجزئات التي سبق استخدامها (التي من المفترض تخزينها لتفسير نتائج خدمة التجميع) يمكن أن يتجنّب تقديم مفاتيح جديدة تتعارض مع مفاتيح قديمة.
اطّلِع عمليًا على كيفية استخدام المفاتيح المستندة إلى التجزئة في مثال على إحالة ناجحة واحدة لكل نقرة أو عرض.
القيم القابلة للتجميع عمليًا
تحدّد شركة تقنية الإعلان قيمًا قابلة للتجميع عندما يُجري المستخدم إحالة ناجحة.
لحماية خصوصية المستخدم، يتم وضع حدّ أقصى للمساهمات التي يقدّمها كلّ مستخدم. في جميع القيم القابلة للتجميع المرتبطة بمصدر واحد (النقرة على الإعلان أو مشاهدة الإعلان)، لا يمكن أن تكون أي قيمة أعلى من حد معيّن للمساهمة.
وسنشير إلى هذا الحد باسم CONTRIBUTION_BUDGET
. في الشرح، يُطلق على هذا الحدّ اسم ميزانية المستوى 1، لكنّه مثل CONTRIBUTION_BUDGET
.
لإجراء مناقشة معمّقة حول ميزانية المساهمة، يُرجى الرجوع إلى ميزانية المساهمة للتقارير التلخيصية.
مثال: إحالة ناجحة واحدة لكل نقرة أو مشاهدة
في هذا المثال، لنفترض أنّك تريد الإجابة عن الأسئلة التالية:
- ما هي فئات المنتجات الأكثر قيمة في كل منطقة؟
- ما هي استراتيجيات الحملات الأكثر فعالية في كل منطقة؟
ولنفترض أيضًا أنه بالنسبة لحالة استخدامك، فأنت بحاجة إلى رؤى أسبوعية.
تحتاج أيضًا إلى تتبع ما يلي:
- 16 حملة مختلفة.
- 8 مناطق جغرافية مختلفة: أمريكا الشمالية وأمريكا الوسطى وأمريكا الجنوبية وأوروبا وأفريقيا وآسيا ومنطقة البحر الكاريبي وأوقيانوسيا
- 29 فئة منتجات مختلفة.
ما المقاييس المستخدمة
على الرغم من أنّ العديد من شركات تكنولوجيا الإعلان تشجّع المعلِنين على ضبط مجموعة متنوعة من أنواع الإحالات الناجحة، فإنّ التركيز على الإحالات الناجحة الأكثر أهمية، مثل عمليات الشراء هو طريقة جيدة لضمان أن تكون النتائج المجمَّعة تفصيلية ودقيقة لأحداث الإحالات الناجحة المهمة هذه. وفي الواقع، كلما زاد عدد المقاييس التي تقيسها، كانت ميزانية المساهمة لكل مقياس أصغر، وبالتالي من المرجّح أن تكون كل قيمة أكثر تشويشًا. لذلك، عليك تحديد ما تريد قياسه بعناية.
في هذا المثال، سنركّز على إعدادات الحملات التي تقيس إحالة ناجحة واحدة فقط لكل نقرة أو مشاهدة: عملية شراء.
وسيظلّ بإمكانك قياس كلّ من عدد عمليات الشراء وقيمة الشراء، والوصول إلى مجموعة متنوعة من الإحصاءات المجمَّعة المهمة، مثل إجمالي قيمة الشراء والتفاصيل الجغرافية. يساعد ذلك في الحفاظ على البيئة المعقولة، ويضمن اتّباع نهج بسيط للتوسّع في ميزانية المساهمة.
ماذا عن العملات؟
إذا كنت تدير حملات في مناطق مختلفة، يجب أخذ العملات في الاعتبار. وفي هذا الإطار، يمكنك تنفيذ الإجراءات التالية:
- اجعل العملة بعدًا مخصصًا في مفاتيح التجميع.
- أو يمكنك استنتاج العملة من معرّف الحملة، وتحويل جميع العملات إلى عملات مرجعية.
في هذا المثال، سنفترض أنّه يمكنك استنتاج العملة من رقم تعريف الحملة. ويتيح لك ذلك تحويل أي قيمة شراء محدّدة من عملة المستخدم المحلية إلى عملة مرجعية من اختيارك. ويمكنك أيضًا إجراء هذا التحويل بسرعة، عندما يشتري المستخدم سلعة.
باستخدام هذه الطريقة، تكون جميع القيم المجمّعة بالعملة المرجعية نفسها، وبالتالي يمكن جمعها لإنشاء إجمالي قيمة شراء مجمّعة، وهو قيمة شراء ملخّص.
ترجمة الأهداف إلى مفاتيح
بفضل أهداف ومقاييس القياس، يتوفّر لك عدد من الخيارات لاستراتيجيتك الرئيسية. لنلقِ نظرة على اثنتين من الإستراتيجيات التالية:
- الاستراتيجية أ: هيكل رئيسي واحد دقيق.
- الاستراتيجية ب: هيكلان رئيسيان عامان.
الاستراتيجية أ: شجرة واحدة عميقة (بنية رئيسية واحدة دقيقة)
في الاستراتيجية "أ"، يمكنك استخدام بنية أساسية واحدة دقيقة تتضمّن جميع الأبعاد التي تحتاجها:
![بنية أساسية دقيقة واحدة](https://developers.google.cn/static/privacy-sandbox/assets/images/one-granular-key-structur-85e0f0ef579b3.png?authuser=8&hl=ar)
تستخدم جميع مفاتيحك هذه البنية.
يمكنك تقسيم هذا الهيكل الرئيسي إلى نوعين رئيسيين لدعم هدفين للقياس.
- نوع المفتاح 0: نوع هدف القياس = 0، والذي قرّرت تحديده على أنّه عدد عمليات الشراء.
- نوع المفتاح 1: نوع هدف القياس = 1، والذي قرّرت تحديده على أنّه قيمة شراء.
تظهر التقارير الموجزة على النحو التالي:
![تقرير ملخص "الإستراتيجية".](https://developers.google.cn/static/privacy-sandbox/assets/images/strategy-summary-report-c13d51d0ef5b.png?authuser=8&hl=ar)
يمكنك التفكير في الاستراتيجية A على أنها استراتيجية "شجرة واحدة عميقة":
- ترتبط كل قيمة ملخّصة في التقارير الموجزة بجميع السمات التي يتتبّعها.
- يمكنك تجميع قيم الملخّص هذه مع كلّ من هذه السمات، حتى يمكن أن تصل هذه القيم المجمَّعة إلى عمق عدد السمات التي تستخدمها.
باستخدام الإستراتيجية أ، ستجيب عن أسئلتك على النحو التالي:
السؤال | الإجابة |
---|---|
ما هي فئات المنتجات الأكثر قيمة في كل منطقة؟ | اجمع أعداد عمليات الشراء الموجزة والقيم الواردة في التقارير
الموجزة على مستوى جميع الحملات. يوضح ذلك عدد عمليات الشراء وقيمتها لكل رقم تعريف الموقع الجغرافي × فئة المنتج. لكل منطقة، قارِن قيمة الشراء وعدد فئات المنتجات المختلفة. |
ما هي استراتيجيات الحملات الأكثر فعالية في كل منطقة؟ | اجمع أعداد عمليات الشراء الموجزة والقيم الواردة في التقارير
الموجزة على مستوى جميع فئات المنتجات. يوضح لك ذلك عدد عمليات الشراء وقيمتها لكل رقم تعريف الحملة × رقم تعريف الموقع الجغرافي. يمكنك مقارنة قيمة الشراء واحتساب قيمة الشراء لكل منطقة في الحملات المختلفة. |
باستخدام الإستراتيجية أ، يمكنك أيضًا الإجابة مباشرة عن هذا السؤال الثالث:
"ما مقدار الأرباح التي حققتها كل حملة من حملاتي في كل منطقة جغرافية؟"
على الرغم من أنّ قيم الملخّص ستكون مزعجة، يمكنك تحديد الحالات التي لا تكون فيها الاختلافات في القيمة المقاسة بين كل حملة ناتجة عن التشويش فقط. تعرَّف على كيفية تحقيق ذلك في مقالة فهم الضجيج.
الاستراتيجية ب: شجرتان ضحلتان (بنيتان رئيسيتان تقريبيتان)
في الاستراتيجية "ب"، يمكنك استخدام بنيتين رئيسيتين تقريبيتين، تتضمن كل منهما مجموعة فرعية من الأبعاد التي تحتاجها:
![الهيكل الأساسي 1 والبنية الرئيسية 2.](https://developers.google.cn/static/privacy-sandbox/assets/images/key-structure-1-key-stru-f5313e8766cd6.png?authuser=8&hl=ar)
لقد قمت بتقسيم كل من هذه الهياكل الرئيسية إلى نوعين رئيسيين لدعم هدفي القياس.
- نوع هدف القياس = 0، والذي اخترت تعريفه على أنّه عدد عمليات الشراء.
- نوع هدف القياس = 1، والذي اخترت تعريفه على أنّه قيمة شراء.
ينتهي بك الأمر بأربعة أنواع رئيسية:
- نوع المفتاح I-0: البنية الأساسية I، عدد عمليات الشراء.
- نوع المفتاح I-1: البنية الأساسية I، قيمة الشراء.
- نوع المفتاح II-0: البنية الأساسية 2، عدد عمليات الشراء.
- نوع المفتاح II-1: البنية الأساسية 2، قيمة الشراء.
تظهر التقارير الموجزة على النحو التالي:
![استراتيجية تقرير الملخص ب.](https://developers.google.cn/static/privacy-sandbox/assets/images/summary-report-strategy-b-a402cebbf58ca.png?authuser=8&hl=ar)
يمكنك التفكير في الإستراتيجية "ب" على أنها استراتيجية "شجرتان سطحيتان":
- يتم ربط قيم الملخّص في التقارير التلخيصية بإحدى المجموعتَين الصغيرتَين من السمات.
- يمكنك دمج قيم الملخّص هذه مع كلّ سمة من السمات في هذه المجموعات، ما يعني أنّ هذه البيانات المجمّعة ليست عميقة كما هو الحال في الخيار (أ)، بسبب قلة السمات التي يمكن تجميعها.
باستخدام الإستراتيجية ب، ستجيب عن أسئلتك على النحو التالي:
السؤال | الإجابة |
---|---|
ما هي فئات المنتجات الأكثر قيمة في كل منطقة؟ | يمكنك الوصول مباشرةً إلى ملخّص أعداد الشراء وقيمه الواردة في التقارير الموجزة. |
ما هي استراتيجيات الحملات الأكثر فعالية في كل منطقة؟ | يمكنك الوصول مباشرةً إلى ملخّص أعداد الشراء وقيمه الواردة في التقارير الموجزة. |
القرار: الاستراتيجية أ
الإستراتيجية أ أبسط؛ جميع البيانات تتبع نفس الهيكل الأساسي، مما يعني أيضًا أن لديك هيكلاً رئيسيًا واحدًا فقط ينبغي الحفاظ عليه.
ومع ذلك، باستخدام الإستراتيجية "أ"، تحتاج إلى جمع قيم الملخص التي تتلقاها في تقارير الملخص للإجابة على بعض أسئلتك. كل قيمة من قيم الملخص هذه مزعجة. من خلال تلخيص هذه البيانات، فإنك أيضًا تلخص التشويش.
هذا ليس هو الحال مع الإستراتيجية ب، حيث تمنحك قيم الملخص المعروضة في تقارير الملخص المعلومات التي تحتاجها بالفعل. هذا يعني أن الإستراتيجية "ب" من المحتمل أن تؤدي إلى تأثير أقل بسبب التشويش مقارنة بالإستراتيجية "أ".
كيف يجب أن تحدد الإستراتيجية التي يجب استخدامها؟ بالنسبة إلى المعلنين أو الحملات الحالية، يمكنك الاعتماد على البيانات السابقة لتحديد ما إذا كان عدد الإحالات الناجحة أكثر ملاءمةً للاستراتيجية (أ) أو الاستراتيجية (ب). وبالنسبة إلى المعلنين الجدد أو الحملات الجديدة، يمكنك اتّخاذ قرار بشأن:
- اجمع بيانات شهر واحد باستخدام المفاتيح الدقيقة (الاستراتيجية أ). نظرًا لأنك تقوم بتمديد مدة جمع البيانات، ستكون قيم الملخص أعلى وستكون التشويش أقل نسبيًا.
- قيِّم عدد الإحالات الناجحة وقيمة الشراء أسبوعيًا بدقة معقولة.
في هذا المثال، لنفترض أن عدد عمليات الشراء الأسبوعية وقيمة الشراء مرتفعة بدرجة كافية بحيث تؤدي الاستراتيجية "أ" إلى نسبة تشويش تعتبرها مقبولة لحالة الاستخدام الخاصة بك.
نظرًا لأن الإستراتيجية "أ" أبسط وتؤدي إلى تأثير تشويش لا يؤثر على قدرتك على اتخاذ القرارات، فإنك تقرر استخدام الإستراتيجية "أ".
اختيار خوارزمية تجزئة
وقررت اعتماد نهج قائم على التجزئة لإنشاء المفاتيح. للقيام بذلك، تحتاج إلى تحديد خوارزمية التجزئة لدعم هذا النهج.
لنفترض أنك اخترت خوارزمية SHA-256. يمكنك أيضًا استخدام خوارزمية أبسط وأقل أمانًا، مثل MD5.
في المتصفّح: ضبط المفاتيح والقيم
الآن بعد أن قرّرت إنشاء بنية أساسية وخوارزمية تجزئة، أصبحت جاهزًا لتسجيل المفاتيح والقيم عندما ينقر المستخدمون على الإعلانات أو يشاهدونها وي إتمامون إحالة ناجحة.
فيما يلي نظرة عامة على العناوين التي ستضبطها لتسجيل المفاتيح والقيم في المتصفح:
![تسجيل المفاتيح والقيم للعرض أو النقر.](https://developers.google.cn/static/privacy-sandbox/assets/images/register-keys-values-a-59763f86a1f19.png?authuser=8&hl=ar)
![سجِّل المفاتيح والقيم لإحالة ناجحة.](https://developers.google.cn/static/privacy-sandbox/assets/images/register-keys-values-a-155f081dc7bca.png?authuser=8&hl=ar)
ضبط الأجزاء الرئيسية من جهة المصدر
عندما ينقر مستخدم على إعلان أو يعرضه، اضبط مفاتيح التجميع في العنوان 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) | يجب استخدام تجزئة سداسية عشرية مع أصفار ملحقة 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 × 32768 = 32768key_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 |
- يمكنك طلب بيانات موجزة إلى خدمة التجميع لهذه المفاتيح.
التعامل مع تقرير الملخص
في النهاية، تتلقى تقريرًا موجزًا قد يبدو على النحو التالي:
[
{"bucket": "00111100111110000110011110010000001111111011101101110011111011001111100111100100100100011111111000110111111001010101101000001100",
"value": "2558500"},
{"bucket": "00100100010100100110010111110100001100101111000101101110011100111111100111100100100100011111111000110111111001010101101000001100",
"value": "687060"},
…
]
المجموعة الأولى هي المفتاح COUNT
في النظام الثنائي. المجموعة الثانية هي مفتاح VALUE
في النظام الثنائي.
ويُرجى العِلم بأنّه على الرغم من أنّ المفاتيح غير متجانسة (COUNT
في مقابل VALUE
)، فإنّها مضمّنة في التقرير نفسه.
تصغير القيم
- يشير 2,558,500 إلى عدد عمليات الشراء لهذا المفتاح، مع زيادة من خلال عامل القياس الذي تم حسابه سابقًا. كان عامل القياس لعدد عمليات الشراء 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.