ضبط الوجهات

يحدّد كل Destination في IngestAudienceMembersRequest أو IngestEventsRequest ما يلي:

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

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

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

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

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

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

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

في ما يلي كيفية إعداد Destination للسيناريوهات الشائعة للمعلِنين والوكالات. يوضّح هذا الرسم البياني كيف تستخدم واجهة برمجة التطبيقات "إدارة بيانات إعلانات Google" بيانات الاعتماد والحقول 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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

في ما يلي مثال على سيناريو الوصول المباشر، باستخدام الحسابات الواردة في المخطط وبيانات اعتماد حساب Google [e-mail].

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

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

إذا أردت إرسال بيانات إلى حساب على "إعلانات 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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

في ما يلي مثال على سيناريو وصول إداري إلى حساب عميل (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"
    }
  ]
}

في ما يلي مثال آخر على سيناريو وصول المدير إلى حساب العميل C2 على "إعلانات Google" وبيانات اعتماد حساب 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"
    }
  ]
}

مساحة العرض والفيديو 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	معرّف شريحة الجمهور.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

وبالمثل، إذا أردت إرسال بيانات إلى حساب شريك في "مساحة العرض والفيديو 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	معرّف شريحة الجمهور.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

سيناريو وصول الشريك إلى "مساحة العرض والفيديو 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	معرّف شريحة الجمهور.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إحصاءات Google

ملاحظة: يجب أن يكون operating_account وlogin_account متطابقَين عندما تكون الوجهة حسابًا على "إحصاءات Google". وإلا يتعذّر الطلب مع ظهور الخطأ 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	معرّف القياس لمصدر البيانات

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

في ما يلي مثال على سيناريو رابط مباشر للمنتج باستخدام حسابات من المخطط. في هذا السيناريو، يرسل شريك البيانات 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"
    }
  ]
}

سيناريو ربط المنتج بالحساب الإداري

إذا كنت تريد إرسال بيانات إلى حساب على "إعلانات 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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

في ما يلي مثال على سيناريو ربط منتج بحساب إداري باستخدام حسابات من المخطّط. في هذا السيناريو، يرسل شريك البيانات 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"
    }
  ]
}

مساحة العرض والفيديو 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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

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

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

إذا كنت تريد إرسال بيانات إلى حساب شريك على "مساحة العرض والفيديو 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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

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

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

سيناريو ربط منتج شريك في "مساحة العرض والفيديو 360"

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 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	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

في ما يلي مثال على 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"
    }
  ]
}

إحصاءات Google

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

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

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

حقول الحساب

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

operating_account

operating_account مطلوب.

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

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

login_account

لا تكون السمة login_account مطلوبة دائمًا، ويتم ضبط القيمة التلقائية على operating_account.

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

1. يجب أن يكون حساب Google الذي يتم إدخال بيانات الاعتماد الخاصة به مستخدمًا في login_account.

2. يجب أن يكون login_account أحد القيم التالية:

   • يجب أن يكون مطابقًا لـ operating_account. هذا هو الإعداد التلقائي إذا لم تضبط login_account.

   • حساب إداري على "إعلانات Google" أو حساب شريك على "مساحة العرض والفيديو 360" يكون حسابًا رئيسيًا لحساب operating_account

   • حساب شريك بيانات يتضمّن رابطًا لمنتج في linked_account

linked_account

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

يشير الرمز linked_account إلى الحساب الذي يتضمّن رابطًا إلى المنتج login_account.

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

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

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

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

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

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

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

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

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

   SELECT
     user_list.id,
     user_list.name
   FROM user_list
   WHERE user_list.name = 'USER_LIST_NAME'
   

2. احصل على رقم تعريف الجمهور من الحقل id في user_list في الردّ.

   [
     {
       "results": [
         {
           "userList": {
             "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
             "id": "USER_LIST_ID",
             "name": "USER_LIST_NAME"
           }
         }
       ]
     }
   ]
   

حدث "إعلانات 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"، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

"إعلانات 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 الذي تستخدمه في بيانات الاعتماد لديه دور المحرِّر أو المشرف في الموقع.