تلقّي إشعارات بمرات الظهور

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

ضبط نقطة نهاية إشعارات مرات الظهور

يجب إنشاء نقطة نهاية HTTP ومشاركة عنوان URL الخاص بها مع Google لتلقّي إشعارات مرات الظهور. يمكنك ضبط عنوان URL الذي يتم إرسال إشعارات مرات الظهور إليه باستخدام أحد الخيارات التالية:

  1. اضبط عنوان URL لنقطة نهاية إشعار مرّة الظهور لكل وسيلة شرح في ميزة "الاقتراح في الوقت الفعلي".
    • يمكنك ضبط عنوان URL المستخدَم لإشعارات مرّات الظهور بشكل ديناميكي لكل وسيلة شرح تتلقّاها من ميزة "التنظيم في الوقت الفعلي" من خلال ملء الحقل SegmentResponse.burl.
    • بالنسبة إلى وسيلة شرح معيّنة من "العرض في الوقت الفعلي"، يجب ضبط الحقل SegmentResponse.burl لتلقّي إشعار بمرّة ظهور خاصة بوسيلة الشرح هذه. إذا لم تتم تعبئة الحقل SegmentResponse.burl، لن يتم إرسال أي إشعار بشأن هذا الوسم حتى إذا تم ضبط الحقل SegmentResponse.burl في الوسوم السابقة.
  2. اضبط عنوان URL لنقطة نهاية إشعارات مرات الظهور على مستوى الحساب.
    • يمكنك ضبط عنوان URL لنقطة نهاية إشعارات مرات الظهور على مستوى الحساب من خلال التواصل مع مدير حسابك. هذه الطريقة مثالية إذا كان عنوان URL لنقطة النهاية يتغيّر بشكل غير متكرّر.
    • ستستخدِم جميع وسائط الشرح في "العرض في الوقت الفعلي" عنوان URL للإشعار الخاص بمرات الظهور على مستوى الحساب الذي تم ضبطه لحسابك، ما لم يتم تجاهل عنوان URL على مستوى الحساب من خلال ضبط الحقل SegmentResponse.burl لوسيط شرح فردي في "العرض في الوقت الفعلي".

تحليل إشعار مرات الظهور

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

فهم كيفية توسيع وحدات الماكرو

في حال ضبط عنوان URL لنقطة النهاية بحيث يحتوي على مَعلمة طلب بحث واحدة أو أكثر تم ضبطها على وحدة ماكرو، ستعمل إشعارات مرّات الظهور المُرسَلة إلى نقطة النهاية على توسيع وحدات الماكرو هذه، واستبدالها بالقيم المناسبة لها.

على سبيل المثال، يمكنك ضبط عنوان URL لنقطة نهاية إشعار مرات الظهور ليكون على النحو التالي:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

عند تلقّي إشعار مرّة ظهور، سيتم استبدال وحدات الماكرو، ما يؤدي إلى ظهور عنوان URL على النحو التالي:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

مزيد من المعلومات حول وحدات الماكرو المتوافقة

في ما يلي وحدات ماكرو يمكنك تضمينها في مَعلمات طلب البحث الخاصة بعنوان URL لنقطة نهاية إشعار مرّة الظهور. يتم استبدال وحدات الماكرو هذه بقيم ذات صلة بعرض السعر الفائز الذي ساهمت فيه شريحة واحدة أو أكثر من شرائح بياناتك.

وحدة الماكرو الوصف
${SR_ID} معرّف سلسلة فريد يعادل الحقل SegmentRequest.segment_request_id الخاص بالوسيلة الشارحة المقابلة في ميزة "الاقتراحات في الوقت الفعلي". يشير ذلك إلى طلب شريحة الجمهور الذي استجبت له باستخدام رقم تعريف واحد أو أكثر من أرقام تعريف شرائح الجمهور المستندة إلى البيانات التي ساهمت في عرض السعر الفائز.
${SEGMENT_IDS} قائمة بمعرّفات شرائح بيانات السلسلة التي ساهمت في عرض السعر الفائز. يتم فصل كل عنصر في القائمة باستخدام الرمز "|". على سبيل المثال، يمكن توسيع ذلك ليشمل قائمة بالقيم مثل: "segmentId1|segmentId2|segmentId3" يشير كل معرّف لجزء من البيانات يملأ القائمة إلى معرّف المورد الخاص بمورد curators.dataSegments المقابل في Marketplace API.
${AUCTION_PRICE} سلسلة تمثّل السعر الفائز في المزاد. السعر هو تكلفة مرّة ظهور واحدة (CPI) معبّرًا عنها بالمايكرو دولار أمريكي. على سبيل المثال، سيؤدي عرض سعر في "عروض الأسعار في الوقت الفعلي" بقيمة 5 دولار أمريكي لكل ألف ظهور إلى توسيع الماكرو ${AUCTION_PRICE} ليصبح 5000 جزء من مليون من دولار أمريكي للتكلفة لكل تثبيت في إشعار مرات الظهور في "التنسيق الانتقائي في الوقت الفعلي".
${DEAL_ID} معرّف الصفقة أو الحزمة التي فازت بالمزاد. هذه صفقة أو حزمة تستهدف معرّفًا واحدًا أو أكثر من معرّفات شرائح بياناتك، ويمكن تحديدها باستخدام الماكرو ${SEGMENT_IDS}.
${BUYER_SEAT_ID} معرّف حساب المشتري الذي فاز بمرّة الظهور، كما يحدّده مقدّم عرض السعر في عرض السعر الفائز. على سبيل المثال، يمكن أن تكون مقاعد المشترين وكالات أو معلنين.

الخطوات التالية