ضبط الوجهات والعناوين

يظهر كل من مفهوم Destination وعناوين طلبات البيانات بشكل متكرّر عند استخدام Data Manager API. اطّلِع على هذا الدليل لفهم كيفية ضبط الوجهات والعناوين في سيناريوهات مختلفة.

حالات استخدام وجهات أو عناوين

  • استخدِم Destination في طلبات الاستيعاب. يستخدم طلب نقل البيانات IngestionService لإضافة أعضاء إلى شريحة جمهور أو إزالتهم منها أو لإرسال أحداث. تحدّد قائمة destinations في IngestAudienceMembersRequest أو IngestEventsRequest ما يلي:

    1. الحساب الذي يتلقّى البيانات على سبيل المثال، حساب على "إعلانات Google" أو موقع على "إحصاءات Google".
    2. الكيان الوجهة للبيانات داخل الحساب، مثل إجراء إحالة ناجحة في "إعلانات Google" أو مصدر بيانات في "إحصاءات Google"
    3. تمثّل مسار الوصول إلى بيانات اعتماد الطلب في الحساب الذي يتلقّى البيانات.

    يمكنك تضمين وجهات متعددة في طلب الاستيعاب نفسه.

  • استخدِم عناوين الطلبات في طلبات إدارة الموارد التي تنشئ الموارد أو تعدّلها أو تحذفها أو تستردّها. تحدّد العناوين مسار الوصول إلى بيانات اعتماد الطلب في الحساب المستهدف لطلب إدارة الموارد. في ما يلي قائمة بالمراجع التي تتضمّن طرق إدارة الموارد التي تتوافق مع عناوين الطلبات:

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

الخطوة نوع الطلب عناوين الوجهة أو الطلب
إنشاء شريحة جمهور إدارة الموارد عناوين الطلبات
إضافة مستخدمين إلى شريحة جمهور العرض وجهات السفر
الاطّلاع على بيانات التشخيص العرض وجهات السفر
استرداد شريحة الجمهور إدارة الموارد عناوين الطلبات

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

إذا كنت معلنًا أو وكالة، انتقِل إلى سيناريوهات المعلِنين للاطّلاع على أمثلة حول كيفية ضبط العناوين وإنشاء Destination:

إذا كنت شريك بيانات، انتقِل إلى سيناريوهات شركاء البيانات للاطّلاع على أمثلة حول كيفية ضبط العناوين وإنشاء Destination لإدارة المراجع وإرسال البيانات إلى حساب يتضمّن رابط شريك إلى حساب شريك البيانات:

يتناول قسم المتطلبات التفصيلية المتطلبات وقواعد التحقّق من الصحة بالتفصيل.

سيناريوهات المعلِنين

في ما يلي كيفية ضبط Destination أو طلب عناوين للسيناريوهات الشائعة للمعلِنين والوكالات. يوضّح هذا المخطّط البياني كيف تستخدم واجهة برمجة التطبيقات Data Manager API بيانات الاعتماد وحقول Destination للوصول إلى حساب المعلِن.

مسار وصول المعلِن

إعلانات Google

في ما يلي رسم بياني يعرض مثالاً على مجموعة من حسابات "إعلانات Google" والمستخدِمين.

حسابات ومستخدمو "إعلانات Google"

الحساب الإداري M1

يتضمّن الحساب الإداري (M1) حسابَين فرعيَين مباشرَين:

  1. الحساب الإداري M2
  2. حساب العميل C1

حساب Google cloudysanfrancisco@gmail.com هو مستخدم في M1.

الحساب الإداري M2

يتضمّن الحساب الإداري (M2) حسابَين فرعيَّين مباشرَين:

  1. حساب العميل C1
  2. حساب العميل C2

حساب Google baklavainthebalkans@gmail.com هو مستخدم في M2.

حساب العميل C1

لدى الحساب C1 حسابان إداريان رئيسيان مباشران:

  1. الحساب الإداري M1
  2. الحساب الإداري M2

حساب Google jeffersonloveshiking@gmail.com هو مستخدم في C1.

حساب العميل C2

الحساب الإداري M2 هو الحساب الرئيسي المباشر الوحيد للحساب C2.

لا يمثّل أي من حسابات Google المُدرَجة مستخدمًا في C2.

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

سيناريو الوصول المباشر

