إضافة إحالات ناجحة جديدة

يمكنك الاتصال بالرقم Conversion.insert(). لإضافة إحالة ناجحة واحدة أو أكثر. لتحديد مصدر الإحالة الناجحة بشكل صحيح، يجب أن يتضمن طلبك إلى تحديد اسم نشاط Floodlight الذي يستخدمه المعلن للإبلاغ. الإحالات الناجحة غير الإلكترونية، بالإضافة إلى معرّف الكلمة الرئيسية والإعلان وربما النقرة التي أدت إلى الإحالة الناجحة. بالنسبة معلومات عن الحصول على أرقام تعريف "إعلانات شبكة البحث 360"، يمكنك الاطّلاع على أرقام تعريف "إعلانات شبكة البحث 360" الإحالات الناجحة:

يمكن العثور على معلومات حول القيود المفروضة على تحميل الإحالات الناجحة السابقة في مركز مساعدة "إعلانات شبكة البحث 360".

إذا كان طلب "Conversion.insert()" يحدّد عدة إحالات ناجحة، تحاول "إعلانات شبكة البحث 360" تحميل كل إحالة ناجحة على أساس أفضل جهد بدلاً من تحميل الدُفعة بأكملها كمعاملة شاملة أو غير مكتملة. إذا كانت بعض الإحالات الناجحة في تعذّر تحميل ملفات متعددة، قد يستمر تحميل ملفات أخرى بنجاح. قد يتعذّر إتمام عمليات تحميل الإحالات الناجحة بسبب طلب غير صالح أو أعطال مؤقتة في الشبكة أو النظام. لذلك، ننصحك بقراءة الردّ على كل إحالة ناجحة يتم إدراجها أن تتأكد من أن التحميل تم بنجاح.

متى يمكنني استخدام البيانات المحمَّلة؟

إذا حددت conversionTimestamp اليوم أو الأمس لإحالة ناجحة، مقاييس ستظهر الإحالة الناجحة في واجهة مستخدم "إعلانات شبكة البحث 360" في غضون ساعة من عملية التحميل. إذا كنت تحديد conversionTimestamp أقدم من الأمس، سيتم تعديل المقاييس في عدة ساعات.

تحويل كل الطوابع الزمنية للإحالات الناجحة إلى وقت الحقبة (المعروف أيضًا باسم توقيت يونكس)

هل يمكنني إنشاء أنشطة Floodlight من واجهة برمجة التطبيقات؟

إذا لم ينشئ المعلِن نشاطًا Floodlight حتى الآن لتتبُّع الإحالات الناجحة بلا إنترنت يمكنك استخدام واجهة برمجة تطبيقات "مدير الحملة" لإنشاء حساب لا يمكنك استخدام واجهة برمجة التطبيقات لتحديد أن نشاط Floodlight يُستخدم بشكلٍ أساسي للإحالات الناجحة بلا إنترنت، وهي أفضل ممارسة عندما تستخدم استراتيجيات عروض الأسعار البيانات من الإحالة الناجحة.

ننصحك بعد استخدام واجهة برمجة التطبيقات لإنشاء Floodlight النشاط، يسجّل أحد مستخدمي "إعلانات شبكة البحث 360" الدخول إلى "إعلانات شبكة البحث 360" ويغيّر إعداد للإشارة إلى أن المصدر الإحالات الناجحة هي نشاط بلا إنترنت.

أفضل الممارسات لإضافة الإحالات الناجحة

