Hedefleri ve üstbilgileri yapılandırma

Data Manager API ile çalışırken hem Destination kavramı hem de istek başlıkları sık sık kullanılır. Farklı senaryolar için hedefleri ve üstbilgileri nasıl yapılandıracağınızı öğrenmek istiyorsanız bu kılavuzu okuyun.

Hedefler veya başlıklar ne zaman kullanılır?

  • Besleme isteklerinde Destination kullanın. Bir besleme isteği, bir kitleye üye eklemek veya kitleden üye kaldırmak ya da etkinlik göndermek için IngestionService kullanır. IngestAudienceMembersRequest veya IngestEventsRequest içindeki destinations listesi şunları tanımlar:

    1. Verileri alan hesap. Örneğin, bir Google Ads hesabı veya Google Analytics mülkü.
    2. Hesaptaki verilerin hedef varlığı (ör. Google Ads dönüşüm işlemi veya Google Analytics akışı).
    3. İsteğin kimlik bilgilerinin, verileri alan hesaba erişim yolu.

    Aynı besleme isteğine birden fazla hedef ekleyebilirsiniz.

  • Kaynakları oluşturan, güncelleyen, silen veya alan kaynak yönetimi isteklerinde istek başlıklarını kullanın. Üstbilgiler, isteğin kimlik bilgilerinin kaynak yönetimi isteğinin hedef hesabına erişim yolunu tanımlar. İstek başlıklarını destekleyen kaynak yönetimi yöntemlerine sahip kaynakların listesi aşağıda verilmiştir:

Örneğin, bir kitle oluşturmak, kitleye üye eklemek, teşhisleri kontrol etmek ve ardından boyutunu kontrol etmek için kitleyi almak istiyorsanız her adım, kullanılacak istek türü ve hedefleri mi yoksa istek başlıklarını mı kullanmanız gerektiği aşağıda açıklanmıştır:

Adım İstek türü Hedef veya istek başlıkları
Kitle oluşturma Kaynak yönetimi İstek başlıkları
Kitleye üye ekleme Besleme Hedefler
Teşhisleri kontrol et Besleme Hedefler
Kitleyi alma Kaynak yönetimi İstek başlıkları

Her tablonun etrafındaki Yükleme veya Kaynak yönetimi sekmesini tıklayarak bu kılavuzda her istek türüyle ilgili ayrıntılar arasında geçiş yapın.

Reklamveren veya ajanssanız üstbilgileri ayarlama ve Destination oluşturma örnekleri için Reklamveren senaryoları bölümüne gidin:

Veri iş ortağıysanız başlıkları ayarlama ve kaynakları yönetmek için Destination oluşturma ve veri iş ortağı hesabınıza iş ortağı bağlantısı olan bir hesaba veri gönderme örnekleri için Veri iş ortağı senaryoları bölümüne gidin:

Ayrıntılı şartlar bölümünde şartlar ve doğrulama kuralları ayrıntılı olarak ele alınmaktadır.

Reklamveren senaryoları

Reklamverenler ve ajanslar için yaygın senaryolarda Destination veya istek başlıklarını nasıl yapılandıracağınız aşağıda açıklanmıştır. Bu şemada, Data Manager API'nin reklamveren hesabına erişmek için kimlik bilgilerini ve Destination alanlarını nasıl kullandığı gösterilmektedir.

Reklamveren erişim yolu

Google Ads

Aşağıdaki şemada bir dizi Google Ads hesabı ve kullanıcı örneği gösterilmektedir.

Google Ads hesapları ve kullanıcıları

Yönetici hesabı M1

M1'in iki doğrudan alt hesabı vardır:

  1. Yönetici hesabı Y2
  2. Müşteri hesabı C1

cloudysanfrancisco@gmail.com Google Hesabı, M1'de bir kullanıcıdır.

Yönetici hesabı Y2

Y2'nin doğrudan iki alt hesabı vardır:

  1. Müşteri hesabı C1
  2. Müşteri hesabı C2

baklavainthebalkans@gmail.com Google Hesabı, Y2'de bir kullanıcıdır.

Müşteri hesabı C1

C1'in iki doğrudan üst yönetici hesabı vardır:

  1. Yönetici hesabı M1
  2. Yönetici hesabı Y2

jeffersonloveshiking@gmail.com Google Hesabı, M1'de bir kullanıcıdır.

Müşteri hesabı C2