إذا كنت تريد إرسال بيانات إلى حساب على "إعلانات Google" وكانت بيانات الاعتماد خاصة بحساب Google مستخدَم في حساب "إعلانات Google"، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id الرقم التعريفي للعميل الخاص بحساب "إعلانات Google"
account_type GOOGLE_ADS
login_account إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account لا تضبط الحقل linked_account.
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على سيناريو الوصول المباشر، باستخدام الحسابات من المخطط وبيانات الاعتماد الخاصة بحساب Google jeffersonloveshiking@gmail.com:

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account لا تضبط عنوان linked-account.

سيناريو وصول المدير

إذا أردت إرسال بيانات إلى حساب على "إعلانات Google" وكانت بيانات الاعتماد خاصة بحساب Google مستخدَم في حساب إداري على "إعلانات Google" حيث يكون حساب المعلِن حسابًا فرعيًا، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id الرقم التعريفي للعميل المتعلّق بحساب العميل على "إعلانات Google"
account_type GOOGLE_ADS
login_account
account_id رقم تعريف العميل الخاص بالحساب الإداري على "إعلانات Google"
account_type GOOGLE_ADS
linked_account لا تضبط الحقل linked_account.
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على سيناريو وصول إداري إلى حساب عميل (C2) على "إعلانات Google" من المخطّط وبيانات اعتماد حساب Google ‏(baklavainthebalkans@gmail.com):

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال آخر على سيناريو وصول إداري إلى حساب عميل على "إعلانات Google" (C2) وبيانات اعتماد لحساب Google‏ (cloudysanfrancisco@gmail.com)، وهو مستخدم في الحساب الإداري على "إعلانات Google" (M1):

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account لا تضبط عنوان linked-account.

مساحة العرض والفيديو 360

يمكنك إرسال البيانات إلى "مساحة العرض والفيديو 360" باتّباع طريقتَين:

  1. الوصول المباشر، حيث تكون بيانات الاعتماد خاصة بحساب Google يمثّل مستخدمًا في حساب المعلِن أو الشريك على "مساحة العرض والفيديو 360 ".
  2. إذن وصول الشريك إلى "مساحة العرض والفيديو 360"، حيث تكون بيانات الاعتماد خاصة بحساب Google وهو حساب مستخدم في حساب الشريك على "مساحة العرض والفيديو 360"، ويكون الحساب التشغيلي هو حساب معلِن على "مساحة العرض والفيديو 360" ضِمن حساب الشريك

سيناريوهات الوصول المباشر

إذا كنت تريد إرسال بيانات إلى حساب معلِن على "مساحة العرض والفيديو 360" وكانت بيانات الاعتماد خاصة بحساب Google تابع لمستخدم في حساب المعلِن، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_ADVERTISER
login_account إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account لا تضبط الحقل linked_account.
product_destination_id معرّف شريحة الجمهور.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على Destination لسيناريو الوصول المباشر لإرسال البيانات إلى معلِن على "مساحة العرض والفيديو 360 ":

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account لا تضبط عنوان linked-account.

وبالمثل، إذا أردت إرسال بيانات إلى حساب شريك في "مساحة العرض والفيديو 360" وكانت بيانات الاعتماد الخاصة بك لحساب Google مستخدَم في حساب الشريك، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_PARTNER
login_account إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account لا تضبط الحقل linked_account.
product_destination_id معرّف شريحة الجمهور.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لسيناريو الوصول المباشر لإرسال البيانات إلى شريك في "مساحة العرض والفيديو 360 ":

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account لا تضبط عنوان linked-account.

سيناريو وصول الشريك إلى "مساحة العرض والفيديو 360"

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 360"، وكانت بيانات الاعتماد خاصة بحساب Google تابع لحساب شريك رئيسي تابع للمعلِن على "مساحة العرض والفيديو 360 "، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_PARTNER
linked_account لا تضبط الحقل linked_account.
product_destination_id معرّف شريحة الجمهور.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على Destination لسيناريو وصول الشريك إلى البيانات بهدف إرسالها إلى أحد المعلِنين على "مساحة العرض والفيديو 360 ". في هذه الحالة، يجب أن تكون بيانات الاعتماد خاصة بحساب Google تابع لمستخدم في حساب الشريك على "مساحة العرض والفيديو 360" DISPLAY_VIDEO_PARTNER_ID، ويجب أن يكون حساب المعلِن على "مساحة العرض والفيديو 360" DISPLAY_VIDEO_ADVERTISER_ID حسابًا فرعيًا تابعًا لحساب الشريك DISPLAY_VIDEO_PARTNER_ID.

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account لا تضبط العنوان linked-account.

