أساسيات إعداد تقارير الإحالات الناجحة

يوضّح هذا الدليل كيفية استخدام وظيفة إعداد تقارير الإحالات الناجحة في Google Analytics Data API v1. تتيح لك هذه الميزة إنشاء تقارير تركّز على أحداث الإحالات الناجحة مع إمكانية استخدام نماذج تحديد المصدر المختلفة. تشبه تقارير الإحالات الناجحة التي يتم إنشاؤها باستخدام Data API تقارير تحديد المصدر التي يمكنك العثور عليها في قسم الإعلانات > الإحالات الناجحة في واجهة مستخدم "إحصاءات Google". لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة تقرير أداء الإحالات الناجحة.

الغرض من إعداد تقارير الإحالات الناجحة

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

الإحالات الناجحة مقابل التقارير المستندة إلى الأحداث

  • التقارير المستندة إلى الأحداث: تقدّم هذه التقارير أعدادًا أولية للأحداث (مثل eventCount) وتكون مفيدة لفهم النشاط العام على موقعك.
  • تقارير الإحالات الناجحة: تركّز هذه التقارير على الأحداث التي تم وضع علامة عليها باعتبارها إحالات ناجحة. تستخدِم هذه التقارير مكوّنات ومقاييس معيّنة (اطّلِع على مخطط تقارير الإحالات الناجحة) وتتيح لك الاطّلاع على البيانات التي تم تحديد مصدرها استنادًا إلى نماذج مثل "تحديد المصدر بالاستناد إلى البيانات" أو "النقرة الأخيرة".

تفعيل تقارير الإحالات الناجحة

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

يحتوي العنصر conversionSpec على الحقول التالية:

  • conversionActions: قائمة بأسماء موارد إجراءات الإحالات الناجحة التي سيتم تضمينها في التقرير (مثل ["conversionActions/12345"]). إذا كانت هذه القائمة فارغة، يتم تضمين جميع الإحالات الناجحة. يمكن استرداد معرّفات إجراءات الإحالات الناجحة الصالحة من حقل conversion_action ضِمن قائمة conversions في ردّ طريقة GetMetadata.
  • attributionModel: نموذج تحديد المصدر الذي سيتم استخدامه. القيمتان المتاحتان هما DATA_DRIVEN (القيمة التلقائية) وLAST_CLICK.

إنشاء تقرير إحالات ناجحة

في ما يلي نموذج طلب باستخدام الـ runReport method لإنشاء تقرير إحالات ناجحة يعرض الإحالات الناجحة حسب اسم الحملة باستخدام نموذج تحديد المصدر بالاستناد إلى البيانات.

HTTP

الفتح في مستكشف واجهات برمجة التطبيقات 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

مثال: إعادة إنشاء تقرير أداء الإحالات الناجحة

يوضّح هذا المثال كيفية استرداد إجراءات الإحالات الناجحة المتاحة لموقع أولاً، ثم استخدامها لإنشاء تقرير مشابه لتقرير أداء الإحالات الناجحة المعروض في واجهة مستخدم "إحصاءات Google" ضِمن الإعلانات > الإحالات الناجحة > أداء الإحالات الناجحة.

الخطوة 1: استرداد إجراءات الإحالات الناجحة

استخدِم طريقة getMetadata للعثور على معرّفات إجراءات الإحالات الناجحة الصالحة لموقعك. احرص على تحديد رقم تعريف موقع "إحصاءات Google" (بدلاً من استخدام 0 للحصول على الحقول الشائعة لجميع المواقع) للاطّلاع على إجراءات الإحالات الناجحة التي تم إنشاؤها لموقعك.

يحتوي الردّ على قائمة conversions تتضمّن إجراءات الإحالات الناجحة المتاحة:

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

الخطوة 2: تشغيل التقرير

استخدِم طريقة runReport. استخدِم معرّفات إجراءات الإحالات الناجحة التي تم العثور عليها في الخطوة 1 لفلترة تقريرك، أو اترك conversionActions فارغًا لإعداد تقرير عن جميع الإحالات الناجحة. يعيد هذا الطلب إنشاء تقرير واجهة مستخدم "أداء الإحالات الناجحة" من خلال عرض النقرات على الإعلانات وتكلفة الإعلان وتكلفة الإعلان لكل نقرة وتكلفة الإعلان لكل الإحالات الناجحة وظهور الإعلانات وعائد الإنفاق الإعلاني وإجمالي الإيرادات وكل الإحالات الناجحة حسب مجموعة القنوات التلقائية.

HTTP

الفتح في مستكشف واجهات برمجة التطبيقات 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "defaultChannelGroup"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdCost"
        },
        {
            "name": "advertiserAdCostPerAllConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdImpressions"
        },
        {
            "name": "advertiserAdClicks"
        },
        {
            "name": "advertiserAdCostPerClick"
        },
        {
            "name": "totalRevenueByInteractionDate"
        },
        {
            "name": "returnOnAdSpendByInteractionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [
            "conversionActions/12345"
        ],
        "attributionModel": "DATA_DRIVEN"
    }
}

في ما يلي نموذج ردّ على هذا الطلب:

{
  "dimensionHeaders": [
    {
      "name": "defaultChannelGroup"
    }
  ],
  "metricHeaders": [
    {
      "name": "allConversionsByInteractionDate",
      "type": "TYPE_FLOAT"
    },
    {
      "name": "advertiserAdCost",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdCostPerAllConversionsByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdImpressions",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdClicks",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdCostPerClick",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "totalRevenueByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "returnOnAdSpendByInteractionDate",
      "type": "TYPE_FLOAT"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Paid Search"
        }
      ],
      "metricValues": [
        {
          "value": "75.2"
        },
        {
          "value": "500"
        },
        {
          "value": "6.65"
        },
        {
          "value": "10000"
        },
        {
          "value": "500"
        },
        {
          "value": "1"
        },
        {
          "value": "1500"
        },
        {
          "value": "3"
        }
      ]
    }
  ],
  "rowCount": 1,
  "metadata": {
    "schemaRestrictionResponse": {},
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles",
    "section": "SECTION_ADVERTISING"
  },
  "kind": "analyticsData#runReport"
}

يمكنك التأكّد من أنّ الردّ تم التعامل معه على أنّه تقرير إحالات ناجحة من خلال التحقّق من أنّ حقل metadata.section في الردّ تم ضبطه على SECTION_ADVERTISING.

للاطّلاع على قائمة كاملة بالمكوّنات والمقاييس المتاحة لتقارير الإحالات الناجحة، يُرجى الرجوع إلى مخطط تقارير الإحالات الناجحة.