شفافية عرض الأسعار مع عنصر SupplyChain

يتيح عنصر SupplyChain للمشترين والوسطاء معرفة جميع الأطراف التي تبيع المساحات الإعلانية المتاحة أو إعادة بيعها. يعمل العنصر مع ads.txt / app-ads.txt وsellers.json لتوفير الشفافية في المنظومة المتكاملة للإعلانات.

1. يرسِل الناشر طلب عرض سعر.
2. يتلقّى المشتري طلب عرض السعر والبيانات من عنصر SupplyChain.
3. يبحث المشتري عن هويات جميع الوسطاء الذين يعيدون بيع المستودع.
4. يجري المشتري عملية الزحف ويتحقّق من المورّدين المصرح لهم ببيع المستودع.

ستنشئ Google تلقائيًا العناصر ضمن طلب OpenRTB أو بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google، إن وُجد.

آلية عمل عنصر SupplyChain

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

ملاحظة: لكي تتمكّن Google من إنشاء عنصر SupplyChain كامل، على الحسابات الرئيسية التي تُدير المساحات الإعلانية المتاحة في أداة "إدارة العملاء المتعدّدين" (MCM) مشاركة رقم تعريف البائع (sid) للناشرين الصغيري الحجم من خلال "إدارة إعلانات Google" أو باستخدام واجهة برمجة التطبيقات.

 

// Example object
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // Same seller_id for the publisher in sellers.json
         "hp":1
    }],
    "ver":"1.0"
}

اطّلع على مستندات المطوّرين في OpenRTB ومستندات مكتب IAB لمزيد من التفاصيل.

يبدو عنصر SupplyChain مختلفًا بناءً على طريقة عملك مع المشترين.

الناشرون الذين يبيعون بشكلٍ مباشر مع Google

بالنسبة إلى الناشرين الذين يبيعون مستودعًا مباشرةً من خلال "إدارة إعلانات Google" أو AdMob أو AdSense، يحتوي عنصر schain على عُقدة واحدة فقط للنطاق "google.com" مع seller_id في sellers.json.

الناشرون الذين يستخدمون "عرض الأسعار المفتوح"

يمكن للناشرين الذين يستخدمون "عرض الأسعار المفتوح" للعمل مع خدمات التبادل من الجهة الخارجية أن تكون لهم عقدتان في العنصر schain: عقدة واحدة تخصّ google.com مع seller_id في seller.json وعقدة لشريك أرباح التبادل.

مثلما تنشئ Google العُقدة التي تخصّ google.com قبل إرسال طلب عرض السعر، تكون خدمة التبادل من الجهة الخارجية مسؤولة عن إضافة العقدة قبل تمرير الطلب.

جميع وسطاء عدم الدفع

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

الناشرون الذين يستخدِمون وسطاء دفع قبل إرسال الطلب ^{(تجريبي)} 

This feature is in Beta
Features in Beta phase might not be available in your network. Watch the release notes for when this feature becomes generally available.

على الناشرين الذين يستعينون بخدمات وسطاء دفع قبل إرسال الطلب إلى "إدارة إعلانات Google" إرسال عنصر SupplyChain وفقًا لإرشادات مكتب IAB. يجب أن يحتوي عنصر SupplyChain على الوسطاء المعنيّين بشكلٍ مباشر بعملية دفع رسوم المساحات الإعلانية المتاحة. وقد يشمل هؤلاء الوسطاء الجهات التكنولوجية التي يستخدمها الناشر لإدارة خادم الإعلانات من جهة خارجية. يمكن إرسال عنصر SupplyChain في طلب عرض الإعلان باستخدام المَعلمة schain.

مزيد من المعلومات عن المَعلمة schain

الوصف

The supply chain (schain) parameter accepts a variable value which should be serialized SupplyChain object. When this parameter is included, Google appends a node to any received schain objects prior to sending to buyers.

See the full IAB documentation for communicating SupplyChain information via a tag (rather than OpenRTB).

See requirements for schain to be parsed correctly

Based on the IAB documentation, the following defines the serialization for the SupplyChain object:

• {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject and SupplyChainNode properties are comma delimited such that optional fields can be omitted and comma separators for which can be optionally excluded.
• Each SupplyChainNode element is separated by a "!".
• If the value of any property contains characters that require URL encoding (for example "," or "!"), the value should be URL encoded before serialization.

Serialization order

SupplyChainObject properties are serialized in this order:

ver,complete

SupplyChainNode properties are serialized in this order:

asi,sid,hp,rid,name,domain,ext

Note: The contents of ext are exchange specific. Google Ad Manager does not parse this property.

Examples of how to serialize the SupplyChain object

Below are two examples of ways to serialize the above SupplyChain object:

Serialize with commas for empty optional fields

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Serialize without commas for empty optional fields

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Learn more about the SupplyChain object.

Usage examples

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

If the value for asi were exchange,1, then the serialization with escaped characters would look like:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Requirements and recommendations

While this this parameter is not required to serve ads to any specific implementation or transaction type, it is required for publishers leveraging payment intermediaries upstream of the request to Google Ad Manager. This includes publishers who use third-party ad server technology.

 

ملاحظة: يجب أيضًا تمثيل أيّ عقد إضافية ملحقة بعنصر SupplyChain في ملف ads.txt أو app-ads.txt الخاص بالناشر، وإلا قد يعتبر المشترون أنّ الزيارات غير مصرّح بها.

ناشرون متعددون لإدارة العملاء

إدارة العملاء المتعددين (MCM) تتيح للناشرين إدارة حسابات عملائهم على AdMob بالمستوى نفسه من الوضوح والتحكم الذي يحظى به الناشرون أنفسهم.

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