إحصاءات Google

ملاحظة: إذا كان operating_account هو حساب على "إحصاءات Google"، لا تضبط login_account أو اضبطه على القيم نفسها التي تم ضبط operating_account عليها. وفي حال عدم توفّرها، يتعذّر تنفيذ الطلب ويظهر الخطأ OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

العرض
الوجهة
operating_account
account_id معرّف الموقع على "إحصاءات Google"
account_type GOOGLE_ANALYTICS_PROPERTY
login_account إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account لا تضبط الحقل linked_account.
product_destination_id
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على Destination لإرسال الأحداث إلى "إحصاءات Google":

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account لا تضبط عنوان linked-account.

Floodlight

العرض
الوجهة
operating_account
account_id رقم تعريف إعدادات Floodlight
إذا كان المعلِن فرعًا من معلِن رئيسي، استخدِم رقم تعريف المعلِن الرئيسي في "مدير الحملة 360" كرقم تعريف إعدادات Floodlight. بخلاف ذلك، استخدِم رقم تعريف المعلِن. كيفية العثور على الرقم التعريفي للمعلِن في واجهة مستخدم "مدير الحملة 360"
account_type FLOODLIGHT_CONFIG
login_account إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account لا تضبط الحقل linked_account.
product_destination_id رقم تعريف نشاط Floodlight

في ما يلي مثال على Destination لإرسال الأحداث إلى Floodlight:

العرض
        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }

سيناريوهات شركاء البيانات

في ما يلي كيفية إعداد Destination للسيناريوهات الشائعة الخاصة بشريك بيانات يرسل البيانات إلى حسابات المعلِنين التي تم فيها إنشاء رابط شريك مع حساب شريك البيانات.

يوضّح هذا المخطّط البياني كيف تستخدم Data Manager API الحقلَين credentials وDestination للوصول إلى حساب المعلِن من خلال رابط شريك.

مسار وصول شريك البيانات

إعلانات Google

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

شركاء البيانات وحسابات "إعلانات Google" والمستخدمون

شريك البيانات D1

يتوفّر رابط شريك بين الحساب D1 والحساب الإداري M2 على "إعلانات Google".

حساب Google 222larabrown@gmail.com هو مستخدم في D1.

شريك البيانات D2

يتوفّر رابط شريك بين الحساب D2 وحساب العميل C1 على "إعلانات Google".

حساب Google jeffersonloveshiking@gmail.com هو مستخدم في D2.

الحساب الإداري M1

يتضمّن الحساب الإداري (M1) حسابَين فرعيَين مباشرَين:

  1. الحساب الإداري M2
  2. حساب العميل C1
الحساب الإداري M2

يتضمّن الحساب الإداري (M2) حسابَين فرعيَّين مباشرَين:

  1. حساب العميل C1
  2. حساب العميل C2
حساب العميل C1

لدى الحساب C1 حسابان إداريان رئيسيان مباشران:

  1. الحساب الإداري M1
  2. الحساب الإداري M2
حساب العميل C2

الحساب الإداري M2 هو الحساب الرئيسي المباشر الوحيد للحساب C2.

في ما يلي الإجراءات التي يمكنك اتّخاذها باستخدام هذه المجموعة من الحسابات:

العمل بصفتك شريك بيانات D1

للتصرف كشريك بيانات D1، استخدِم بيانات اعتماد حساب Google 222larabrown@gmail.com لإرسال البيانات إلى حساب المدير M2 أو حساب العميل C1 أو حساب العميل C2، وذلك باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D1 وتم ضبط linked_account فيها على حساب المدير M2.

بصفتك شريك بيانات D1، لا يمكنك إرسال بيانات إلى الحساب الإداري M1 لأنّه لا يوجد ربط بين D1 وM1.

تولّي دور شريك البيانات D2

للتصرف كشريك بيانات D2، استخدِم بيانات اعتماد حساب Google jeffersonloveshiking@gmail.com لإرسال البيانات إلى حساب العميل C1، وذلك باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D2 وتم ضبط linked_account فيها على حساب العميل C1.

