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

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

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

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

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

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

  ملاحظة: لا تضبط عناوين الطلبات في طلب IngestionService. تتجاهل واجهة Data Manager API العناوين في طلب استيعاب البيانات.

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

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

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

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

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

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

• إعلانات Google
• مساحة العرض والفيديو 360
• إحصاءات Google
• Floodlight

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

• إعلانات Google
• مساحة العرض والفيديو 360
• مدير إعلانات Google
• إحصاءات Google
• Floodlight

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

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

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

إعلانات Google

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

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

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

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

حساب Google [e-mail] هو مستخدم في M1.

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

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

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

حساب Google [e-mail] هو مستخدم في M2.

حساب العميل C1

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

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

حساب Google [e-mail] هو مستخدم في 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 [e-mail]:

العرض

{
  "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 ‏([e-mail]):

العرض

{
  "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 ([e-mail])، وهو مستخدم في الحساب الإداري (M1) على "إعلانات Google":

العرض

{
  "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	رقم تعريف القياس لمصدر بيانات موقع إلكتروني معرّف تطبيق Firebase لمصدر بيانات التطبيق

إدارة الموارد

عناوين الطلبات
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 هو إعداد Floodlight، يجب عدم ضبط login_account أو ضبطه على القيم نفسها التي تم ضبط operating_account عليها. بخلاف ذلك، يتعذّر تنفيذ الطلب ويظهر الخطأ OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

العرض

الوجهة
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 للسيناريوهات الشائعة الخاصة بشريك بيانات يرسل البيانات إلى حسابات المعلِنين التي تم فيها إنشاء رابط شريك مع حساب شريك البيانات.

ملاحظة: في كل سيناريو من سيناريوهات شركاء البيانات، يجب أن تكون بيانات الاعتماد خاصة بحساب Google يملكه مستخدم في حساب شريك البيانات.

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

إعلانات Google

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

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

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

حساب Google [e-mail] هو مستخدم في D1.

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

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

حساب Google [e-mail] هو مستخدم في 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 [e-mail] لإرسال البيانات إلى حساب المدير M2 أو حساب العميل C1 أو حساب العميل C2، وذلك باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D1 وتم ضبط linked_account فيها على حساب المدير M2.

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

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

للتصرف كشريك بيانات D2، استخدِم بيانات اعتماد حساب Google [e-mail] لإرسال البيانات إلى حساب العميل C1، وذلك باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D2 وتم ضبط linked_account فيها على حساب العميل C1.

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

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

• تم ربط شريك البيانات D1 بحساب إداري على "إعلانات Google". في ما يلي مثال على سيناريو ربط حساب الشريك بحساب المدير.
• شريك البيانات 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 [e-mail]:

العرض

{
  "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 [e-mail]:

العرض

{
  "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

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

العرض

الوجهة
operating_account	account_id رقم تعريف ربط الجمهور لحساب "إدارة إعلانات Google" account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
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 لإرسال البيانات إلى حساب على "مدير إعلانات Google" باستخدام رابط شريك:

العرض

      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
      

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

إحصاءات 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 أيًّا ممّا يلي:

• حساب على "إعلانات Google"
• حساب مُعلِن على "مساحة العرض والفيديو 360"
• حساب شريك في "مساحة العرض والفيديو 360"
• حساب على "إدارة إعلانات Google"
• موقع على "إحصاءات Google"
• حساب خاص بشريك بيانات في حال إرسال البيانات إلى شريحة جمهور يملكها حساب شريك البيانات

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

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

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

تتحقّق واجهة Data Manager API مما يلي:

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

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

   • هذه السمة مماثلة للسمة operating_account. هذا هو الإعداد التلقائي في حال عدم ضبط login_account لعنصر Destination في طلب IngestionService، أو عدم ضبط العنوان login-account في طلب إدارة الموارد.

   • حساب مدير في "إعلانات Google" أو حساب شريك في "مساحة العرض والفيديو 360" يكون حسابًا رئيسيًا operating_account في طلب IngestionService، أو حسابًا رئيسيًا للحساب المستهدَف في طلب إدارة الموارد.

   • حساب شريك بيانات يتضمّن رابط شريك إلى linked_account في طلب IngestionService، أو العنوان linked-account في طلب إدارة موارد

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

ملاحظة: لا تحدّد حسابًا مرتبطًا إلا إذا كان حساب تسجيل الدخول account_typeمضبوطًا على DATA_PARTNER وكان العنصر الرئيسي الخاص بـ operating_account مرتبطًا بحساب شريك البيانات. إذا كان operating_account مرتبطًا مباشرةً بحساب شريك البيانات، لا تضبط linked_account.

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

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

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

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

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

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

واجهة مستخدم "إعلانات Google"

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

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

Data Manager API

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

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

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

واجهة مستخدم "إعلانات Google"

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

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

Google Ads API

للحصول على رقم تعريف إجراء الإحالة الناجحة من 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:

• في واجهة مستخدم "إحصاءات 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. تأكَّد من أنّ الحساب يتضمّن دور مستخدم لديه إذن إدراج الإحالات الناجحة غير الإلكترونية.