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

يظهر كل من مفهوم 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.

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

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

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

إذا أردت إرسال البيانات إلى حساب على "إعلانات 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.

في ما يلي مثال على سيناريو وصول المدير لحساب عميل "إعلانات Google" C2 من المخطّط البياني وبيانات اعتماد حساب 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 لبيانات الاعتماد وحقول Destination للوصول إلى حساب المعلِن من خلال رابط شريك.

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

إعلانات Google

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

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

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

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

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

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

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

حساب 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 لإجراء ما يلي:

  • أرسِل البيانات إلى حساب العميل C1 أو حساب العميل C2 باستخدام وجهة تم فيها ضبط login_account على حساب شريك البيانات D1 وlinked_account على حساب المدير M2.

  • أرسِل البيانات إلى حساب المدير M2 مباشرةً باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D1. عدم ضبط linked_account.

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

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

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

بصفتك شريك البيانات 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

إذا أردت إرسال البيانات إلى حساب على "إدارة إعلانات 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 أيًّا ممّا يلي:

لا يتوفّر عنوان طلب يتوافق مع الحقل 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" أو Google Ads API.

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

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

للحصول على معرّف إجراء الإحالة الناجحة من 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 باستخدام طريقة القائمة، مع توفير عناوين الطلبات إذا لزم الأمر، واستخدام id UserList لمعرّف وجهة المنتج.

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

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

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

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

حدث Floodlight

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

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