بصفتك شريك بيانات D2، لا يمكنك إرسال بيانات إلى الحساب الإداري M1 أو الحساب الإداري M2 أو حساب العميل C2 لأنّه لا يوجد ربط بين الشركاء بين D2 وأي من هذه الحسابات أو حساباتها الإدارية الرئيسية.

الاختلاف الرئيسي بين شركاء البيانات D1 وD2 هو طريقة ربط شريك البيانات بحسابات "إعلانات Google".

سيناريو الربط المباشر بحساب شريك

إذا أردت إرسال البيانات إلى حساب على "إعلانات Google" وكان رابط الشريك بين حساب "إعلانات Google" وحساب شريك البيانات:

العرض
الوجهة
operating_account
account_id الرقم التعريفي للعميل الخاص بحساب "إعلانات Google"
account_type GOOGLE_ADS
login_account
account_id رقم تعريف العميل لحساب شريك البيانات
account_type DATA_PARTNER
linked_account لا تضبط الحقل linked_account.
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على سيناريو ربط مباشر مع شريك باستخدام حسابات من المخطّط، وعناوين الطلبات المقابلة لطلبات إدارة الموارد. في هذا السيناريو، يرسل شريك البيانات D2 بيانات أحد أفراد شريحة الجمهور إلى العميل C1 في "إعلانات Google" باستخدام رابط الشريك بين D2 وC1، بالإضافة إلى بيانات اعتماد حساب Google jeffersonloveshiking@gmail.com:

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account لا تضبط عنوان linked-account.

سيناريو ربط حساب إداري بحساب شريك

إذا أردت إرسال البيانات إلى حساب على "إعلانات Google" وكان رابط الشريك بين حساب إداري رئيسي على "إعلانات Google" وحساب شريك البيانات:

العرض
الوجهة
operating_account
account_id الرقم التعريفي للعميل المتعلّق بحساب العميل على "إعلانات Google"
account_type GOOGLE_ADS
login_account
account_id رقم تعريف العميل لحساب شريك البيانات
account_type DATA_PARTNER
linked_account
account_id رقم تعريف العميل الخاص بالحساب الإداري على "إعلانات Google"
account_type GOOGLE_ADS
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

في ما يلي مثال على سيناريو ربط حساب شريك إداري باستخدام حسابات من المخطّط. في هذا السيناريو، يرسل شريك البيانات D1 بيانات أعضاء الجمهور إلى العميل C2 في "إعلانات Google" باستخدام رابط الشريك بين D1 وM2، وبيانات اعتماد حساب Google 222larabrown@gmail.com:

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

مساحة العرض والفيديو 360

بصفتك شريك بيانات، يمكنك إرسال البيانات إلى حساب على "مساحة العرض والفيديو 360" باستخدام طريقتَين:

  1. استخدِم رابط شريك مباشر بين حساب شريك بيانات وحساب شريك أو حساب معلِن على "مساحة العرض والفيديو 360".
  2. إرسال البيانات إلى أحد المعلِنين على "مساحة العرض والفيديو 360" باستخدام رابط شريك بين حساب شريك بيانات وحساب شريك "مساحة العرض والفيديو 360" الرئيسي الخاص بالمعلِن

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 360" وكان رابط الشريك بين حساب المعلِن على "مساحة العرض والفيديو 360" وحساب شريك البيانات الخاص بك، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id رقم تعريف العميل لحساب شريك البيانات
account_type DATA_PARTNER
linked_account لا تضبط الحقل linked_account.
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على Destination لسيناريو ربط مباشر بحساب شريك لإرسال البيانات إلى معلِن على "مساحة العرض والفيديو 360 "، وعناوين الطلبات المقابلة لطلبات إدارة الموارد:

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account لا تضبط العنوان linked-account.

إذا كنت تريد إرسال بيانات إلى حساب شريك على "مساحة العرض والفيديو 360"، يجب أن يكون لديك رابط شريك بين حساب الشريك على "مساحة العرض والفيديو 360" وحساب شريك البيانات.

العرض
الوجهة
operating_account
account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id رقم تعريف العميل لحساب شريك البيانات
account_type DATA_PARTNER
linked_account لا تضبط الحقل linked_account.
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account لا تضبط عنوان linked-account.