نقترح اتّباع أفضل الممارسات التالية لإضافة الإحالات الناجحة:

  1. الطلب من أحد مستخدمي "إعلانات شبكة البحث 360" تسجيل الدخول إلى "إعلانات شبكة البحث 360" وتغيير الإعدادات لكل نشاط من أنشطة Floodlight التي تستخدمها للإبلاغ عن الإحالات الناجحة بلا إنترنت يجب ضبط الإعدادات الإشارة إلى أنّ النشاط بلا إنترنت هو المصدر الأساسي للإحالات الناجحة يمكنك الاطّلاع على مركز مساعدة "إعلانات شبكة البحث 360" للحصول على التعليمات.

  2. تحميل الإحالات الناجحة فور توفُّرها إذا كنت إحالة الإحالات الناجحة إلى زيارات محدّدة، انتظر لمدة 30 دقيقة على الأقل بعد الزيارة قبل تحميل الإحالة الناجحة. قد لا تتعرّف "إعلانات شبكة البحث 360" على معرّف النقرة للزيارة في حال تحميله بعد أقل من 30 دقيقة من الزيارة. في حالات نادرة، قد تحتاج إلى انتظِر لمدّة 4 ساعات قبل أن تتمكّن "إعلانات شبكة البحث 360" من التعرّف على معرّف النقرة.

    تأكّد من أن كل عملية تحميل تحتوي على أحدث الإحالات الناجحة. في نطاق واحد طلب التحميل، فلا بأس إذا كانت الإدخالات خارج الترتيب الزمني. ولكن استراتيجية عروض الأسعار قد لن يتمكنوا من مراعاة الإحالات الناجحة القديمة التي تحمّلها لاحقًا في طلب مختلف.

  3. إذا انتظرت أكثر من 24 ساعة قبل تحميل الإحالات الناجحة لأحد أنشطة Floodlight، إرسال الطابع الزمني لمدى التوفّر.

    يجب أن يكون الطابع الزمني لمدى التوفّر واحدًا مما يلي:

    • إذا كنت قد سجّلت إحالات ناجحة خلال آخر 24 ساعة ولكن لم تحمّلها حتى الآن، يجب أن يكون الطابع الزمني في الوقت الذي تم فيه آخر إحالة ناجحة حدثت. يؤدي ذلك إلى إعلام "إعلانات شبكة البحث 360" باحتمال حدوث إحالات ناجحة. خلال آخر 24 ساعة، ولكنك لم تقدّم البيانات بعد استراتيجيات عروض الأسعار فستأخذ الأنظمة الآلية الأخرى في الاعتبار سجلّ الأداء فقط حتى آخر الإحالة الناجحة التي حمّلتها
    • وإذا لم تحدث أي إحالات ناجحة خلال آخر 24 ساعة، يجب أن يكون الطابع الزمني الوقت والتاريخ الحاليين. ويؤدي ذلك إلى إعلام "إعلانات شبكة البحث 360" بعدم حدثت خلال آخر 24 ساعة. استراتيجيات عروض الأسعار وغيرها من استراتيجيات عروض الأسعار ستتضمن آخر 24 ساعة - يوم كامل بدون إحالات ناجحة - من سجل الأداء.

إرسال طلب إدراج

يمكنك إرسال طلب "Conversion.insert()" لتنفيذ أيّ من الإجراءات التالية:

  • إسناد الإحالة الناجحة إلى زيارة محدّدة
  • إسناد الإحالة الناجحة إلى كلمة رئيسية فقط

تعتمد الحقول المطلوبة في طلب Conversion.insert() على الحدث أو العنصر الذي تُنسب الإحالة الناجحة إليه. تسرد الأقسام التالية الأقسام المطلوبة واختيارية لكل حدث أو عنصر يمكنك تحديد مصدر إحالة ناجحة له.

إسناد الإحالة الناجحة إلى زيارة محدّدة

وعندما ينقر عميل على إعلان واحد أو أكثر وينتقل إلى الموقع الإلكتروني للمعلِن، تعتبر "إعلانات شبكة البحث 360" جلسة المستخدم على الموقع الإلكتروني للمعلِن بمثابة زيارة. لإسناد إحالة ناجحة إلى زيارة، حدِّد ما يلي في Conversion.insert(). الطلب:

حقول مطلوبة

  • clickId: رقم تعريف النقرة الحسّاس لحالة الأحرف المتعلّق بالزيارة. انظر في سجلات الويب للمعلِن لمعرّف النقرة أو إدراج الإحالات الناجحة واستخدام معرّف نقرة من إحالة ناجحة أخرى ستنسِب "إعلانات شبكة البحث 360" الإحالة الناجحة إلى والكلمة الرئيسية والإعلان وغيرها من عناصر "إعلانات شبكة البحث 360" التي كانت مسؤولة عن إنشاء الزيارة.
    انتظِر لمدة 30 دقيقة على الأقل بعد تُنشئ "إعلانات شبكة البحث 360" معرّف نقرة لتحميل الإحالات الناجحة. في حال ظهور الرسالة "لم يتم العثور على معرّف النقرة" يُرجى الانتظار لمدة 4 ساعات ثم تحميل الإحالات الناجحة مرة أخرى. يجب تحميل كل الإحالات الناجحة خلال 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 مختلفة)، فإن الإجراء المقترَح هو إعادة تسمية أحد الأنشطة.

    بدلاً من ذلك، إذا كنت تعرف رقم التعريف الذي حدّدته "إعلانات شبكة البحث 360" لنشاط Floodlight، يمكنك تحديد المعرّف في segmentationId بدلاً من تحديد الاسم في الحقل segmentationName. (يعيّن "مدير الحملة" أيضًا رقم تعريف لنشاط Floodlight، ولكن يختلف رقم تعريف "مدير الحملة" عن رقم تعريف "إعلانات شبكة البحث 360"، ولا يمكن استخدامه لتحديد المصدر conversions.) لعرض رقم تعريف "إعلانات شبكة البحث 360" لأحد أنشطة Floodlight، عليك تنزيل تقرير الإحالات الناجحة (إما من واجهة مستخدم "إعلانات شبكة البحث 360" أو التقارير API). إذا كانت قد نُسبت إحالة ناجحة واحدة على الأقل إلى نشاط Floodlight خلال الإطار الزمني للتقرير، سترى رقم تعريف "إعلانات شبكة البحث 360" في التقرير.

  • type: نوع الإحالة الناجحة، أي إما ACTION أو TRANSACTION. لا ترتبط الإحالة الناجحة ACTION بقيمة نقدية، بينما تحويل TRANSACTION فيه. تشمل الأمثلة عمليات الاشتراك في قوائم عناوين البريد الإلكتروني (ACTION) في مقابل عمليات الشراء في التجارة الإلكترونية (TRANSACTION).

    إذا حددت TRANSACTION، تحتاج أيضًا إلى تحديد الحقل التالي:

    • revenueMicros: القيمة النقدية للإحالة الناجحة

حقول اختيارية

  • quantityMillis: عدد العناصر في هذه الإحالة الناجحة على سبيل المثال، عدد الأشخاص الذين اشتركوا في نشرة إخبارية عبر البريد الإلكتروني أو إجمالي عدد السلع المبيعة. في حال عدم تحديد هذا الحقل لإحالات ناجحة ACTION، تُدرج "إعلانات شبكة البحث 360" تلقائيًا بقيمة 1000.
  • currencyCode: عملة أرباح المعاملة تبلغ الأرباح بشكل تلقائي من المفترض أن تكون بعملة المعلِن. في حال تحديد عملة مختلفة، ستُجري "إعلانات شبكة البحث 360" لتحويل مبلغ الأرباح المحدّد إلى عملة المعلِن. مزيد من المعلومات
    استخدِم معيار ISO 4217 الأبجدي (3 أحرف). لتحديد العملة.
    لا يسري إلا على الإحالات الناجحة التي تبلغ TRANSACTION.
  • 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"
  }]
}
          