Y2 yönetici hesabı, M2'nin tek doğrudan üst hesabıdır.

Listelenen Google Hesaplarından hiçbiri C2'de kullanıcı değil.

Doğrudan erişim senaryosu ve Yönetici erişimi senaryosu, bu hesaplara veri göndermek için bir hedefi nasıl yapılandıracağınızı gösterir.

Doğrudan erişim senaryosu

Bir Google Ads hesabına veri göndermek istiyorsanız ve kimlik bilgileriniz Google Ads hesabında kullanıcı olan bir Google Hesabı'na aitse:

Besleme
Hedef
operating_account
account_id Google Ads hesabının müşteri kimliği
account_type GOOGLE_ADS
login_account login_account değerini ayarlamayın veya operating_account ile aynı değerlere ayarlayın.
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Diyagramdaki hesapları ve jeffersonloveshiking@gmail.com Google Hesabı'nın kimlik bilgilerini kullanan doğrudan erişim senaryosuna bir örnek:

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

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Yönetici erişimi senaryosu

Bir Google Ads hesabına veri göndermek istiyorsanız ve kimlik bilgileriniz, reklamveren hesabının alt hesap olduğu bir Google Ads yönetici hesabında kullanıcı olan bir Google Hesabı'na aitse:

Besleme
Hedef
operating_account
account_id Google Ads müşteri hesabının müşteri kimliği
account_type GOOGLE_ADS
login_account
account_id Google Ads yönetici hesabının müşteri kimliği
account_type GOOGLE_ADS
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Aşağıda, diyagramdaki Google Ads müşteri hesabı C2 için yönetici erişimi senaryosu ve Google Hesabı baklavainthebalkans@gmail.com için kimlik bilgileri örneği verilmiştir:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Google Ads müşteri hesabı C2 için yönetici erişimi senaryosuna ve Google Ads yönetici hesabı M1'de kullanıcı olan Google Hesabı cloudysanfrancisco@gmail.com için kimlik bilgilerine dair başka bir örnek:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Display & Video 360

Display & Video 360'a iki yöntemle veri gönderebilirsiniz:

  1. Kimlik bilgilerinin Display & Video 360 reklamveren veya iş ortağı hesabındaki bir kullanıcı olan Google Hesabı'na ait olduğu doğrudan erişim.
  2. Kimlik bilgilerinin Display & Video 360 iş ortağı hesabındaki bir kullanıcı olan Google Hesabı'na ait olduğu ve çalışan hesabın iş ortağı hesabının altındaki bir Display & Video 360 reklamveren hesabı olduğu Display & Video 360 iş ortağı erişimi.

Doğrudan erişim senaryoları

Verileri bir Display & Video 360 reklamveren hesabına göndermek istiyorsanız ve kimlik bilgileriniz reklamveren hesabındaki bir kullanıcıya ait Google Hesabı içinse:

Besleme
Hedef
operating_account
account_id Display & Video 360 reklamveren hesabının kimliği
account_type DISPLAY_VIDEO_ADVERTISER
login_account login_account değerini ayarlamayın veya operating_account ile aynı değerlere ayarlayın.
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Display & Video 360 reklamverenine veri göndermek için doğrudan erişim senaryosuna yönelik bir Destination örneğini aşağıda bulabilirsiniz:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Benzer şekilde, bir Display & Video 360 iş ortağı hesabına veri göndermek istiyorsanız ve kimlik bilgileriniz iş ortağı hesabındaki bir kullanıcı olan Google Hesabı'na aitse:

Besleme
Hedef
operating_account
account_id Display & Video 360 iş ortağı hesabının kimliği
account_type DISPLAY_VIDEO_PARTNER
login_account login_account değerini ayarlamayın veya operating_account ile aynı değerlere ayarlayın.
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Display & Video 360 iş ortağına veri göndermek için doğrudan erişim senaryosuna yönelik bir Destination örneği:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Display & Video 360 iş ortağı erişim senaryosu

Display & Video 360 reklamverenine veri göndermek istiyorsanız ve kimlik bilgileriniz reklamverenin üst Display & Video 360 iş ortağı hesabındaki bir kullanıcıya ait Google Hesabı içinse:

Besleme
Hedef
operating_account
account_id Display & Video 360 reklamveren hesabının kimliği
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Display & Video 360 iş ortağı hesabının kimliği
account_type DISPLAY_VIDEO_PARTNER
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Aşağıda, Display & Video 360 reklamverenine veri göndermek için iş ortağı erişimi senaryosuna yönelik bir Destination örneği verilmiştir. Bu senaryoda kimlik bilgileri, Display & Video 360 iş ortağı hesabı DISPLAY_VIDEO_PARTNER_ID'ta kullanıcı olan bir Google Hesabı'na ait olmalıdır ve Display & Video 360 reklamveren hesabı DISPLAY_VIDEO_ADVERTISER_ID, iş ortağı hesabı DISPLAY_VIDEO_PARTNER_ID'un alt hesabı olmalıdır.

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Google Analytics

Not: operating_account bir Google Analytics hesabıysa login_account değerini ayarlamayın veya operating_account ile aynı değerlere ayarlayın. Aksi takdirde istek, OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH hatasıyla başarısız olur.

Besleme
Hedef
operating_account
account_id Google Analytics mülkünün kimliği
account_type GOOGLE_ANALYTICS_PROPERTY
login_account login_account değerini ayarlamayın veya operating_account ile aynı değerlere ayarlayın.
linked_account linked_account alanını ayarlamayın.
product_destination_id
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account linked-account üstbilgisini ayarlamayın.

Google Analytics'e etkinlik göndermek için kullanılan Destination örneğini aşağıda bulabilirsiniz:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account linked-account üstbilgisini ayarlamayın.

Floodlight

Besleme
Hedef
operating_account
account_id Floodlight yapılandırma kimliği
Reklamvereniniz bir üst reklamverenin alt reklamvereni ise Campaign Manager 360'ta üst reklamverenin kimliğini Floodlight yapılandırma kimliğiniz olarak kullanın. Aksi takdirde reklamvereninizin kimliğini kullanın. Campaign Manager 360 kullanıcı arayüzünde reklamveren kimliğini nasıl bulacağınızı öğrenin.
account_type FLOODLIGHT_CONFIG
login_account login_account değerini ayarlamayın veya operating_account ile aynı değerlere ayarlayın.
linked_account linked_account alanını ayarlamayın.
product_destination_id Floodlight etkinlik kimliği

Floodlight'a etkinlik göndermek için kullanılan Destination örneği:

Besleme
        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }
      

Veri iş ortağı senaryoları

Veri iş ortağı hesabına iş ortağı bağlantısı oluşturulmuş reklamveren hesaplarına veri gönderen bir veri iş ortağı için yaygın senaryolarda Destination yapılandırmayı burada bulabilirsiniz.

Bu şemada, Veri Yöneticisi API'sinin bir iş ortağı bağlantısı üzerinden reklamveren hesabına erişmek için kimlik bilgilerini ve Destination alanlarını nasıl kullandığı gösterilmektedir.

Veri iş ortağı erişim yolu

Google Ads

Aşağıdaki şemada, bir Google Ads ve veri iş ortağı hesabı grubu örneği gösterilmektedir. Diyagramda ayrıca, her bir Google Ads veya veri iş ortağı hesabında hangi Google Hesabı'nın kullanıcı olduğu ve hesaplar arasındaki iş ortağı bağlantıları gösterilir.

Veri iş ortağı ve Google Ads hesapları ile kullanıcıları

Veri iş ortağı D1

D1 ile Google Ads yönetici hesabı M2 arasında bir iş ortağı bağlantısı vardır.

222larabrown@gmail.com Google Hesabı, D1'de bir kullanıcıdır.

Veri iş ortağı D2

D2 ile Google Ads müşteri hesabı C1 arasında bir iş ortağı bağlantısı vardır.

jeffersonloveshiking@gmail.com Google Hesabı, D2'de bir kullanıcıdır.

Yönetici hesabı M1

M1'in iki doğrudan alt hesabı vardır:

  1. Yönetici hesabı Y2
  2. Müşteri hesabı C1
Yönetici hesabı Y2

Y2'nin doğrudan iki alt hesabı vardır:

  1. Müşteri hesabı C1
  2. Müşteri hesabı C2
Müşteri hesabı C1

C1'in iki doğrudan üst yönetici hesabı vardır:

  1. Yönetici hesabı M1
  2. Yönetici hesabı Y2
Müşteri hesabı C2

Y2 yönetici hesabı, M2'nin tek doğrudan üst hesabıdır.

Bu hesap grubuyla yapabilecekleriniz:

Veri iş ortağı D1 olarak hareket etme

D1 veri iş ortağı olarak hareket etmek için 222larabrown@gmail.com Google Hesabı'nın kimlik bilgilerini kullanarak şunları yapın:

  • login_account, veri iş ortağı hesabı D1'e ve linked_account, yönetici hesabı M2'ye ayarlanmış bir hedef kullanarak müşteri hesabı C1'e veya müşteri hesabı C2'ye veri gönderin.

  • login_account, veri iş ortağı hesabı D1 olarak ayarlanmış bir hedef kullanarak verileri doğrudan yönetici hesabı M2'ye gönderin. Ayarlama linked_account.

D1 ve M1 arasında iş ortağı bağlantısı olmadığından, D1 veri iş ortağı olarak M1 yönetici hesabına veri gönderemezsiniz.

Veri iş ortağı D2 olarak hareket etme

D2 veri iş ortağı olarak hareket etmek için Google Hesabı kimlik bilgilerini kullanarak jeffersonloveshiking@gmail.com, login_account değeri D2 veri iş ortağı hesabı olarak ayarlanmış bir hedefi kullanarak C1 müşteri hesabına veri gönderin. Ayarlama linked_account.

D2 veri iş ortağı olarak, M1 yönetici hesabına, M2 yönetici hesabına veya C2 müşteri hesabına veri gönderemezsiniz. Bunun nedeni, D2 ile bu hesaplardan herhangi biri veya bunların üst yönetici hesapları arasında iş ortağı bağlantısı olmamasıdır.

D1 ve D2 veri iş ortakları arasındaki temel fark, veri iş ortağının Google Ads hesaplarına nasıl bağlandığıdır.

Doğrudan iş ortağı bağlantısı senaryosu

Bir Google Ads hesabına veri göndermek istiyorsanız ve iş ortağı bağlantısı, Google Ads hesabı ile veri iş ortağı hesabınız arasındaysa:

Besleme
Hedef
operating_account
account_id Google Ads hesabının müşteri kimliği
account_type GOOGLE_ADS
login_account
account_id Veri iş ortağı hesabının müşteri kimliği
account_type DATA_PARTNER
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Diyagramdaki hesapları kullanan doğrudan iş ortağı bağlantısı senaryosuna ve kaynak yönetimi istekleri için ilgili istek başlıklarına dair bir örneği aşağıda bulabilirsiniz. Bu senaryoda, veri iş ortağı D2, D2 ile C1 arasındaki iş ortağı bağlantısını ve jeffersonloveshiking@gmail.com Google Hesabı'nın kimlik bilgilerini kullanarak kitle üyesi verilerini Google Ads müşteri-ajansı C1'e gönderir:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Yönetici iş ortağı bağlantı senaryosu

Bir Google Ads hesabına veri göndermek istiyorsanız ve iş ortağı bağlantısı, üst Google Ads yönetici hesabı ile veri iş ortağı hesabınız arasındaysa:

Besleme
Hedef
operating_account
account_id Google Ads müşteri hesabının müşteri kimliği
account_type GOOGLE_ADS
login_account
account_id Veri iş ortağı hesabının müşteri kimliği
account_type DATA_PARTNER
linked_account
account_id Google Ads yönetici hesabının müşteri kimliği
account_type GOOGLE_ADS
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Diyagramdaki hesapları kullanan bir yönetici iş ortağı bağlantısı senaryosu örneğini aşağıda bulabilirsiniz. Bu senaryoda, veri iş ortağı D1, D1 ve M2 arasındaki iş ortağı bağlantısını ve 222larabrown@gmail.com Google Hesabı'nın kimlik bilgilerini kullanarak kitle üyesi verilerini Google Ads müşteri-ajansı C2'ye gönderir:

Besleme
{
  "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"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

Veri iş ortağı olarak, Display & Video 360 hesabına iki yaklaşımı kullanarak veri gönderebilirsiniz:

  1. Veri iş ortağı hesabı ile Display & Video 360 iş ortağı veya reklamveren hesabı arasında doğrudan iş ortağı bağlantısı kullanın.
  2. Bir veri iş ortağı hesabı ile reklamverenin üst Display & Video 360 iş ortağı hesabı arasında iş ortağı bağlantısı kullanarak Display & Video 360 reklamverenine veri gönderme.

Display & Video 360 reklamverenine veri göndermek istiyorsanız ve iş ortağı bağlantısı, Display & Video 360 reklamveren hesabı ile veri iş ortağı hesabınız arasındaysa:

Besleme
Hedef
operating_account
account_id Display & Video 360 reklamveren hesabının kimliği
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Veri iş ortağı hesabının müşteri kimliği
account_type DATA_PARTNER
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Aşağıda, Display & Video 360 reklamverenine veri göndermek için doğrudan iş ortağı bağlantısı senaryosuna yönelik bir Destination örneği ve kaynak yönetimi istekleri için ilgili istek başlıkları verilmiştir:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Bir Display & Video 360 iş ortağı hesabına veri göndermek istiyorsanız Display & Video 360 iş ortağı hesabı ile veri iş ortağı hesabınız arasında bir iş ortağı bağlantısı olması gerekir.

Besleme
Hedef
operating_account
account_id Display & Video 360 iş ortağı hesabının kimliği
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id Veri iş ortağı hesabının müşteri kimliği
account_type DATA_PARTNER
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Aşağıda, Display & Video 360 iş ortağına veri göndermek için doğrudan iş ortağı bağlantısı senaryosuna yönelik bir Destination örneği ve kaynak yönetimi istekleri için ilgili istek başlıkları verilmiştir:

Besleme
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Bir Display & Video 360 reklamverenine veri göndermek istiyorsanız ve veri iş ortağı hesabınızın iş ortağı bağlantısı, reklamveren hesabının alt hesap olduğu bir Display & Video 360 iş ortağı hesabıyla ise:

Besleme
Hedef
operating_account
account_id Display & Video 360 reklamveren hesabının kimliği
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id Veri iş ortağı hesabının müşteri kimliği
account_type DATA_PARTNER
linked_account
account_id Display & Video 360 iş ortağı hesabının kimliği
account_type DISPLAY_VIDEO_PARTNER
product_destination_id Kitlenin veya dönüşüm işleminin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Veri iş ortağı ile reklamverenin üst Display & Video 360 iş ortağı arasındaki iş ortağı bağlantısını kullanarak Display & Video 360 reklamverenine veri göndermek için iş ortağı bağlantısı senaryosuna yönelik bir Destination örneği aşağıda verilmiştir:

Besleme
{
  "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"
    }
  ]
}
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

Bir Google Ad Manager hesabına veri göndermek istiyorsanız ve veri iş ortağı hesabınız ile Google Ad Manager hesabı arasında bir iş ortağı bağlantınız varsa:

Besleme
Hedef
operating_account
account_id Google Ad Manager hesabının kitle bağlantı kimliği
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account
account_id Veri iş ortağı hesabının müşteri kimliği
account_type DATA_PARTNER
linked_account linked_account alanını ayarlamayın.
product_destination_id Kitlenin kimliği.
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

İş ortağı bağlantısı kullanarak bir Google Ad Manager hesabına veri göndermek için kullanılan Destination örneğini aşağıda bulabilirsiniz:

Besleme
      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
      
Kaynak yönetimi
İstek başlıkları
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account linked-account üstbilgisini ayarlamayın.

Google Analytics

Data Manager API, iş ortağı bağlantısı kullanarak Google Analytics hesabına veri göndermeyi desteklemez. Bunun yerine Google Analytics için reklamveren senaryoları yaklaşımını kullanın.

Floodlight

Data Manager API, iş ortağı bağlantısı kullanarak Floodlight yapılandırmasına veri göndermeyi desteklemez. Bunun yerine Floodlight için reklamveren senaryoları yaklaşımını kullanın.

Ayrıntılı koşullar

Bu bölümde, bir IngestionService isteği için Destination'nin hesap alanları ile ilgili ayrıntılı koşullar, kaynak yönetimi istekleri için eşdeğer istek başlıkları, product_destination_id ayarlarının nasıl yapılacağına dair ipuçları ve kimlik bilgilerinizin erişiminin olduğu yerlerin nasıl belirleneceği açıklanmaktadır.

Hesap alanları

Bir Destination en fazla 3 farklı hesaba sahip olabilir:

operating_account

operating_account zorunludur.

operating_account, istekteki verileri hangi hesabın alacağını belirtir. operating_account aşağıdakilerden herhangi biri olabilir:

Destination alanının operating_account alanına karşılık gelen bir istek başlığı yoktur. Kaynak yönetimi isteği gönderilirken isteğin hedef hesabı, işlem hesabıdır.

login_account alanı ve login-account istek başlığı

login_account her zaman gerekli değildir ve varsayılan olarak IngestionService isteğinde operating_account, kaynak yönetimi isteğinde ise hedef hesaptır. Kaynak yönetimi isteğinde, giriş hesabını tanımlamak için login-account istek başlığını kullanın.

Data Manager API şunları doğrular:

  1. Kimlik bilgilerinin Google Hesabı, giriş hesabındaki bir kullanıcıdır.

  2. Giriş hesabı aşağıdakilerden biridir:

linked_account alanı ve linked-account istek başlığı

linked_account, hangi hesabın bir IngestionService isteğinin login_account ile iş ortağı bağlantısı olduğunu veya bir kaynak yönetimi isteğinin hedef hesabını gösterir.

Ürün hedef kimliği

Destination için product_destination_id, operating_account içindeki hangi nesnenin verileri alacağını tanımlar. Örneğin, Google Ads veya Display & Video 360 için bir kitle kimliği, Google Ads için bir dönüşüm işlemi kimliği veya Google Analytics veri akışı için bir ölçüm kimliği olabilir.

Her bir ürün hedefi türünün kimliğini nasıl bulacağınız aşağıda açıklanmıştır.

Google Ads kitlesi

Kitle üyelerini beslemek için ürün hedef kimliği, kitle kimliğidir. Bu kimliği Google Ads kullanıcı arayüzünü veya Data Manager API'yi kullanarak alın.

Kitle kimliğini Google Ads kullanıcı arayüzünden almak için:

  1. Google Ads kullanıcı arayüzünde Kitle Yöneticisi'ne gidin.
  2. Ayrıntıları görüntülemek için kitle adını tıklayın.
  3. Kitle kimliği, Liste kimliği'nin yanında listelenir.

Data Manager API

List yöntemini kullanarak UserList değerini alın, gerekirse istek başlıklarını sağlayın ve ürün hedef kimliği için UserList değerinin id değerini kullanın.

Google Ads etkinliği

Etkinlikleri beslemek için ürün hedef kimliği, dönüşüm işlemi kimliğidir. Bu kimliği Google Ads kullanıcı arayüzünü veya Google Ads API'yi kullanarak alabilirsiniz.

Dönüşüm işlemi kimliğini Google Ads kullanıcı arayüzünden almak için:

  1. Google Ads kullanıcı arayüzünde Dönüşümler'e gidin.
  2. Dönüşüm işleminin adını tıklayın.
  3. Ayrıntılar sekmesine gidin.
  4. Dönüşüm işlemi kimliği, Dönüşüm türü kimliği'nin yanındaki sayıdır.

Dönüşüm işlemi kimliğini Google Ads API'den almak için:

  1. Aşağıdaki sorguyla GoogleAdsService adresine bir Search veya SearchStream isteği gönderin:

      SELECT
        conversion_action.id,
        conversion_action.name
      FROM conversion_action
      WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
    
  2. Yanıttaki conversion_action içinde bulunan id alanından dönüşüm işlemi kimliğini alın.

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

Display & Video 360 kitlesi

Kitle üyelerini beslemek için ürün hedef kimliği, kitle kimliğidir. Bu kimliği Display & Video 360 kullanıcı arayüzünü veya Data Manager API'yi kullanarak alın.

Display & Video 360 kullanıcı arayüzü

Kitle kimliğini Display & Video 360 kullanıcı arayüzünden almak için:

  1. https://displayvideo.google.com adresinden Display & Video 360 kullanıcı arayüzünde oturum açın.
  2. operating_account için kullandığınız Display & Video 360 iş ortağına veya reklamverenine gidin.
  3. Soldaki menüden Kitleler'e gidip Tüm kitleler'i seçin.
  4. Listede kitleyi bulun. Kitle kimliği, Ad sütunundaki adın yanındaki sayıdır.

Data Manager API

List yöntemini kullanarak UserList değerini alın, gerekirse istek başlıklarını sağlayın ve ürün hedef kimliği için UserList değerinin id değerini kullanın.

Google Analytics etkinliği

Ürün hedef kimliği, veri akışının türüne bağlıdır.

Web veri akışı
Veri akışının ölçüm kimliğini kullanın.
Uygulama veri akışı