في ما يلي مثال على Destination لسيناريو ربط مباشر بالشريك لإرسال بيانات إلى شريك "مساحة العرض والفيديو 360 "، وعناوين الطلبات المقابلة لطلبات إدارة الموارد:

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account لا تضبط عنوان linked-account.

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 360"، وكان رابط الشريك إلى حساب شريك البيانات الخاص بك مرتبطًا بحساب شريك على "مساحة العرض والفيديو 360" حيث يكون حساب المعلِن حسابًا فرعيًا، اتّبِع الخطوات التالية:

العرض
الوجهة
operating_account
account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id رقم تعريف العميل لحساب شريك البيانات
account_type DATA_PARTNER
linked_account
account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360"
account_type DISPLAY_VIDEO_PARTNER
product_destination_id رقم تعريف الجمهور أو إجراء الإحالة الناجحة.
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

في ما يلي مثال على Destination لسيناريو ربط الشريك بهدف إرسال البيانات إلى معلِن على "مساحة العرض والفيديو 360 " باستخدام رابط شريك بين شريك البيانات وشريك "مساحة العرض والفيديو 360 " الرئيسي الخاص بالمعلِن:

العرض
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
إدارة الموارد
عناوين الطلبات
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

إحصاءات Google

لا تتيح Data Manager API إرسال البيانات إلى حساب على "إحصاءات Google" باستخدام رابط شريك. استخدِم نهج سيناريوهات المعلِنين في "إحصاءات Google" بدلاً من ذلك.

Floodlight

لا تتيح Data Manager API إرسال البيانات إلى إعدادات Floodlight باستخدام رابط شريك. استخدِم بدلاً من ذلك نهج سيناريوهات المعلِن في Floodlight.

المتطلبات التفصيلية

يحتوي هذا القسم على متطلبات تفصيلية لحقول الحساب الخاصة Destination لطلب IngestionService، وعناوين الطلبات المكافئة لطلبات إدارة الموارد، ونصائح حول كيفية ضبط product_destination_id، وكيفية تحديد الأماكن التي يمكن أن تصل إليها بيانات الاعتماد.

حقول الحساب

يمكن أن يتضمّن Destination ما يصل إلى 3 حسابات مختلفة:

operating_account

operating_account مطلوب.

يشير operating_account إلى الحساب الذي يتلقّى البيانات في الطلب. يمكن أن يكون operating_account أيًّا ممّا يلي:

لا يتوفّر عنوان طلب يتوافق مع الحقل operating_account في Destination. عند إرسال طلب إدارة موارد، يكون الحساب المستهدف هو حساب التشغيل.

الحقل login_account وعنوان الطلب login-account

لا يكون login_account مطلوبًا دائمًا، ويتم ضبطه تلقائيًا على operating_account في طلب IngestionService، وعلى الحساب المستهدف في طلب إدارة الموارد. في طلب إدارة الموارد، استخدِم عنوان الطلب login-account لتحديد حساب تسجيل الدخول.

تتحقّق Data Manager API مما يلي:

  1. حساب Google الذي تتضمّنه بيانات الاعتماد هو حساب مستخدم في حساب تسجيل الدخول.

  2. حساب تسجيل الدخول هو أحد الحسابات التالية:

الحقل linked_account وعنوان الطلب linked-account

يشير الرمز linked_account إلى الحساب الذي يتضمّن رابط شريك إلى login_account في طلب IngestionService أو الحساب المستهدف في طلب إدارة الموارد.

معرّف وجهة المنتج

يحدّد product_destination_id الخاص بـ Destination الكائن الذي يتلقّى البيانات في operating_account. على سبيل المثال، يمكن أن يكون هذا المعرّف معرّف مستخدمين في "إعلانات Google" أو "مساحة العرض والفيديو 360"، أو معرّف إجراء إحالة ناجحة في "إعلانات Google"، أو رقم تعريف القياس لمصدر بيانات في "إحصاءات Google".

في ما يلي كيفية العثور على المعرّف لكل نوع من وجهات المنتجات.

شريحة جمهور في "إعلانات Google"

معرّف وجهة المنتج الذي يتم استخدامه لإدخال أفراد الجمهور هو معرّف الجمهور. يمكنك استرداد هذا المعرّف باستخدام واجهة مستخدم "إعلانات Google" أو Data Manager API.