Java

  /**
   * 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" ونحدد فقط معرِّف الكلمة الرئيسية مع بضعة حقول أخرى:

حقول مطلوبة

  • criterionId: هذا هو معرّف الكلمة الرئيسية. يمكنك الحصول على criterionId من خلال إضافة TrackerId. الماكرو لعناوين URL للصفحات المقصودة. لمزيد من المعلومات عن الحصول على أرقام تعريف الكلمات الرئيسية، يُرجى الاطّلاع على أرقام تعريف "إعلانات شبكة البحث 360" الإحالات الناجحة:
  • conversionId: بالنسبة إلى الإحالات الناجحة بلا إنترنت، يقدّم المعلِنون هذا المعرّف. يمكن للمعلنين تحديد أي معرّف ذي معنى بالنسبة لهم. يجب أن تحدد كل إحالة ناجحة في الطلب مُعرّفًا فريدًا، ويجب أن يكون الجمع بين المعرّف والطابع الزمني فريدًا بين جميع الإحالات الناجحة ضمن المعلِن. بالنسبة إلى الإحالات الناجحة على الإنترنت، تنسخ "إعلانات شبكة البحث 360" dsConversionId أو floodlightOrderId في هذا الموقع اعتمادًا على تعليمات Floodlight لدى المعلن.
  • conversionTimestamp: يشير إلى تاريخ ووقت حدث إحالة ناجحة. على سبيل المثال، إذا كانت قيمة يحدث التحويل في يوم الجمعة، 5 آب (أغسطس) 2016، 11:53:22 صباحًا بالتوقيت الصيفي الشرقي (GMT -4:00)، لتحديد الطابع الزمني بالمللي ثانية من الحقبة: 1470412402000.
  • segmentationType: تُحدِّد نوع نظام الإحالات الناجحة الذي يتمّ تحميله. التحويل إليه. لا تتوفّر حاليًا سوى الإحالات الناجحة في Floodlight، لذا لا تتوفّر في هذا الحقل مطلوبة دائمًا لتحديد FLOODLIGHT.
  • segmentationName: اسم نشاط Floodlight الذي يديره المعلِن التي تستخدمها للإبلاغ عن الإحالة الناجحة.

    إذا كان المعلن يحتوي على أنشطة بالاسم نفسه (يمكن أن يحدث ذلك إذا كانت الأنشطة الذين ينتمون إلى مجموعات Floodlight مختلفة)، فإن الإجراء المقترَح هو إعادة تسمية أحد الأنشطة.

    بدلاً من ذلك، إذا كنت تعرف رقم التعريف الذي حدّدته "إعلانات شبكة البحث 360" لنشاط Floodlight، يمكنك تحديد المعرّف في segmentationId بدلاً من تحديد الاسم في الحقل segmentationName. (يعيّن "مدير الحملة" أيضًا رقم تعريف لنشاط Floodlight، ولكن يختلف رقم تعريف "مدير الحملة" عن رقم تعريف "إعلانات شبكة البحث 360"، ولا يمكن استخدامه لتحديد المصدر conversions.) لعرض رقم تعريف "إعلانات شبكة البحث 360" لأحد أنشطة Floodlight، عليك تنزيل تقرير الإحالات الناجحة (إما من واجهة مستخدم "إعلانات شبكة البحث 360" أو التقارير API). إذا كانت قد نُسبت إحالة ناجحة واحدة على الأقل إلى نشاط Floodlight خلال الإطار الزمني للتقرير، سترى رقم تعريف "إعلانات شبكة البحث 360" في التقرير.

  • type: نوع الإحالة الناجحة، أي إما ACTION أو TRANSACTION. لا ترتبط الإحالة الناجحة ACTION بقيمة نقدية، بينما تحويل TRANSACTION فيه. تشمل الأمثلة عمليات الاشتراك في قوائم عناوين البريد الإلكتروني (ACTION) في مقابل عمليات الشراء في التجارة الإلكترونية (TRANSACTION).

    إذا حددت TRANSACTION، تحتاج أيضًا إلى تحديد الحقل التالي:

    • revenueMicros: القيمة النقدية للإحالة الناجحة

حقول اختيارية

  • quantityMillis: عدد العناصر في هذه الإحالة الناجحة على سبيل المثال، عدد الأشخاص الذين اشتركوا في نشرة إخبارية عبر البريد الإلكتروني أو إجمالي عدد السلع المبيعة. في حال عدم تحديد هذا الحقل لإحالات ناجحة ACTION، تُدرج "إعلانات شبكة البحث 360" تلقائيًا بقيمة 1000.
  • currencyCode: عملة أرباح المعاملة تبلغ الأرباح بشكل تلقائي من المفترض أن تكون بعملة المعلن. في حال تحديد عملة مختلفة، ستُجري "إعلانات شبكة البحث 360" لتحويل مبلغ الأرباح المحدّد إلى عملة المعلِن. مزيد من المعلومات
    استخدِم معيار ISO 4217 الأبجدي (3 أحرف). لتحديد العملة.
    لا يسري إلا على الإحالات الناجحة التي تبلغ TRANSACTION.
  • 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" : [{
    "criterionId": "43700003491981017", // 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"
  }]
}

Java

  /**
   * 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,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .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': [{
              'criterionId': '43700004289911004', // 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: رقم تعريف النقرة الحسّاس لحالة الأحرف المتعلّق بالزيارة. انظر في سجلات الويب للمعلِن لمعرّف النقرة أو إدراج الإحالات الناجحة واستخدام معرّف نقرة من إحالة ناجحة أخرى ستنسِب "إعلانات شبكة البحث 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 مختلفة)، فإن الإجراء المقترَح هو إعادة تسمية أحد الأنشطة.

    بدلاً من ذلك، إذا كنت تعرف رقم التعريف الذي حدّدته "إعلانات شبكة البحث 360" لنشاط Floodlight، يمكنك تحديد المعرّف في segmentationId بدلاً من تحديد الاسم في الحقل segmentationName. (يعيّن "مدير الحملة" أيضًا رقم تعريف لنشاط Floodlight، ولكن يختلف رقم تعريف "مدير الحملة" عن رقم تعريف "إعلانات شبكة البحث 360"، ولا يمكن استخدامه لتحديد المصدر conversions.) لعرض رقم تعريف "إعلانات شبكة البحث 360" لأحد أنشطة Floodlight، عليك تنزيل تقرير الإحالات الناجحة (إما من واجهة مستخدم "إعلانات شبكة البحث 360" أو التقارير API). إذا كانت قد نُسبت إحالة ناجحة واحدة على الأقل إلى نشاط Floodlight خلال الإطار الزمني للتقرير، سترى رقم تعريف "إعلانات شبكة البحث 360" في التقرير.

  • type: نوع الإحالة الناجحة، أي إما ACTION أو TRANSACTION. لا ترتبط الإحالة الناجحة ACTION بقيمة نقدية، بينما تحويل TRANSACTION فيه. تشمل الأمثلة عمليات الاشتراك في قوائم عناوين البريد الإلكتروني (ACTION) في مقابل عمليات الشراء في التجارة الإلكترونية (TRANSACTION).

    إذا حددت TRANSACTION، تحتاج أيضًا إلى تحديد الحقل التالي:

    • revenueMicros: القيمة النقدية للإحالة الناجحة

في حال تتبُّع أرباح الإحالات الناجحة، تأكّد من أنّ النموذج يوزّع الأرباح على مستوى كلٍّ من الأرباح نقطة اتصال في مسار الإحالة الناجحةعلى سبيل المثال، إذا كان نموذجك يستخدم منهجًا خطيًا (توزيع الأرباح بالتساوي على كل نقطة اتصال)، في مسار إحالة ناجحة يتضمن 3 نقرات على الإعلان، ستُنسب كل نقرة بنسبة 33% من الإحالة الناجحة. إذا كانت الإحالة الناجحة وحققت أرباحًا بقيمة 100 دولار أمريكي (أو ما يعادله بالعملة المحلية)، فتأكد من أن النموذج يوزع 33 دولارًا (أو ما يعادله بالعملة المحلية) من الأرباح على كل نقرة، وتأكَّد من أنّ قيمة revenueMicros تحدّد فقط 33 دولارًا أمريكيًا (أو ما يعادله بالعملة المحلية) من الأرباح لكل نقرة.

حقول اختيارية

  • quantityMillis: عدد العناصر في هذه الإحالة الناجحة على سبيل المثال، عدد الأشخاص الذين اشتركوا في نشرة إخبارية عبر البريد الإلكتروني أو إجمالي عدد السلع المبيعة. في حال عدم تحديد هذا الحقل لإحالات ناجحة ACTION، تُدرج "إعلانات شبكة البحث 360" تلقائيًا بقيمة 1000.
  • currencyCode: عملة أرباح المعاملة تبلغ الأرباح بشكل تلقائي من المفترض أن تكون بعملة المعلن. في حال تحديد عملة مختلفة، ستُجري "إعلانات شبكة البحث 360" لتحويل مبلغ الأرباح المحدّد إلى عملة المعلِن. مزيد من المعلومات
    استخدِم معيار ISO 4217 الأبجدي (3 أحرف). لتحديد العملة.
    لا يسري إلا على الإحالات الناجحة التي تبلغ TRANSACTION.
  • 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" الداخلية بالكامل. التمثيل لكل إحالة ناجحة تم تحميلها، مثل رقم تعريف الحملة ورقم تعريف المجموعة الإعلانية والكلمة الرئيسية (المعيار).

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

إذا لم ينجح الطلب

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

في ما يلي مثال على ردّ على طلب تعذّر إكماله بنجاح:

{
 "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، أو transactionFailed.

أخطاء requestالتحقق من الصحة

تشير أخطاء requestValidation إلى مشاكل في البيانات في تحميل الإحالة الناجحة. الطلب (على سبيل المثال، سبق تحميل الإحالة الناجحة، أو لم يتم العثور على معرّف النقرة). في هذه الدورة، نوع الخطأ، تحتوي الرسالة details على عنصرين:

  • رمز سداسي عشري يحدد نوع الخطأ. يمكنك استخدام الرمز في طلب البحث النصوص البرمجية لتحديد الأخطاء.
  • وصف لخطأ التحقق من الصحة.

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

أنواع أخرى من الأخطاء

أما جميع أنواع الأخطاء الأخرى (internalError، وtransactionتعذُّر، أو lateStageRequestError) إلى وجود مشكلة داخلية في إعلانات شبكة البحث 360.

الاستجابة لخطأ

في حال عدم نجاح الطلب، يمكنك محاولة إعادة إرسال استدعاء الطلب بأكمله لاحقًا. إعلانات شبكة البحث 360 سيتم الإبلاغ عن أخطاء requestValidation لأي إحالات ناجحة قد تم تحميله بالفعل، ولكنه سيحاول تحميل الإحالات الناجحة المتبقية.

في حال استمرار ظهور الأخطاء بعد إعادة الإرسال، راجِع تحديد المشاكل وحلّها للحصول على معلومات حول كيفية المتابعة.