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
Destinationkullanın. Bir besleme isteği, bir kitleye üye eklemek veya kitleden üye kaldırmak ya da etkinlik göndermek içinIngestionServicekullanır.IngestAudienceMembersRequestveyaIngestEventsRequestiçindekidestinationslistesi şunları tanımlar:- Verileri alan hesap. Örneğin, bir Google Ads hesabı veya Google Analytics mülkü.
- Hesaptaki verilerin hedef varlığı (ör. Google Ads dönüşüm işlemi veya Google Analytics akışı).
- İ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.
Google Ads
Aşağıdaki şemada bir dizi Google Ads hesabı ve kullanıcı örneği gösterilmektedir.
- Yönetici hesabı M1
M1'in iki doğrudan alt hesabı vardır:
- Yönetici hesabı Y2
- Müşteri hesabı C1
cloudysanfrancisco@gmail.comGoogle Hesabı, M1'de bir kullanıcıdır.- Yönetici hesabı Y2
Y2'nin doğrudan iki alt hesabı vardır:
- Müşteri hesabı C1
- Müşteri hesabı C2
baklavainthebalkans@gmail.comGoogle Hesabı, Y2'de bir kullanıcıdır.- Müşteri hesabı C1
C1'in iki doğrudan üst yönetici hesabı vardır:
- Yönetici hesabı M1
- Yönetici hesabı Y2
jeffersonloveshiking@gmail.comGoogle 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 |
|
||||
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 |
|
||||
login_account |
|
||||
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:
- 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.
- 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 |
|
||||
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 |
|
||||
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 |
|
||||
login_account |
|
||||
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 |
|
||||
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 |
|
||||
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.
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ğı D1
D1 ile Google Ads yönetici hesabı M2 arasında bir iş ortağı bağlantısı vardır.
222larabrown@gmail.comGoogle 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.comGoogle Hesabı, D2'de bir kullanıcıdır.- Yönetici hesabı M1
M1'in iki doğrudan alt hesabı vardır:
- Yönetici hesabı Y2
- Müşteri hesabı C1
- Yönetici hesabı Y2
Y2'nin doğrudan iki alt hesabı vardır:
- Müşteri hesabı C1
- Müşteri hesabı C2
- Müşteri hesabı C1
C1'in iki doğrudan üst yönetici hesabı vardır:
- Yönetici hesabı M1
- 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.comGoogle Hesabı'nın kimlik bilgilerini kullanarak şunları yapın:login_account, veri iş ortağı hesabı D1'e velinked_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. Ayarlamalinked_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_accountdeğeri D2 veri iş ortağı hesabı olarak ayarlanmış bir hedefi kullanarak C1 müşteri hesabına veri gönderin. Ayarlamalinked_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.
- D1 veri iş ortağı, bir Google Ads yönetici hesabına bağlıdır. Bu, yönetici iş ortağı bağlantısı senaryosuna bir örnektir.
- D2 veri iş ortağı, bir Google Ads müşteri hesabına bağlıdır. Bu, doğrudan iş ortağı bağlantısı senaryosuna bir örnektir.
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 |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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:
- Veri iş ortağı hesabı ile Display & Video 360 iş ortağı veya reklamveren hesabı arasında doğrudan iş ortağı bağlantısı kullanın.
- 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.
Doğrudan iş ortağı bağlantısı senaryoları
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 |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
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. |
Ebeveyn iş ortağı bağlantı senaryosu
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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 |
|
||||
login_account |
|
||||
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_accountoperating_accountzorunludur.operating_account, istekteki verileri hangi hesabın alacağını belirtir.operating_accountaşağıdakilerden herhangi biri olabilir:- Google Ads hesabı
- Display & Video 360 reklamveren hesabı
- Display & Video 360 iş ortağı hesabı
- Google Ad Manager hesabı
- Google Analytics mülkü
- Veri iş ortağı hesabına ait bir kitleye veri gönderiliyorsa veri iş ortağı hesabı.
Destinationalanınınoperating_accountalanı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_accountalanı velogin-accountistek başlığılogin_accounther zaman gerekli değildir ve varsayılan olarakIngestionServiceisteğindeoperating_account, kaynak yönetimi isteğinde ise hedef hesaptır. Kaynak yönetimi isteğinde, giriş hesabını tanımlamak içinlogin-accountistek başlığını kullanın.Data Manager API şunları doğrular:
Kimlik bilgilerinin Google Hesabı, giriş hesabındaki bir kullanıcıdır.
Giriş hesabı aşağıdakilerden biridir:
operating_accountile aynı. BirIngestionServiceisteğindeDestinationiçinlogin_accountdeğerini ayarlamazsanız veya kaynak yönetimi isteğindelogin-accountbaşlığını ayarlamazsanız varsayılan olarak bu değer kullanılır.IngestionServiceisteğindeoperating_accountöğesinin üst öğesi olan bir Google Ads yöneticisi veya Display & Video 360 iş ortağı hesabı ya da kaynak yönetimi isteğinde hedef hesabın üst öğesi.Bir
IngestionServiceisteğindelinked_accountiçin iş ortağı bağlantısı olan bir veri iş ortağı hesabı veya bir kaynak yönetimi isteğindelinked-accountüstbilgisi.
linked_accountalanı velinked-accountistek başlığı-
linked_account, hangi hesabın birIngestionServiceisteğininlogin_accountile 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.
Google Ads kullanıcı arayüzü
Kitle kimliğini Google Ads kullanıcı arayüzünden almak için:
- Google Ads kullanıcı arayüzünde Kitle Yöneticisi'ne gidin.
- Ayrıntıları görüntülemek için kitle adını tıklayın.
- 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.
Google Ads kullanıcı arayüzü
Dönüşüm işlemi kimliğini Google Ads kullanıcı arayüzünden almak için:
- Google Ads kullanıcı arayüzünde Dönüşümler'e gidin.
- Dönüşüm işleminin adını tıklayın.
- Ayrıntılar sekmesine gidin.
- Dönüşüm işlemi kimliği, Dönüşüm türü kimliği'nin yanındaki sayıdır.
Google Ads API
Dönüşüm işlemi kimliğini Google Ads API'den almak için:
Aşağıdaki sorguyla
GoogleAdsServiceadresine birSearchveyaSearchStreamisteği gönderin:SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'Yanıttaki
conversion_actioniçinde bulunanidalanı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:
- https://displayvideo.google.com adresinden Display & Video 360 kullanıcı arayüzünde oturum açın.
operating_accountiçin kullandığınız Display & Video 360 iş ortağına veya reklamverenine gidin.- Soldaki menüden Kitleler'e gidip Tüm kitleler'i seçin.
- 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:
- Google Analytics kullanıcı arayüzünde Veri akışları'na gidin, veri akışını tıklayın ve FIREBASE UYGULAMA KİMLİĞİ'ni bulun.
- Firebase konsolunu kullanın.
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:
- Campaign Manager 360 kullanıcı arayüzünde oturum açın.
operating_accountiçin kullandığınız Campaign Manager 360 reklamverenine gidin.- Sol menüde Floodlight'a gidip Etkinlikler'i seçin.
- 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:
floodlightActivitieskaynağına birlististeği gönderin.- Floodlight yapılandırmasının
floodlightConfigurationIddeğerini belirtin. - İsteğe bağlı olarak, etkinlik adına göre filtrelemek için
searchStringparametresini kullanın. - Yanıttaki seçili
FloodlightActivityöğesininidalanı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ğı
login_accountiçin Google Ads kullanıcı arayüzünde Erişim ve güvenlik'e gidin.- Kullanıcılar sekmesini seçin.
login_accountbir 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.- Kimlik bilgileriniz için Google Hesabı'nın, Kullanıcılar sekmesinde gösterilen hesaplar listesinde olduğunu doğrulayın.
Display & Video 360
- Display & Video 360 kullanıcı arayüzünde Kullanıcı yönetimi ve e-posta tercihleri'ne gidin.
- 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
- Google Analytics kullanıcı arayüzünde Mülk erişim yönetimi'ne gidin.
login_accountiçinde belirtilen Google Analytics mülkünün seçildiğini onaylayın.- 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)
- Campaign Manager 360 kullanıcı arayüzünde oturum açın.
- Sol menüde Yönetici > Kullanıcı profilleri'ne gidin.
- Kimlik bilgileriniz için Google Hesabı'nın, gösterilen profiller listesinde yer aldığını doğrulayın.
- Profili tıklayın ve
login_accountolarak kullanılan reklamveren hesabına erişimi olduğunu doğrulayın. İstektelogin_accountayarlamazsanız varsayılan olarakoperating_accountkullanılır. Hesabın, Çevrimdışı dönüşümleri ekleme iznine sahip bir kullanıcı rolü olduğundan emin olun.