للحصول على معرّف شريحة الجمهور من واجهة مستخدم "إعلانات Google"، اتّبِع الخطوات التالية:

  1. انتقِل إلى مدير الجمهور في واجهة مستخدم "إعلانات Google".
  2. انقر على اسم شريحة الجمهور لعرض التفاصيل.
  3. يظهر رقم تعريف الجمهور بجانب رقم تعريف القائمة.

Data Manager API

استرجِع UserList باستخدام طريقة List، مع توفير عناوين طلب إذا لزم الأمر، واستخدِم id الخاص بـ UserList لمعرّف وجهة المنتج.

حدث "إعلانات Google"

معرّف وجهة المنتج الذي يتمّ استيعاب الأحداث فيه هو معرّف إجراء الإحالة الناجحة.

للحصول على رقم تعريف إجراء الإحالة الناجحة من واجهة مستخدم "إعلانات Google"، اتّبِع الخطوات التالية:

  1. انتقِل إلى الإحالات الناجحة في واجهة مستخدم "إعلانات Google".
  2. انقر على اسم إجراء الإحالة الناجحة لعرض التفاصيل.

  3. معرّف إجراء الإحالة الناجحة هو قيمة مَعلمة طلب البحث في عنوان URL التي تحمل الاسم ctId.

      https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...

للحصول على رقم تعريف إجراء الإحالة الناجحة من Google Ads API، اتّبِع الخطوات التالية:

  1. أرسِل طلب Search أو SearchStream إلى GoogleAdsService باستخدام طلب البحث التالي:

      SELECT
    conversion_action.id,
    conversion_action.name
  FROM conversion_action
  WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'

  2. احصل على رقم تعريف إجراء الإحالة الناجحة من الحقل id في conversion_action في الردّ.

      [
    {
      "results": [
        {
          "conversionAction": {
            "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
            "id": "CONVERSION_ACTION_ID",
            "name": "CONVERSION_ACTION_NAME"
          }
        }
      ]
    }
  ]

شريحة جمهور "مساحة العرض والفيديو 360"

معرّف وجهة المنتج الذي يتم استخدامه لإدخال أفراد الجمهور هو معرّف الجمهور. يمكنك استرداد رقم التعريف هذا باستخدام واجهة مستخدم "مساحة العرض والفيديو 360" أو Data Manager API.

واجهة مستخدم "مساحة العرض والفيديو 360"

للحصول على رقم تعريف شريحة الجمهور من واجهة مستخدم "مساحة العرض والفيديو 360"، اتّبِع الخطوات التالية:

  1. سجِّل الدخول إلى واجهة مستخدم "مساحة العرض والفيديو 360" على https://displayvideo.google.com.
  2. انتقِل إلى الشريك أو المعلِن على "مساحة العرض والفيديو 360" الذي تستخدمه في operating_account.
  3. انتقِل إلى شرائح الجمهور في القائمة اليمنى، ثمّ اختَر كل شرائح الجمهور.
  4. ابحث عن الجمهور في القائمة. معرّف الجمهور هو الرقم بجانب الاسم في عمود الاسم.

Data Manager API

استرجِع UserList باستخدام طريقة List، مع توفير عناوين الطلبات إذا لزم الأمر، واستخدِم id الخاص بـ UserList لمعرّف وجهة المنتج.

حدث "إحصاءات Google"

يعتمد معرّف وجهة المنتج على نوع مصدر البيانات.

مصدر بيانات الويب
استخدِم رقم تعريف القياس لمصدر البيانات.
مصدر بيانات التطبيق

استخدِم معرّف التطبيق في Firebase لمصدر البيانات. في ما يلي خياران للعثور على معرّف التطبيق في Firebase:

حدث Floodlight

رقم تعريف وجهة المنتج الذي يتم استيعاب الأحداث فيه إلى Floodlight هو رقم تعريف نشاط Floodlight. يمكنك استرداد رقم التعريف هذا باستخدام واجهة مستخدم "مدير الحملة 360" أو واجهة برمجة التطبيقات Campaign Manager 360 API.

واجهة مستخدم "مدير الحملة 360"

