يتيح عنصر SupplyChain للمشترين والوسطاء معرفة جميع الأطراف التي تبيع المساحات الإعلانية المتاحة أو إعادة بيعها. يعمل العنصر مع ads.txt / app-ads.txt وsellers.json لتوفير الشفافية في المنظومة المتكاملة للإعلانات.
- يرسِل الناشر طلب عرض سعر.
- يتلقّى المشتري طلب عرض السعر والبيانات من عنصر SupplyChain.
- يبحث المشتري عن هويات جميع الوسطاء الذين يعيدون بيع المستودع.
- يجري المشتري عملية الزحف ويتحقّق من المورّدين المصرح لهم ببيع المستودع.
ستنشئ Google تلقائيًا العناصر ضمن طلب OpenRTB أو بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google، إن وُجد.
آلية عمل عنصر SupplyChain
يمثّل العنصر SupplyChain، المعروف أيضًا باسم schainschain جهة معيّنة تشارك في طلب عرض السعر، بما في ذلك جميع الجهات المشتركة في عملية الدفع المباشرة لرسوم المساحات الإعلانية المتاحة.
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. ويشمل ذلك عروض الأسعار في رأس الصفحة من جهة العميل، وعروض الأسعار غير المدفوعة في رأس الصفحة، ومشاركة المساحات الإعلانية المتاحة، والتوسّط الآخر.
الناشرون الذين يستخدِمون وسطاء دفع قبل إرسال الطلب (تجريبي)
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.
الوصف
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 forschain to be parsed correctly
Based on the IAB documentation, the following defines the serialization for the SupplyChain object:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectandSupplyChainNodeproperties are comma delimited such that optional fields can be omitted and comma separators for which can be optionally excluded.- Each
SupplyChainNodeelement 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
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:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
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 الخاص بالناشر، وإلا قد يعتبر المشترون أنّ الزيارات غير مصرّح بها.Multiple Customer Management publishers
Multiple Customer Management (MCM) enables parent publishers to monetize child publishers’ inventory either individually with the Manage Account delegation type, or at scale with the Manage Inventory delegation type .
For parent and child publishers using Manage Inventory, there is now one SupplyChain Object created with one node for the parent publisher’s seller ID, one node for the child publisher, and the schain object is marked complete.
For parent and child publishers using Manage Account, the schain object will have one node with the child publisher’s seller ID and the chain will be marked as complete. For Manage Account publishers, monetization occurs in the child publisher’s account. The child publisher is treated as the end publisher. The parent publisher’s information is not included in the schain object.