استخدِم طريقة Conversion.insert() لإضافة إحالة ناجحة واحدة أو أكثر. لتحديد مصدر الإحالة الناجحة بشكل صحيح، يجب أن يحدّد طلبك اسم نشاط Floodlight الذي يستخدمه المعلِن لتسجيل الإحالات الناجحة غير الإلكترونية، بالإضافة إلى رقم تعريف النقرة التي أدّت إلى الزيارة أو أرقام تعريف الكلمة الرئيسية التي أدّت إلى الإحالة الناجحة. للحصول على معلومات عن كيفية الحصول على معرّفات "إعلانات شبكة البحث 360"، اطّلِع على المقالة معرّفات "إعلانات شبكة البحث 360" والإحالات الناجحة.
يمكن العثور على معلومات حول القيود المفروضة على تحميل الإحالات الناجحة السابقة في مركز مساعدة "إعلانات شبكة البحث 360".
إذا كان طلب Conversion.insert() يحدّد إحالات ناجحة متعدّدة،
ستحاول "إعلانات شبكة البحث 360" تحميل كل إحالة ناجحة على أساس بذل أفضل جهد بدلاً من
تحميل الدفعة بأكملها كمعاملة "الكل أو لا شيء". إذا تعذّر تحميل بعض الإحالات الناجحة في دفعة معيّنة، قد يتم تحميل الإحالات الناجحة الأخرى بنجاح. يمكن أن يتعذّر تحميل الإحالات الناجحة بسبب طلب غير صالح أو أعطال مؤقتة في الشبكة أو النظام. لذلك، ننصحك بقراءة الردّ لكل إحالة ناجحة تم إدراجها للتأكّد من نجاح عملية التحميل.
متى يمكنني استخدام البيانات المحمَّلة؟
إذا حدّدت
conversionTimestamp لإحالة ناجحة يعود إلى اليوم أو أمس، ستظهر مقاييس الإحالة الناجحة في واجهة مستخدم "إعلانات شبكة البحث 360" خلال ساعة من التحميل. إذا حدّدت conversionTimestamp أقدم من أمس، سيتم تعديل المقاييس خلال بضع ساعات.
حوِّل جميع الطوابع الزمنية للإحالات الناجحة إلى توقيت Epoch (المعروف أيضًا باسم توقيت يونكس).
هل يمكنني إنشاء أنشطة Floodlight من واجهة برمجة التطبيقات؟
إذا لم يكن المعلِن قد أنشأ نشاط Floodlight لتتبُّع الإحالات الناجحة غير الإلكترونية، يمكنك استخدام Management API لإنشاء نشاط. لا يمكنك استخدام واجهة برمجة التطبيقات لتحديد أنّ نشاط Floodlight يُستخدَم بشكل أساسي للإحالات الناجحة غير الإلكترونية، وهو من أفضل الممارسات عندما تستخدِم استراتيجيات عروض الأسعار بيانات من الإحالة الناجحة.
ننصحك بأن يسجّل أحد مستخدمي "إعلانات شبكة البحث 360" الدخول إلى "إعلانات شبكة البحث 360" بعد استخدام واجهة برمجة التطبيقات لإنشاء نشاط Floodlight، ثم يغيّر إعداد النشاط للإشارة إلى أنّ المصدر الأساسي للإحالات الناجحة هو النشاط بلا إنترنت.
أفضل الممارسات لإضافة الإحالات الناجحة
ننصحك باتّباع أفضل الممارسات التالية لإضافة الإحالات الناجحة:
اطلب من أحد مستخدمي "إعلانات شبكة البحث 360" تسجيل الدخول إلى "إعلانات شبكة البحث 360" وتغيير الإعدادات لكل نشاط Floodlight تستخدمه للإبلاغ عن الإحالات الناجحة غير الإلكترونية. يجب أن تشير الإعدادات إلى أنّ المصدر الأساسي للإحالات الناجحة هو النشاط بلا إنترنت. اطّلِع على مركز مساعدة "إعلانات شبكة البحث 360" للحصول على التعليمات.
حمِّل الإحالات الناجحة فور توفّرها. إذا كنت تُرجع الإحالات الناجحة المحدّدة المصدر إلى زيارات معيّنة، انتظِر لمدة 6 ساعات على الأقل بعد الزيارة قبل تحميل الإحالة الناجحة. قد لا تتعرّف "إعلانات شبكة البحث 360" على معرّف النقرة الخاص بالزيارة إذا حمّلته قبل مرور 6 ساعات على الزيارة. في حالات نادرة، قد تحتاج إلى الانتظار لمدة تصل إلى 24 ساعة قبل أن تتمكّن "إعلانات شبكة البحث 360" من التعرّف على clickId.
تأكَّد من أنّ كل عملية تحميل تحتوي على أحدث الإحالات الناجحة. في طلب تحميل واحد، لا بأس إذا كانت الإدخالات غير مرتبة زمنيًا. ولكن قد لا تتمكّن استراتيجية عروض الأسعار من مراعاة الإحالات الناجحة القديمة التي تحمّلها لاحقًا في طلب مختلف.
إرسال طلب إدراج
يمكنك إرسال طلب Conversion.insert() لتنفيذ أيّ مما يلي:
- إسناد إحالة ناجحة إلى زيارة معيّنة
- إسناد إحالة ناجحة إلى كلمة رئيسية فقط
تعتمد الحقول المطلوبة في طلب Conversion.insert() على الحدث أو العنصر الذي تنسب الإحالة الناجحة إليه. تسرد الأقسام التالية الحقول المطلوبة والاختيارية لكل حدث أو عنصر يمكنك تحديد مصدر الإحالة الناجحة له.
إسناد إحالة ناجحة إلى زيارة معيّنة
عندما ينقر أحد العملاء على إعلان واحد أو أكثر وينتقل إلى الموقع الإلكتروني لأحد المعلِنين،
تعتبر "إعلانات شبكة البحث 360" جلسة المستخدِم على الموقع الإلكتروني للمعلِن زيارة.
لإسناد إحالة ناجحة إلى زيارة، حدِّد ما يلي في طلب Conversion.insert():
حقول مطلوبة
clickId: معرّف النقرة الحسّاس لحالة الأحرف للزيارة ابحث في سجلّات الويب الخاصة بالمعلِن عن معرّف النقرة، أو استرِدّconversion.click_idلإحالة ناجحة أخرى باستخدام Search Ads 360 Reporting API الجديدة. ستحدّد "إعلانات شبكة البحث 360" مصدر الإحالة الناجحة على أنّه الكلمة الرئيسية والإعلان وعناصر "إعلانات شبكة البحث 360" الأخرى التي كانت مسؤولة عن إنشاء الزيارة.
انتظِر لمدة 6 ساعات على الأقل بعد إنشاء "إعلانات شبكة البحث 360" لمعرّف نقرة من أجل تحميل الإحالات الناجحة. إذا ظهرت لك رسالة الخطأ "لم يتم العثور على معرّف النقرة"، انتظِر لمدة 24 ساعة، ثم حمِّل الإحالات الناجحة مرة أخرى. يجب تحميل جميع الإحالات الناجحة خلال 90 يومًا من إنشاء معرّف النقرة. بخلاف ذلك، قد لا تتعرّف Search Ads 360 API على الزيارة.-
conversionId: بالنسبة إلى الإحالات الناجحة غير الإلكترونية، يقدّم المعلِنون رقم التعريف هذا. ويمكن للمعلِنين تحديد أي رقم تعريف مفيد لهم. يجب أن تحدّد كل إحالة ناجحة في الطلب معرّفًا فريدًا، ويجب أن يكون الجمع بين المعرّف والطابع الزمني فريدًا من نوعه بين جميع الإحالات الناجحة ضمن المعلِن. بالنسبة إلى الإحالات الناجحة على الإنترنت، تنسخ "إعلانات شبكة البحث 360" القيمةdsConversionIdأوfloodlightOrderIdإلى هذه السمة استنادًا إلى تعليمات Floodlight الخاصة بالمعلِن. conversionTimestamp: يشير إلى تاريخ ووقت حدوث الإحالة الناجحة. على سبيل المثال، إذا حدثت الإحالة الناجحة يوم الجمعة 5 أغسطس 2016 في الساعة 11:53:22 صباحًا بنظام التوقيت الصيفي الشرقي (GMT -4:00)، حدِّد الطابع الزمني بالملي ثانية من بداية الحقبة:1470412402000.segmentationType: يحدّد نوع نظام الإحالات الناجحة الذي يتم تحميل الإحالة الناجحة إليه. لا تتوفّر حاليًا سوى الإحالات الناجحة في Floodlight، لذا يجب دائمًا تحديدFLOODLIGHTفي هذا الحقل.-
segmentationName: اسم نشاط Floodlight الذي يستخدمه المعلِن للإبلاغ عن الإحالة الناجحةإذا كان المعلِن يتضمّن أنشطة بالاسم نفسه (يمكن أن يحدث ذلك إذا كانت الأنشطة تنتمي إلى مجموعات Floodlight مختلفة)، فإنّ الإجراء المقترَح هو إعادة تسمية أحد الأنشطة.
بدلاً من ذلك، يمكنك تحديد رقم تعريف نشاط Floodlight في حقل
segmentationIdبدلاً من تحديد الاسم في حقلsegmentationName. استخدِم رقم التعريف الذي عيّنه "مدير الحملة" لنشاط Floodlight. يمكنك استرداد هذا المعرّف باستخدام الحقلconversion_action.floodlight_settings.activity_idفي التجربة الجديدة من Search Ads 360 Reporting API. يتم أيضًا قبولsegmentationIdالذي تعرضه "إعلانات شبكة البحث 360" في الردّ على طلب إحالة ناجحة. -
type: نوع الإحالة الناجحة، أيACTIONأوTRANSACTIONلا تتضمّن الإحالة الناجحة من النوع ACTION أي قيمة نقدية، في حين أنّ الإحالة الناجحة من النوع TRANSACTION تتضمّن قيمة نقدية. ومن الأمثلة على ذلك الاشتراك في قائمة البريد الإلكتروني (إجراء) مقابل عمليات الشراء في التجارة الإلكترونية (معاملة).في حال تحديد السمة
TRANSACTION، عليك أيضًا تحديد الحقل التالي:-
revenueMicros: تشير إلى القيمة النقدية للإحالة الناجحة.
-
حقول اختيارية
-
quantityMillis: عدد السلع في هذه الإحالة الناجحة على سبيل المثال، عدد المستخدمين الذين اشتركوا في نشرة إخبارية عبر البريد الإلكتروني أو إجمالي عدد السلع المُباعة. إذا لم تحدّد هذا الحقل للإحالات الناجحة من النوع ACTION، تُدرج "إعلانات شبكة البحث 360" تلقائيًا القيمة1000. -
currencyCode: عملة إيرادات المعاملة بشكلٍ تلقائي، يُفترض أن تكون الإيرادات بعملة المعلِن. في حال تحديد عملة مختلفة، تحوِّل "إعلانات شبكة البحث 360" مبلغ الإيرادات المحدّد إلى عملة المعلِن. مزيد من المعلومات
استخدِم تنسيق ISO 4217 الأبجدي (3 أحرف) لتحديد العملة.
ينطبق ذلك على الإحالات الناجحة من نوع "معاملة" فقط. -
customMetricوcustomDimension: يتم تحميل بيانات إضافية عن إحالة ناجحة، مثل البلد الذي يتم شحن السلعة التي تم شراؤها إليه أو أرقام تعريف المنتجات أو حتى مدة المكالمة الهاتفية. مزيد من المعلومات عن تحميل البيانات لمتغيّرات Floodlight المخصّصة deviceType: يحدّد نوع الجهاز الذي حدثت عليه الإحالة الناجحة. اطّلِع على قائمة القيم المقبولة لهذا الحقل.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue "currencyCode": "USD" }] }
جافا
/** * Instantiate the Doubleclicksearch service, create conversions, and upload them. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. // Set up a List to keep track of each conversion you create. List<Conversion> conversions = new Vector<Conversion>(); // Add a conversion to the List. addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L); // Upload the List and handle the response. uploadConversions(conversions, service); } /** * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes * the segmentation name and currency. You probably wouldn't want your production code to be so brittle. */ private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions, String clickId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion().setClickId(clickId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; } /** * Convert the List of conversions to a DS ConversionList, send an insert request to DS, * and output the response to a file. */ private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service) throws IOException { FileOutputStream outputStream = new FileOutputStream(new File("./", "InsertConversionsResponse.txt")); final PrintStream printStream = new PrintStream(outputStream); try { // Convert the List to a ConversionList. ConversionList conversionList = new ConversionList().setConversion(conversions); // Insert an upload request and download the response to a file. service.conversion().insert(conversionList).executeAndDownloadTo(printStream); printStream.close(); } catch (GoogleJsonResponseException e) { System.err.println("Get request was rejected."); for (ErrorInfo error : e.getDetails().getErrors()) { System.err.println(error.getMessage()); } System.exit(e.getStatusCode()); } }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a visit. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site 'conversionId': 'test_20140206_00', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
إسناد إحالة ناجحة إلى كلمة رئيسية فقط
إذا لم يكن لديك معرّف نقرة، يمكنك تحديد مصدر الإحالة الناجحة مباشرةً إلى كلمة رئيسية. في التجربة الجديدة من "إعلانات شبكة البحث 360"، تكون معرّفات الكلمات الرئيسية فريدة فقط ضمن مجموعة إعلانية، لذا عليك تحديد المجموعة الكاملة من معرّفات التجربة الجديدة من "إعلانات شبكة البحث 360" التي تحدّد الكلمة الرئيسية، إلى جانب بعض الحقول الأخرى:
حقول مطلوبة
-
customerId: رقم تعريف العميل لحساب العميل الذي يحتوي على الكلمة الرئيسية، مثل123-456-7890. -
campaignId: رقم تعريف الحملة التي تحتوي على الكلمة الرئيسية -
adGroupId: معرّف المجموعة الإعلانية التي تحتوي على الكلمة الرئيسية -
criterionId: رقم تعريف الكلمة الرئيسيةإذا حدّدت إحالة ناجحة
criterionIdبدونcustomerIdأوcampaignIdأوadGroupId، يتعذّر إكمالها مع ظهور رمز الخطأ0x0000012E. للحصول على معلومات عن كيفية الحصول على أرقام التعريف هذه، يُرجى الاطّلاع على أرقام التعريف والإحالات الناجحة في "إعلانات شبكة البحث 360". -
conversionId: بالنسبة إلى الإحالات الناجحة غير الإلكترونية، يقدّم المعلِنون رقم التعريف هذا. ويمكن للمعلِنين تحديد أي رقم تعريف مفيد لهم. يجب أن تحدّد كل إحالة ناجحة في الطلب معرّفًا فريدًا، ويجب أن يكون الجمع بين المعرّف والطابع الزمني فريدًا من نوعه بين جميع الإحالات الناجحة ضمن المعلِن. بالنسبة إلى الإحالات الناجحة على الإنترنت، تنسخ "إعلانات شبكة البحث 360" القيمةdsConversionIdأوfloodlightOrderIdإلى هذه السمة استنادًا إلى تعليمات Floodlight الخاصة بالمعلِن. conversionTimestamp: يشير إلى تاريخ ووقت حدوث الإحالة الناجحة. على سبيل المثال، إذا حدثت الإحالة الناجحة يوم الجمعة 5 أغسطس 2016 في الساعة 11:53:22 صباحًا بنظام التوقيت الصيفي الشرقي (GMT -4:00)، حدِّد الطابع الزمني بالملي ثانية من بداية الحقبة:1470412402000.segmentationType: يحدّد نوع نظام الإحالات الناجحة الذي يتم تحميل الإحالة الناجحة إليه. لا تتوفّر حاليًا سوى الإحالات الناجحة في Floodlight، لذا يجب دائمًا تحديدFLOODLIGHTفي هذا الحقل.-
segmentationName: اسم نشاط Floodlight الذي يستخدمه المعلِن للإبلاغ عن الإحالة الناجحةإذا كان المعلِن يتضمّن أنشطة بالاسم نفسه (يمكن أن يحدث ذلك إذا كانت الأنشطة تنتمي إلى مجموعات Floodlight مختلفة)، فإنّ الإجراء المقترَح هو إعادة تسمية أحد الأنشطة.
بدلاً من ذلك، يمكنك تحديد رقم تعريف نشاط Floodlight في حقل
segmentationIdبدلاً من تحديد الاسم في حقلsegmentationName. استخدِم رقم التعريف الذي عيّنه "مدير الحملة" لنشاط Floodlight. يمكنك استرداد هذا المعرّف باستخدام الحقلconversion_action.floodlight_settings.activity_idفي التجربة الجديدة من Search Ads 360 Reporting API. يتم أيضًا قبولsegmentationIdالذي تعرضه "إعلانات شبكة البحث 360" في الردّ على طلب إحالة ناجحة. -
type: نوع الإحالة الناجحة، أيACTIONأوTRANSACTIONلا تتضمّن الإحالة الناجحة من النوع ACTION أي قيمة نقدية، في حين أنّ الإحالة الناجحة من النوع TRANSACTION تتضمّن قيمة نقدية. ومن الأمثلة على ذلك الاشتراك في قائمة البريد الإلكتروني (إجراء) مقابل عمليات الشراء في التجارة الإلكترونية (معاملة).في حال تحديد السمة
TRANSACTION، عليك أيضًا تحديد الحقل التالي:-
revenueMicros: تشير إلى القيمة النقدية للإحالة الناجحة.
-
حقول اختيارية
-
quantityMillis: عدد السلع في هذه الإحالة الناجحة على سبيل المثال، عدد المستخدمين الذين اشتركوا في نشرة إخبارية عبر البريد الإلكتروني أو إجمالي عدد السلع المُباعة. إذا لم تحدّد هذا الحقل للإحالات الناجحة من النوع ACTION، تُدرج "إعلانات شبكة البحث 360" تلقائيًا القيمة1000. -
currencyCode: عملة إيرادات المعاملة بشكلٍ تلقائي، يُفترض أن تكون الإيرادات بعملة المعلِن. في حال تحديد عملة مختلفة، تحوِّل "إعلانات شبكة البحث 360" مبلغ الإيرادات المحدّد إلى عملة المعلِن. مزيد من المعلومات
استخدِم تنسيق ISO 4217 الأبجدي (3 أحرف) لتحديد العملة.
ينطبق ذلك على الإحالات الناجحة من نوع "معاملة" فقط. -
customMetricوcustomDimension: يتم تحميل بيانات إضافية عن إحالة ناجحة، مثل البلد الذي يتم شحن السلعة التي تم شراؤها إليه أو أرقام تعريف المنتجات أو حتى مدة المكالمة الهاتفية. مزيد من المعلومات عن تحميل البيانات لمتغيّرات Floodlight المخصّصة deviceType: يحدّد نوع الجهاز الذي حدثت عليه الإحالة الناجحة. اطّلِع على قائمة القيم المقبولة لهذا الحقل.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "customerId": "123-456-7890", // Replace with your ID "campaignId": "14660344555", // Replace with your ID "adGroupId": "105138634255", // Replace with your ID "criterionId": "948710340465", // Replace with your ID "conversionId": "customerTransaction73126", "conversionTimestamp": "1351196386000", "segmentationType": "FLOODLIGHT", "segmentationName": "Offline Purchase", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD" }] }
جافا
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCustomerId(customerId) .setCampaignId(campaignId) .setAdGroupId(adGroupId) .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a keyword only. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'customerId': '123-456-7890', // Replace with your ID 'campaignId': '14660344555', // Replace with your ID 'adGroupId': '105138634255', // Replace with your ID 'criterionId': '948710340465', // Replace with your ID 'conversionId': 'test_1378710000000', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
تحميل البيانات من نموذج تحديد مصدر خارجي
يوزّع نموذج تحديد المصدر نسبة المساهمة في إتمام الإحالة الناجحة على مستوى الأنشطة المختلفة في مسار الإحالة الناجحة. على سبيل المثال، إذا نقر أحد المستهلِكين على إعلان في نتائج البحث المدفوعة، وإعلان صوري، وإعلان آخر في نتائج البحث المدفوعة قبل إتمام إحالة ناجحة، سيمنح نموذج تحديد المصدر للمساواة بين نقاط الاتصال كلّ نقرة %33 من نسبة المساهمة في الإحالة الناجحة.
على الرغم من أنّ "إعلانات شبكة البحث 360" توفّر نماذج تحديد المصدر، إذا كنت تستخدِم خدمة تابعة لجهة خارجية أو خدمة طوّرتها لتوزيع نسبة المساهمة على النقرات، يمكنك تحميل بيانات تحديد المصدر التابعة للجهة الخارجية إلى "إعلانات شبكة البحث 360" واستخدام البيانات في التقارير واستراتيجيات عروض الأسعار في "إعلانات شبكة البحث 360".
قبل البدء
في "مدير الحملة"، أنشِئ نموذج تحديد مصدر مخصّصًا واستورِد النموذج إلى "إعلانات شبكة البحث 360". تأكَّد من تسمية النموذج نموذج تحديد المصدر الخارجي. يتيح ذلك لميزات "إعلانات شبكة البحث 360" التعرّف على أنّه تم تطبيق نموذج تحديد مصدر على بيانات الإحالات الناجحة التي تحمّلها. مزيد من المعلومات
حقول مطلوبة
لتطبيق نموذج تحديد مصدر تابع لجهة خارجية على إحالة ناجحة، حدِّد كل ما يلي في طلب Conversion.insert():
clickId: معرّف النقرة الحسّاس لحالة الأحرف للزيارة ابحث في سجلّات الويب الخاصة بالمعلِن عن معرّف النقرة، أو استرِدّconversion.click_idلإحالة ناجحة أخرى باستخدام Search Ads 360 Reporting API الجديدة. ستحدّد "إعلانات شبكة البحث 360" مصدر الإحالة الناجحة على أنّه الكلمة الرئيسية والإعلان وعناصر "إعلانات شبكة البحث 360" الأخرى التي كانت مسؤولة عن إنشاء الزيارة.
انتظِر لمدة 30 دقيقة على الأقل بعد إنشاء "إعلانات شبكة البحث 360" لمعرّف نقرة قبل تحميل إحالة ناجحة باستخدام المعرّف. بخلاف ذلك، قد لا تتعرّف Search Ads 360 API على الزيارة.-
attributionModel: اضبطه على نموذج تحديد المصدر الخارجي. مزيد من المعلومات -
countMillis: نسبة المساهمة في الإحالة الناجحة التي سيتم توزيعها على هذه النقرة. ينطبق ذلك فقط إذا كان الطلب يتضمّن أيضًا الحقلattributionModel.يُرجى عدم الخلط بين هذه المَعلمة ومَعلمة
quantityMillis، وهي حقل اختياري يحدّد عدد السلع في الإحالة الناجحة (مثل عدد السلع في عملية شراء من سلّة تسوّق). -
conversionId: بالنسبة إلى الإحالات الناجحة غير الإلكترونية، يقدّم المعلِنون رقم التعريف هذا. ويمكن للمعلِنين تحديد أي رقم تعريف مفيد لهم. يجب أن تحدّد كل إحالة ناجحة في الطلب معرّفًا فريدًا، ويجب أن يكون الجمع بين المعرّف والطابع الزمني فريدًا من نوعه بين جميع الإحالات الناجحة ضمن المعلِن. بالنسبة إلى الإحالات الناجحة على الإنترنت، تنسخ "إعلانات شبكة البحث 360" القيمةdsConversionIdأوfloodlightOrderIdإلى هذه السمة استنادًا إلى تعليمات Floodlight الخاصة بالمعلِن. conversionTimestamp: يشير إلى تاريخ ووقت حدوث الإحالة الناجحة. على سبيل المثال، إذا حدثت الإحالة الناجحة يوم الجمعة 5 أغسطس 2016 في الساعة 11:53:22 صباحًا بنظام التوقيت الصيفي الشرقي (GMT -4:00)، حدِّد الطابع الزمني بالملي ثانية من بداية الحقبة:1470412402000.segmentationType: يحدّد نوع نظام الإحالات الناجحة الذي يتم تحميل الإحالة الناجحة إليه. لا تتوفّر حاليًا سوى الإحالات الناجحة في Floodlight، لذا يجب دائمًا تحديدFLOODLIGHTفي هذا الحقل.-
segmentationName: اسم نشاط Floodlight الذي يستخدمه المعلِن للإبلاغ عن الإحالة الناجحةإذا كان المعلِن يتضمّن أنشطة بالاسم نفسه (يمكن أن يحدث ذلك إذا كانت الأنشطة تنتمي إلى مجموعات Floodlight مختلفة)، فإنّ الإجراء المقترَح هو إعادة تسمية أحد الأنشطة.
بدلاً من ذلك، يمكنك تحديد رقم تعريف نشاط Floodlight في حقل
segmentationIdبدلاً من تحديد الاسم في حقلsegmentationName. استخدِم رقم التعريف الذي عيّنه "مدير الحملة" لنشاط Floodlight. يمكنك استرداد هذا المعرّف باستخدام الحقلconversion_action.floodlight_settings.activity_idفي التجربة الجديدة من Search Ads 360 Reporting API. يتم أيضًا قبولsegmentationIdالذي تعرضه "إعلانات شبكة البحث 360" في الردّ على طلب إحالة ناجحة. -
type: نوع الإحالة الناجحة، أيACTIONأوTRANSACTIONلا تتضمّن الإحالة الناجحة من النوع ACTION أي قيمة نقدية، في حين أنّ الإحالة الناجحة من النوع TRANSACTION تتضمّن قيمة نقدية. ومن الأمثلة على ذلك الاشتراك في قائمة البريد الإلكتروني (إجراء) مقابل عمليات الشراء في التجارة الإلكترونية (معاملة).في حال تحديد السمة
TRANSACTION، عليك أيضًا تحديد الحقل التالي:-
revenueMicros: تشير إلى القيمة النقدية للإحالة الناجحة.
-
إذا كنت تتتبّع إيرادات الإحالات الناجحة، تأكَّد من أنّ نموذجك يوزّع الإيرادات على كل نقطة اتصال في مسار الإحالة الناجحة. على سبيل المثال، إذا كان نموذجك يستخدم أسلوبًا للمساواة بين نقاط الاتصال (توزيع الإيرادات بالتساوي على كلّ نقاط الاتصال)، في مسار إحالة ناجحة يتضمّن 3 نقرات على الإعلان، سيتمّ تحديد مصدر كلّ نقرة على أنّها ساهمت بنسبة %33 من الإحالة الناجحة. إذا حقّقت الإحالة الناجحة إيرادات بقيمة 100 دولار أمريكي، تأكَّد من أنّ نموذجك يوزّع 33 دولار أمريكي من الإيرادات على كل نقرة، وتأكَّد من أنّ revenueMicros يحدّد 33 دولار أمريكي فقط من الإيرادات لكل نقرة.
حقول اختيارية
-
quantityMillis: عدد السلع في هذه الإحالة الناجحة على سبيل المثال، عدد المستخدمين الذين اشتركوا في نشرة إخبارية عبر البريد الإلكتروني أو إجمالي عدد السلع المُباعة. إذا لم تحدّد هذا الحقل للإحالات الناجحة من النوع ACTION، تُدرج "إعلانات شبكة البحث 360" تلقائيًا القيمة1000. -
currencyCode: عملة إيرادات المعاملة بشكلٍ تلقائي، يُفترض أن تكون الإيرادات بعملة المعلِن. في حال تحديد عملة مختلفة، تحوِّل "إعلانات شبكة البحث 360" مبلغ الإيرادات المحدّد إلى عملة المعلِن. مزيد من المعلومات
استخدِم تنسيق ISO 4217 الأبجدي (3 أحرف) لتحديد العملة.
ينطبق ذلك على الإحالات الناجحة من نوع "معاملة" فقط. -
customMetricوcustomDimension: يتم تحميل بيانات إضافية عن إحالة ناجحة، مثل البلد الذي يتم شحن السلعة التي تم شراؤها إليه أو أرقام تعريف المنتجات أو حتى مدة المكالمة الهاتفية. مزيد من المعلومات عن تحميل البيانات لمتغيّرات Floodlight المخصّصة deviceType: يحدّد نوع الجهاز الذي حدثت عليه الإحالة الناجحة. اطّلِع على قائمة القيم المقبولة لهذا الحقل.
مثال
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "attributionModel": "External Attribution Model", "countMillis": "330", "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue "currencyCode": "USD" }] }
التعامل مع استجابات "إعلانات شبكة البحث 360"
تشير الاستجابة من "إعلانات شبكة البحث 360" إلى النجاح فقط في حال تم التحقّق من صحة جميع الإحالات الناجحة في الطلب وتحميلها بنجاح.
في حال نجاح الطلب
إذا نجح الطلب، ستتضمّن الاستجابة التمثيل الداخلي الكامل لكل إحالة ناجحة تم تحميلها في "إعلانات شبكة البحث 360". يستخدم التمثيل معرّفات التجربة الجديدة من "إعلانات شبكة البحث 360": معرّف العميل لحساب العميل، ومعرّف الحملة، ومعرّف المجموعة الإعلانية، ومعرّف الكلمة الرئيسية (المعيار)، ومعرّف الإعلان الذي تمّت نسبة الإحالة الناجحة إليه.
في ما يلي مثال على ردّ لإحالة ناجحة منسوبة إلى زيارة:
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"customerId": "123-456-7890",
"campaignId": "14660344555",
"adGroupId": "105138634255",
"criterionId": "948710340465",
"adId": "562719339005",
"clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
"conversionId": "test_20130906_04",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "10000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368",
"floodlightOrderId": "test_20130906_04",
"countMillis": "1000",
"deviceType": "DESKTOP"
},
...
]
}
يتضمّن الردّ المعرّفات التي تنطبق على الإحالة الناجحة فقط. على سبيل المثال، لا تتضمّن الاستجابة لإحالة ناجحة منسوبة إلى كلمة رئيسية فقط السمتَين clickId وadId.
في حال عدم نجاح الطلب
إذا تعذّر التحقّق من صحة إحالة ناجحة واحدة أو أكثر أو تعذّر تحميلها، سيتضمّن الردّ رسائل لكل عملية تحميل إحالة ناجحة تعذّر إكمالها. لا يحتوي الردّ على رسائل حول الإحالات الناجحة التي تم تحميلها بنجاح.
في ما يلي مثال على ردّ على طلب لم ينجح بالكامل:
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
تحتوي كل رسالة خطأ على حقلَين مهمَّين: سبب الخطأ ورسالة خطأ تفصيلية. يمكن أن يحتوي حقل السبب على requestValidation أو internalError أو transactionFailed أو lateStageRequestError.
أخطاء requestValidation
requestValidation: تشير إلى مشاكل في البيانات في طلب تحميل الإحالة الناجحة (على سبيل المثال، تم تحميل الإحالة الناجحة مسبقًا أو لم يتم العثور على clickId). في هذا النوع من الأخطاء، تحتوي تفاصيل الرسالة على عنصرَين:
- رمز ست عشري يحدّد نوع الخطأ. ويمكنك استخدام الرمز في النصوص البرمجية الخاصة بك لتحديد الأخطاء.
- وصف لخطأ التحقّق
لمزيد من المعلومات، اطّلِع على قائمة الرموز والأوصاف التي يمكن أن تعرضها "إعلانات شبكة البحث 360" لأخطاء تحميل الإحالات الناجحة.
أنواع أخرى من الأخطاء
تشير جميع أنواع الأخطاء الأخرى (internalError أو transactionFailed أو lateStageRequestError) إلى وجود مشكلة داخلية في "إعلانات شبكة البحث 360".
الاستجابة لخطأ
إذا تعذّر تنفيذ الطلب، حاوِل إعادة إرسال طلب البيانات بالكامل لاحقًا. ستُبلغ "إعلانات شبكة البحث 360" عن أخطاء requestValidation لأي إحالات ناجحة تم تحميلها من قبل، ولكنها ستحاول تحميل الإحالات الناجحة المتبقية.
إذا استمر ظهور الأخطاء بعد إعادة الإرسال، يمكنك الاطّلاع على قسم تحديد المشاكل وحلّها للحصول على معلومات حول كيفية المتابعة.