Veri akışının Firebase Uygulama Kimliği'ni kullanın. Firebase Uygulama Kimliğinizi bulmak için iki seçenek vardır:

Floodlight etkinliği

Etkinlikleri Floodlight'a aktarmak için kullanılan ürün hedef kimliği, Floodlight etkinlik kimliğidir. Bu kimliği Campaign Manager 360 kullanıcı arayüzünü veya Campaign Manager 360 API'yi kullanarak alabilirsiniz.

Campaign Manager 360 kullanıcı arayüzü

Floodlight etkinlik kimliğini Campaign Manager 360 kullanıcı arayüzünden almak için:

  1. Campaign Manager 360 kullanıcı arayüzünde oturum açın.
  2. operating_account için kullandığınız Campaign Manager 360 reklamverenine gidin.
  3. Sol menüde Floodlight'a gidip Etkinlikler'i seçin.
  4. Listede Floodlight etkinliğini bulun. Kimlik, Etkinlik adı sütununda adın yanındaki sayıdır.

Campaign Manager 360 API

Floodlight etkinlik kimliğini Campaign Manager 360 API'sinden almak için:

  1. floodlightActivities kaynağına bir list isteği gönderin.
  2. Floodlight yapılandırmasının floodlightConfigurationId değerini belirtin.
  3. İsteğe bağlı olarak, etkinlik adına göre filtrelemek için searchString parametresini kullanın.
  4. Yanıttaki seçili FloodlightActivity öğesinin id alanından Floodlight etkinlik kimliğini alın.

Kimlik bilgilerinin erişebileceği yerleri belirleme

Veri Yöneticisi API isteğini yetkilendirmek için kullandığınız kimlik bilgileri belirli bir Google Hesabı ile ilişkilendirilir.

  • Kullanıcı kimlik bilgilerini kullanırsanız istekler, kimlik bilgilerini oluşturduğunuzda kendi adına işlem yapma izni veren kullanıcının Google Hesabı olarak yetkilendirilir.
  • Hizmet hesabı kimlik bilgilerini kullanırsanız istekler, hizmet hesabının Google Hesabı olarak yetkilendirilir.

Kimlik bilgileriniz için Google Hesabı'nın bir Google Ads, Display & Video 360, Google Analytics veya Campaign Manager 360 hesabına erişimi olduğunu nasıl doğrulayacağınız aşağıda açıklanmıştır.

Google Ads veya veri iş ortağı

  1. login_account için Google Ads kullanıcı arayüzünde Erişim ve güvenlik'e gidin.
  2. Kullanıcılar sekmesini seçin.
  3. login_account bir Google Ads yönetici hesabıysa alt hesaplardaki kullanıcıları gizlemek için Hiyerarşinin tamamındaki kullanıcıları göster düğmesini kapatın.
  4. Kimlik bilgileriniz için Google Hesabı'nın, Kullanıcılar sekmesinde gösterilen hesaplar listesinde olduğunu doğrulayın.

Display & Video 360

  1. Display & Video 360 kullanıcı arayüzünde Kullanıcı yönetimi ve e-posta tercihleri'ne gidin.
  2. Kullanıcı yönetimi bölümünde, kimlik bilgileriniz için Google Hesabı'nın login_account üzerinde bir kullanıcı olarak gösterildiğini doğrulayın.

Google Analytics

  1. Google Analytics kullanıcı arayüzünde Mülk erişim yönetimi'ne gidin.
  2. login_account içinde belirtilen Google Analytics mülkünün seçildiğini onaylayın.
  3. Kimlik bilgileriniz için kullanılan Google Hesabı'nın mülkte Düzenleyici veya Yönetici rolüne sahip olduğunu doğrulayın.

Floodlight (Campaign Manager 360)

  1. Campaign Manager 360 kullanıcı arayüzünde oturum açın.
  2. Sol menüde Yönetici > Kullanıcı profilleri'ne gidin.
  3. Kimlik bilgileriniz için Google Hesabı'nın, gösterilen profiller listesinde yer aldığını doğrulayın.
  4. Profili tıklayın ve login_account olarak kullanılan reklamveren hesabına erişimi olduğunu doğrulayın. İstekte login_account ayarlamazsanız varsayılan olarak operating_account kullanılır. Hesabın, Çevrimdışı dönüşümleri ekleme iznine sahip bir kullanıcı rolü olduğundan emin olun.