نوع التقرير: تحويل

بيانات الأحداث الأولية عن الإحالات الناجحة.

لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة Reports.request()).

بما أنّ الأحداث تقع في تواريخ محدّدة، يجب أن يحدّد طلب هذا التقرير timeRange. يمكنك تحديد أي مما يلي:

طلب مقتطف

أرسِل نص طلب Reports.request() عاديًا، ولكن حدِّد "reportType": "conversion". 

{
...
  "reportType": "conversion",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

لكل عمود تريد عرضه أو تصفيته في التقرير، حدِّد columnName المُدرَج في الجدول أدناه. ويمكنك أيضًا اختياريًا تحديد headerText وstartDate وendDate. تجدر الإشارة إلى أنه لا يمكن تصفية بعض الأعمدة؛ راجع "قابل للتصفية" في الجدول أدناه.

columnNameالوصفالسلوكالنوعقابل للفلترة
status حالة الإحالة الناجحة: Active أو Removed. سمة Status نعم
deviceSegment شريحة الجهاز التي تُنسب الإحالة الناجحة إليها: Desktop أو Mobile أو Tablet أو Other. سمة Device segment نعم
floodlightGroup اسم مجموعة Floodlight. سمة String نعم
floodlightGroupConversionType نوع الإحالات الناجحة الناتجة عن أنشطة Floodlight في هذه المجموعة: Action أو Transaction. سمة Conversion type نعم
floodlightGroupId رقم تعريف مجموعة Floodlight في DS سمة ID نعم
floodlightGroupTag علامة مجموعة Floodlight. سمة String نعم
floodlightActivity اسم نشاط Floodlight. سمة String نعم
floodlightActivityId رقم تعريف نشاط Floodlight في DS. سمة ID نعم
floodlightActivityTag علامة نشاط Floodlight. سمة String نعم
agency اسم الوكالة. سمة String نعم
agencyId رقم تعريف وكالة DS. سمة ID نعم
advertiser اسم المعلن. سمة String نعم
advertiserId الرقم التعريفي لمعلن DS. سمة ID نعم
account اسم حساب المحرِّك. سمة String نعم
accountId رقم تعريف حساب محرك DS. سمة ID نعم
accountEngineId رقم تعريف الحساب في حساب المحرك الخارجي. سمة String نعم
accountType نوع حساب المحرك: Google AdWords أو Bing Ads أو Yahoo Japan Listing Ads أو Yahoo Search Marketing أو Yahoo Gemini أو Baidu أو Comparison Shopping. سمة Engine type نعم
campaign اسم الحملة. سمة String نعم
campaignId رقم تعريف حملة DS. سمة ID نعم
campaignStatus حالة الحملة التي تحتوي على هذا العنصر. سمة Status نعم
adGroup اسم المجموعة الإعلانية. سمة String نعم
adGroupId رقم تعريف المجموعة الإعلانية في DS. سمة ID نعم
adGroupStatus حالة المجموعة الإعلانية التي تحتوي على هذا العنصر. سمة Status نعم
keywordId رقم تعريف الكلمة الرئيسية في DS. وتشير القيمة 0 إلى أن الكلمة الرئيسية غير منسوبة. سمة ID نعم
keywordMatchType نوع مطابقة الكلمة الرئيسية: Broad أو Exact أو Phrase أو Content. سمة Match type نعم
keywordText نص الكلمة الرئيسية. سمة String نعم
productTargetId رقم تعريف استهداف المنتج في DS. سمة ID نعم
productGroupId رقم تعريف مجموعة المنتجات المرتبط بهذه الإحالة الناجحة. الإحالات الناجحة من حملات التسوّق هي فقط التي تحتوي على أرقام تعريف مجموعات المنتجات. يجب عدم استخدام أرقام تعريف مجموعات المنتجات في الانضمام. سمة ID نعم
ad اسم الإعلان. سمة String نعم
adId رقم تعريف الإعلان في DS. وتشير القيمة 0 إلى عدم إسناد الإعلان. سمة ID نعم
isUnattributedAd يشير إلى ما إذا كانت المقاييس في هذا الصف غير قابلة للإحالة إلى إعلان محدّد. على سبيل المثال، يمكن أن يمنع إعلان ذو تنسيق غير متوافق أو عنوان URL غير صحيح لخادم النقر DS من إحالة المقاييس إلى إعلان. سمة Boolean نعم
inventoryAccountId رقم تعريف حساب مستودع DS الذي يحتوي على المنتج المرتبط بالإحالة الناجحة. تنشئ DS هذا المعرّف عند ربط حساب مستودع في DS. سمة ID نعم
productId رقم تعريف المنتج المرتبط بهذه الإحالة الناجحة. سمة String نعم
productCountry البلد (بتنسيق ISO 3166) المسجّل لخلاصة المستودع التي تحتوي على المنتج المرتبط بهذه الإحالة الناجحة. سمة String نعم
productLanguage لغة المنتج (ISO 639-1) المرتبطة بهذا التحويل. سمة String نعم
productStoreId المتجر في إعلان المستودع المحلي المرتبط بالإحالة الناجحة. ويجب أن يتطابق هذا المعرّف مع معرّفات المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. سمة String نعم
productChannel قناة بيع المنتج المرتبط بالإحالة الناجحة: Online أو Local. سمة Product channel نعم
conversionId رقم التعريف الذي تُنشئه "إعلانات شبكة البحث 360" لكل إحالة ناجحة. سمة ID نعم
advertiserConversionId وبالنسبة إلى الإحالات الناجحة خارج إطار الإنترنت، يكون هذا الرقم التعريفي مقدّمًا من المعلِنين. وفي حال لم يحدّد أحد المعلِنين هذا المعرّف، تُنشئ "إعلانات شبكة البحث 360" معرّفًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، يساوي هذا العمود عمود "رقم تعريف الإحالة الناجحة" أو عمود "رقم تعريف طلب Floodlight" وفقًا لتعليمات Floodlight المتعلّقة بالمعلن. سمة String نعم
conversionType نوع الإحالة الناجحة: Action أو Transaction. سمة Conversion type نعم
conversionRevenue المبلغ الإجمالي بالدولار من الإحالة الناجحة. سمة Money نعم
conversionQuantity كمية السلع التي سجّلتها الإحالة الناجحة على النحو الذي تحدّده المعلّمة qty. ويكون المعلن مسؤولاً عن تعبئة المعلّمة ديناميكيًا (مثل عدد العناصر التي تم بيعها في الإحالة الناجحة)، وإلا سيتم إعداده تلقائيًا على 1. سمة Number نعم
conversionDate التاريخ، في المنطقة الزمنية للشبكة في "مدير الحملة"، وقت حدوث الإحالة الناجحة. يُستخدَم هذا التاريخ لتجميع مقاييس الإحالات الناجحة. على سبيل المثال، عندما يُجمِّع DS الإجراءات ليوم 1 أيار (مايو)، يتم احتساب جميع الإحالات الناجحة للإجراءات التي يكون conversionDate فيها 1 أيار (مايو). سمة Date نعم
conversionTimestamp الطابع الزمني للتوقيت العالمي المتفق عليه عند حدوث الإحالة الناجحة. سمة Timestamp نعم
conversionLastModifiedTimestamp الطابع الزمني للتوقيت العالمي المنسق لآخر تعديل تم إجراؤه على الإحالة الناجحة. سمة Timestamp نعم
conversionAttributionType السبب في الإحالة الناجحة: Visit أو Keyword+Ad. سمة Conversion attribution type نعم
conversionVisitId رقم تعريف زيارة DS التي تُنسب الإحالة الناجحة إليها. سمة ID نعم
conversionVisitTimestamp الطابع الزمني للتوقيت العالمي المنسق للزيارة التي تُنسب الإحالة الناجحة إليها. سمة Timestamp نعم
conversionVisitExternalClickId سلسلة فريدة للزيارة التي تُنسب الإحالة الناجحة، يتم تمريرها إلى الصفحة المقصودة كمعلمة عنوان URL لـ gclid. هذه الميزة مفعَّلة فقط للمعلنين الذين لديهم دمج واجهة برمجة التطبيقات للإحالات الناجحة أو دمج "إحصاءات Google". سمة String نعم
conversionSearchTerm عبارة البحث التي أدت إلى التحويل. سمة String نعم
floodlightOriginalRevenue الأرباح الأصلية التي لم تتغيّر والمقترنة بحدث Floodlight (بعملة التقرير الحالي) قبل إجراء تعديلات على تعليمات Floodlight سمة Money نعم
floodlightEventRequestString سلسلة طلب Floodlight للإحالة الناجحة. سمة String نعم
floodlightReferrer الموقع الإلكتروني للإحالة الناجحة في Floodlight. سمة String نعم
floodlightOrderId رقم تعريف طلب Floodlight الذي يقدّمه المعلن لإجراء الإحالة الناجحة. سمة String نعم
feedItemId رقم تعريف صف عنصر الخلاصة المرتبط بهذه الإحالة الناجحة. سمة ID نعم
feedId رقم تعريف جدول الخلاصة المرتبط بهذه الإحالة الناجحة. سمة ID نعم
feedType نوع الخلاصة المرتبطة بهذه الإحالة الناجحة. سمة Feed type نعم