للحصول على رقم تعريف نشاط Floodlight من واجهة مستخدم "مدير الحملة 360"، اتّبِع الخطوات التالية:

  1. سجِّل الدخول إلى واجهة مستخدم "مدير الحملة 360".
  2. انتقِل إلى حساب المعلِن في "مدير الحملة 360" الذي تستخدمه في operating_account.
  3. انتقِل إلى Floodlight في القائمة اليمنى، ثمّ اختَر الأنشطة.
  4. ابحث عن نشاط Floodlight في القائمة. رقم التعريف هو الرقم الموجود بجانب الاسم في عمود اسم النشاط.

Campaign Manager 360 API

للحصول على رقم تعريف نشاط Floodlight من Campaign Manager 360 API، اتّبِع الخطوات التالية:

  1. أرسِل طلب list إلى المورد floodlightActivities.
  2. حدِّد floodlightConfigurationId لإعدادات Floodlight.
  3. يمكنك اختياريًا استخدام المَعلمة searchString للفلترة حسب اسم النشاط.
  4. احصل على رقم تعريف نشاط Floodlight من الحقل id الخاص بـ FloodlightActivity المحدّد في الردّ.

تحديد الأماكن التي يمكن فيها استخدام بيانات الاعتماد

إنّ بيانات الاعتماد التي تستخدمها لتفويض طلب بيانات من واجهة برمجة التطبيقات Data Manager API مرتبطة بحساب Google معيّن.

  • في حال استخدام بيانات اعتماد المستخدم، يتم تفويض الطلبات بصفتها حساب Google الخاص بالمستخدم الذي منح الإذن بالتصرّف نيابةً عنه عند إنشاء بيانات الاعتماد.
  • في حال استخدام بيانات اعتماد حساب الخدمة، يتم تفويض الطلبات بصفتها حساب Google الخاص بحساب الخدمة.

في ما يلي كيفية التأكّد من أنّ حساب Google المرتبط ببيانات الاعتماد لديه إذن وصول إلى حساب على "إعلانات Google" أو "مساحة العرض والفيديو 360" أو "إحصاءات Google" أو "مدير الحملة 360".

"إعلانات Google" أو شريك البيانات

  1. انتقِل إلى الوصول والأمان في واجهة مستخدم "إعلانات Google" الخاصة بـ login_account.
  2. انقر على علامة التبويب المستخدمون.
  3. إذا كان login_account حسابًا إداريًا على "إعلانات Google"، أوقِف مفتاح التبديل عرض المستخدمين في التدرّج الهرمي الكامل لإخفاء المستخدمين من الحسابات الفرعية.
  4. تأكَّد من أنّ حساب Google الذي تستخدمه في بيانات الاعتماد يظهر في قائمة الحسابات ضمن علامة التبويب المستخدمون.

مساحة العرض والفيديو 360

  1. انتقِل إلى إدارة المستخدم وإعدادات البريد الإلكتروني في واجهة مستخدم "مساحة العرض والفيديو 360".
  2. تأكَّد من أنّ إدارة المستخدمين توضّح أنّ حساب Google الذي تستخدمه في بيانات الاعتماد هو حساب مستخدم على login_account.

إحصاءات Google

  1. انتقِل إلى إدارة أذونات الوصول إلى الموقع في واجهة مستخدم "إحصاءات Google".
  2. تأكَّد من اختيار موقع على "إحصاءات Google" المحدّد في login_account.
  3. تأكَّد من أنّ حساب Google الذي تستخدمه لبيانات الاعتماد لديه دور المحرِّر أو المشرف في الموقع.

‫Floodlight (مدير الحملة 360)

  1. سجِّل الدخول إلى واجهة مستخدم "مدير الحملة 360".
  2. انتقِل إلى المشرف > الملفات الشخصية للمستخدمين في القائمة اليمنى.
  3. تأكَّد من أنّ حساب Google الخاص ببيانات الاعتماد يظهر في قائمة الملفات الشخصية.
  4. انقر على الملف الشخصي وتأكَّد من أنّه لديه إذن الوصول إلى حساب المعلِن المستخدَم كـ login_account. إذا لم تضبط login_account في الطلب، سيتم ضبط القيمة التلقائية على operating_account. تأكَّد من أنّ الحساب يتضمّن دور مستخدم لديه إذن إدراج الإحالات الناجحة غير الإلكترونية.
التالي
تنسيق بيانات المستخدمين